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

ChartPlotArea

Class

Defines the visual appearance and layout of the chart's main data plotting area where series data is rendered. Controls background colors, opacity, borders, margins, and padding to create the visual container for chart series. Essential for customizing chart aesthetics and ensuring proper data presentation within the chart layout. Children: ChartPlotAreaBorder, ChartPlotAreaMargin, ChartPlotAreaPadding.

Definition

Namespace:Telerik.Blazor.Components

Assembly:Telerik.Blazor.dll

Syntax:

public class ChartPlotArea : DataVizChildComponent, IComponent, IHandleEvent, IHandleAfterRender, IDisposable

Inheritance: objectComponentBaseDataVizChildComponentChartPlotArea

Implements: IComponentIDisposableIHandleAfterRenderIHandleEvent

Inherited Members DataVizChildComponent.Dispose()DataVizChildComponent.Dispose(bool)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

ChartPlotArea()

public ChartPlotArea()

Methods

BuildRenderTree(RenderTreeBuilder)

protected override void BuildRenderTree(RenderTreeBuilder __builder)

Parameters:__builderRenderTreeBuilder

Overrides: ComponentBase.BuildRenderTree(RenderTreeBuilder)

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()

Serialize()

Dictionary<string, object>

public Dictionary<string, object> Serialize()

Returns:

Dictionary<string, object>

Properties

Background

string

Sets the background color of the chart plot area where series data is displayed. Accepts any valid CSS color value including hex (#FF5733), RGB (rgb(255, 87, 51)), named colors (red, blue), or HSL values. Use contrasting colors to ensure data visibility and maintain chart readability.

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

ChildContent

RenderFragment

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

Opacity

double?

Controls the transparency of the chart plot area background. Values range from 0.0 (completely transparent) to 1.0 (completely opaque). Use values like 0.1-0.3 for subtle transparency effects or 0.8-0.9 for semi-transparent backgrounds that allow underlying elements to show through.

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