New to Telerik UI for Blazor? Start a free 30-day trial

ChartValueAxis

Class

Defines and configures a value axis for displaying numeric data scales in charts. Controls how numeric values are presented along the Y-axis with formatting, ranges, and visual styling. Essential for charts that display quantitative data requiring proper scaling and measurement indication. Supports multiple value axes for displaying different data series with distinct scales or units. Children: ChartValueAxisLabels, ChartValueAxisMajorGridLines, ChartValueAxisMinorGridLines, ChartValueAxisMajorTicks, ChartValueAxisMinorTicks, ChartValueAxisTitle, ChartValueAxisPlotBands.

Definition

Namespace:Telerik.Blazor.Components

Assembly:Telerik.Blazor.dll

Syntax:

public class ChartValueAxis : DataVizCollectionItemComponent, IComponent, IHandleEvent, IHandleAfterRender, IDisposable

Inheritance: objectComponentBaseDataVizChildComponentDataVizCollectionItemComponentChartValueAxis

Implements: IComponentIDisposableIHandleAfterRenderIHandleEvent

Inherited Members DataVizChildComponent.Dispose()ComponentBase.OnInitializedAsync()ComponentBase.OnParametersSetAsync()ComponentBase.StateHasChanged()ComponentBase.ShouldRender()ComponentBase.OnAfterRenderAsync(bool)ComponentBase.InvokeAsync(Action)ComponentBase.InvokeAsync(Func<Task>)ComponentBase.DispatchExceptionAsync(Exception)ComponentBase.SetParametersAsync(ParameterView)...

Constructors

ChartValueAxis()

public ChartValueAxis()

Properties

AxisCrossingValue

object[]

Value at which the category axis crosses this axis. (Only for object)Value indices at which the category axes cross the value axis. (Only for array)Date at which the category axis crosses this axis. (Only for date)

[Parameter]
public object[] AxisCrossingValue { get; set; }

Background

string

The background color of the axis.

[Parameter]
public string Background { get; set; }

ChildContent

RenderFragment

The content of the ChartValueAxis component. Children: ChartValueAxisLabels, ChartValueAxisMajorGridLines, ChartValueAxisMinorGridLines, ChartValueAxisMajorTicks, ChartValueAxisMinorTicks, ChartValueAxisTitle, ChartValueAxisPlotBands.

[Parameter]
public RenderFragment ChildContent { get; set; }

Color

string

The color of the value axis. Accepts a valid CSS color string, including hex and rgb.

[Parameter]
public string Color { get; set; }

MajorUnit

double?

The interval between major divisions. If the valueAxis.type is set to "log", the majorUnit value will be used for the base of the logarithm.

[Parameter]
public double? MajorUnit { get; set; }

Max

double?

The maximum value of the axis.

[Parameter]
public double? Max { get; set; }

Min

double?

The minimum value of the axis. Under certain conditions, the narrowRange setting can overwrite this setting. To give priority to the min setting of your choice, set valueAxis.narrowRange to false.

[Parameter]
public double? Min { get; set; }

MinorUnit

double?

The interval between minor divisions. It defaults to 1/5 of the valueAxis.majorUnit. If the valueAxis.type is set to "log", the minorUnit value represents the number of divisions between two major units and defaults to the major unit minus one.

[Parameter]
public double? MinorUnit { get; set; }

Name

string

The unique axis name. Used to associate a series with a value axis using the series.axis option.

[Parameter]
public string Name { get; set; }

NarrowRange

bool?

If set to true the Chart will narrow the value axis range in order to display data points in better detail. Setting it to false will force the automatic axis range to start from 0 or the explicitly specified valueAxis.min value.

[Parameter]
public bool? NarrowRange { get; set; }

Type

ChartValueAxisType?

Specifies the axis type.

[Parameter]
public ChartValueAxisType? Type { get; set; }

Visible

bool?

If set to true the chart will display the value axis. By default the value axis is visible.

[Parameter]
public bool? Visible { get; set; }

ZIndex

double?

An optional Z-index that can be used to change the default stacking position of the valueAxis.

[Parameter]
public double? ZIndex { get; set; }

Methods

BuildRenderTree(RenderTreeBuilder)

protected override void BuildRenderTree(RenderTreeBuilder __builder)

Parameters:__builderRenderTreeBuilder

Overrides: ComponentBase.BuildRenderTree(RenderTreeBuilder)

Dispose(bool)

protected override void Dispose(bool disposing)

Parameters:disposingbool

Overrides: DataVizChildComponent.Dispose(bool)

OnAfterRender(bool)

protected override void OnAfterRender(bool firstRender)

Parameters:firstRenderbool

Overrides: ComponentBase.OnAfterRender(bool)

OnInitialized()

protected override void OnInitialized()

Overrides: DataVizChildComponent.OnInitialized()

OnParametersSet()

protected override void OnParametersSet()

Overrides: ComponentBase.OnParametersSet()