ClassChartValueAxisTitle
Configures the title displayed alongside the chart value axis to describe what the axis represents. Provides comprehensive control over title appearance, positioning, and styling to clearly communicate the axis purpose and measurement units. Use this component to add descriptive text that helps users understand what values are being measured, such as "Sales Revenue ($)" or "Temperature (°C)".
Definition
Namespace:Telerik.Blazor.Components
Assembly:Telerik.Blazor.dll
Syntax:
public class ChartValueAxisTitle : DataVizChildComponent, IComponent, IHandleEvent, IHandleAfterRender, IDisposable
Inheritance: objectComponentBaseDataVizChildComponentChartValueAxisTitle
Implements:
Inherited Members
Constructors
ChartValueAxisTitle()
Declaration
public ChartValueAxisTitle()
Properties
Background
Sets the background color behind the value axis title for enhanced visibility and professional presentation. Accepts any valid CSS color value including hex codes (#F8F8F8), RGB values (rgb(248,248,248)), or color names (lightgray). Use background colors to improve title readability over complex chart backgrounds or when the title needs to stand out clearly. Consider using semi-transparent or subtle colors that enhance readability while complementing the overall chart design and value measurement context.
Declaration
[Parameter]
public string Background { get; set; }
Property Value
ChildContent
Declaration
[Parameter]
public RenderFragment ChildContent { get; set; }
Property Value
Color
Specifies the text color of the value axis title for optimal readability and visual consistency with chart theming. Accepts any valid CSS color value including hex codes (#333333), RGB values (rgb(51,51,51)), or color names (black). Use colors that provide sufficient contrast against the chart background and title background for accessibility. Consider the overall chart color scheme to ensure the title integrates well with the visualization design and value measurement presentation.
Font
Defines the font styling for the value axis title including size, family, and weight for professional typography. Accepts valid CSS font declarations such as "14px Arial", "bold 16px 'Segoe UI'", or "italic 12px sans-serif". Use appropriate font sizes that ensure readability and maintain visual hierarchy with other chart elements. Consider font consistency with your application's design system and ensure the title remains legible for value measurement context and data interpretation.
Position
Specifies the title position.
Declaration
[Parameter]
public ChartAxisTitlePosition? Position { get; set; }
Property Value
Rotation
Sets the rotation angle for the value axis title in degrees to optimize space utilization and readability. Positive values rotate the title clockwise, negative values rotate counter-clockwise. Default is 0 (no rotation). Common angles include 90 degrees for vertical text along the axis, -90 degrees for inverted vertical text, or custom angles for unique presentations. Use rotation to accommodate space constraints while maintaining title readability and professional value measurement context presentation.
Declaration
[Parameter]
public double? Rotation { get; set; }
Property Value
Text
Sets the text content to display as the value axis title for describing the measurement scale and data context. Supports plain text strings that describe the data being plotted on the value axis such as "Revenue", "Temperature", or "Percentage (%)". Use descriptive titles that help users understand the meaning and units of the axis values for improved chart accessibility. Clear axis titles enhance data interpretation and make value measurement context more intuitive for analysis and decision-making.
Visible
Controls whether the value axis title is visible on the chart for measurement context identification and accessibility. Set to true (default) to display the title that describes the axis values and measurement units. Set to false to hide the title completely for minimalist chart designs when the axis meaning is obvious from context. Hidden titles can provide more space for the plot area while relying on other means for value context and measurement identification.
Methods
BuildRenderTree(RenderTreeBuilder)
Declaration
protected override void BuildRenderTree(RenderTreeBuilder __builder)
Parameters
__builder
Overrides
OnAfterRender(bool)
Declaration
protected override void OnAfterRender(bool firstRender)
Parameters
firstRender
Overrides
OnInitialized()
Declaration
protected override void OnInitialized()
Overrides
OnParametersSet()
Declaration
protected override void OnParametersSet()
Overrides
Serialize()
Declaration
public Dictionary<string, object> Serialize()
Returns