ClassChartXAxisPlotBand
Represents a plot band that highlights specific value ranges on the X-axis with colored background areas. Provides comprehensive configuration for creating visual emphasis zones that help users identify important ranges, thresholds, or periods in the data. Use this component to highlight critical ranges, mark special time periods, or create visual zones that enhance data interpretation and analysis.
Definition
Namespace:Telerik.Blazor.Components
Assembly:Telerik.Blazor.dll
Syntax:
public class ChartXAxisPlotBand : DataVizCollectionItemComponent, IComponent, IHandleEvent, IHandleAfterRender, IDisposable
Inheritance: objectComponentBaseDataVizChildComponentDataVizCollectionItemComponentChartXAxisPlotBand
Implements:
Inherited Members
Constructors
ChartXAxisPlotBand()
Declaration
public ChartXAxisPlotBand()
Properties
ChildContent
The content of the ChartXAxisPlotBand component. Children: ChartXAxisPlotBandLabel.
Declaration
[Parameter]
public RenderFragment ChildContent { get; set; }
Property Value
Color
Specifies the background color of the plot band area on the X-axis. Accepts any valid CSS color value including hex codes (#FFE6E6), RGB values (rgb(255,230,230)), or color names (lightcoral). Use colors that provide sufficient contrast for readability while highlighting the intended range without overwhelming the chart data. Consider using semi-transparent colors or subtle tints to maintain data visibility within the highlighted area.
From
Defines the starting position of the plot band along the X-axis in axis units. For category axes, specify the category index or name where the plot band begins. For date axes, provide a DateTime value or date string for the start position. This property works with the To property to define the complete range that will be highlighted by the plot band.
Opacity
Sets the transparency level of the plot band from 0 (completely transparent) to 1 (completely opaque). Use values between 0.1-0.3 for subtle highlighting that doesn't interfere with data visibility. Higher opacity values (0.5-0.8) create more prominent emphasis zones for critical ranges. Balance opacity with color choice to achieve the desired visual impact while maintaining chart readability.
Declaration
[Parameter]
public double? Opacity { get; set; }
Property Value
To
Defines the ending position of the plot band along the X-axis in axis units. For category axes, specify the category index or name where the plot band ends. For date axes, provide a DateTime value or date string for the end position. This property works with the From property to define the complete range that will be highlighted by the plot band.
Methods
BuildRenderTree(RenderTreeBuilder)
Declaration
protected override void BuildRenderTree(RenderTreeBuilder __builder)
Parameters
__builder
Overrides
Dispose(bool)
Declaration
protected override void Dispose(bool disposing)
Parameters
disposing
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