Defines a highlighted region (plot band) on the category axis in ChartCategoryAxisPlotBands. Use this component to visually emphasize specific ranges of categories or time periods, such as weekends, holidays, target zones, or normal operating ranges. Plot bands appear as colored background regions that help users identify important data patterns or contextual information. Configure the range using From/To positions and customize appearance with colors, opacity, and optional labels. Children: ChartCategoryAxisPlotBandLabel.
Definition
Namespace:Telerik.Blazor.Components
Assembly:Telerik.Blazor.dll
Syntax:
public class ChartCategoryAxisPlotBand : DataVizCollectionItemComponent, IComponent, IHandleEvent, IHandleAfterRender, IDisposableInheritance: objectComponentBaseDataVizChildComponentDataVizCollectionItemComponentChartCategoryAxisPlotBand
Implements:
Inherited Members
Constructors
public ChartCategoryAxisPlotBand()Methods
protected override void BuildRenderTree(RenderTreeBuilder __builder)Overrides:
protected override void OnInitialized()Overrides:
protected override void OnParametersSet()Overrides:
Properties
The content of the ChartCategoryAxisPlotBand component. Children: ChartCategoryAxisPlotBandLabel.
[Parameter]
public RenderFragment ChildContent { get; set; }Sets the background color of the plot band. Accepts any valid CSS color including hex codes (#F0F8FF), RGB values (rgb(240,248,255)), named colors (lightblue), or HSL values. Plot bands are typically semi-transparent colored regions that highlight specific ranges of data, such as target zones, normal ranges, or time periods of interest.
[Parameter]
public string Color { get; set; }Defines the starting position of the plot band along the category axis. Use category values for categorical data (like "January", "Product A") or date/time values for time-based axes. The plot band will extend from this position to the To position, creating a highlighted region across the specified range.
[Parameter]
public object From { get; set; }Controls the transparency of the plot band using values from 0.0 (completely transparent) to 1.0 (completely opaque). Common values include 0.1-0.3 for subtle background highlighting, 0.5 for moderate emphasis, or 0.7-0.9 for strong visual distinction. Lower opacity allows underlying chart elements to remain visible.
[Parameter]
public double? Opacity { get; set; }Defines the ending position of the plot band along the category axis. Use category values for categorical data (like "December", "Product Z") or date/time values for time-based axes. The plot band will extend from the From position to this position, creating a highlighted region that spans the specified range.
[Parameter]
public object To { get; set; }