Class SunburstTitleSettings

Configures the appearance, accessibility, and positioning of the title displayed in the Sunburst chart.

Inheritance
object
ComponentBase
SunburstTitleSettings
Implements
Inherited Members
Namespace: Syncfusion.Blazor.Charts
Assembly: Syncfusion.Blazor.Charts.dll
Syntax
public class SunburstTitleSettings : ComponentBase, IComponent, IHandleEvent, IHandleAfterRender
Remarks

The SunburstTitleSettings component provides customization options for the chart title, including font styling, color, alignment, position, and accessibility attributes.

Use this component to control how the title is rendered and exposed to assistive technologies.

Examples
<SfSunburstChart Title="Employee Distribution">
    <SunburstTitleSettings Position="SunburstTitlePosition.Left" FontFamily="Roboto" FontStyle="italic" FontWeight="bold" Size="22px" Color="#2c3e50" AccessibilityDescription="Main title: Employee Distribution" AccessibilityRole="heading" />
</SfSunburstChart>

Constructors

SunburstTitleSettings()

Declaration
public SunburstTitleSettings()

Properties

AccessibilityDescription

Gets or sets an accessible description for the chart title.

Declaration
[Parameter]
public string AccessibilityDescription { get; set; }
Property Value
Type Description
string

A string that provides additional descriptive information about the chart title for assistive technologies. The default value is Empty.
Remarks

This property enhances accessibility by supplying a meaningful description that can be announced by screen readers, helping users better understand the purpose or context of the chart title.

Examples
<SfSunburstChart Title="Employee Distribution">
    <SunburstTitleSettings AccessibilityDescription="Main title: Employee Distribution" />
</SfSunburstChart>

AccessibilityRole

Gets or sets the accessibility role for the chart title.

Declaration
[Parameter]
public string AccessibilityRole { get; set; }
Property Value
Type Description
string

A string that specifies the semantic role exposed to assistive technologies. The default value is Empty.
Remarks

This property helps assistive technologies interpret the purpose of the chart title by assigning an appropriate accessibility role.

Common values include roles such as heading, depending on the semantic meaning of the title within the application.

Examples
<SfSunburstChart Title="Employee Distribution">
    <SunburstTitleSettings AccessibilityRole="heading" />
</SfSunburstChart>

Color

Gets or sets the color of the title text.

Declaration
[Parameter]
public string Color { get; set; }
Property Value
Type Description
string

A string that specifies the title text color. The default value is determined by the active Theme.
Remarks

This property controls the color of the title text displayed in the Sunburst chart.

The color can be specified using standard CSS color formats, such as named colors, hexadecimal values, RGB values, and RGBA values.

Examples
<SfSunburstChart Title="Employee Distribution">
    <SunburstTitleSettings Color="#424242" />
</SfSunburstChart>

Focusable

Gets or sets a value indicating whether the chart title can receive keyboard focus.

Declaration
[Parameter]
public bool Focusable { get; set; }
Property Value
Type Description
bool

true if the chart title can receive keyboard focus; otherwise, false. The default value is true.
Remarks

This property improves accessibility by allowing keyboard users and assistive technologies to navigate to the chart title.

When enabled, the title becomes focusable and can participate in the application's keyboard navigation flow.

Examples
<SfSunburstChart Title="Employee Distribution">
    <SunburstTitleSettings Focusable="true" />
</SfSunburstChart>

FontFamily

Gets or sets the font family of the title text.

Declaration
[Parameter]
public string FontFamily { get; set; }
Property Value
Type Description
string

A string that specifies the font family of the title text. The default value is determined by the active Theme.
Remarks

This property controls the font family used to render the title text displayed in the Sunburst chart.

Multiple font families can be specified as a comma-separated list. The browser uses the first available font in the specified order.

Examples
<SfSunburstChart Title="Employee Distribution">
    <SunburstTitleSettings FontFamily="Segoe UI" />
</SfSunburstChart>

FontStyle

Gets or sets the font style of the title text.

Declaration
[Parameter]
public string FontStyle { get; set; }
Property Value
Type Description
string

A string that specifies the font style of the title text. The default value is determined by the active Theme.
Remarks

This property controls the style of the title text displayed in the Sunburst chart.

Supported values include Normal, Italic, and Oblique.

Examples
<SfSunburstChart Title="Employee Distribution">
    <SunburstTitleSettings FontStyle="Italic" />
</SfSunburstChart>

FontWeight

Gets or sets the font weight of the title text.

Declaration
[Parameter]
public string FontWeight { get; set; }
Property Value
Type Description
string

A string that specifies the font weight of the title text. The default value is determined by the active Theme.
Remarks

This property controls the thickness of the title text displayed in the Sunburst chart.

Common values include Normal, Bold, Bolder, Lighter, and numeric values such as 400, 500, and 700.

Examples
<SfSunburstChart Title="Employee Distribution">
    <SunburstTitleSettings FontWeight="Bold" />
</SfSunburstChart>

Position

Gets or sets the position of the title within the Sunburst chart.

Declaration
[Parameter]
public SunburstTitlePosition? Position { get; set; }
Property Value
Type Description
SunburstTitlePosition?

A SunburstTitlePosition value that specifies the title position. The default value is Top.
Remarks

This property determines where the title is rendered relative to the Sunburst chart.

Supported positions include Top, Bottom, Left, and Right.

Examples
<SfSunburstChart Title="Employee Distribution">
    <SunburstTitleSettings Position="SunburstTitlePosition.Left" />
</SfSunburstChart>

Size

Gets or sets the font size of the title text.

Declaration
[Parameter]
public string Size { get; set; }
Property Value
Type Description
string

A string that specifies the font size of the title text. The default value is determined by the active Theme.
Remarks

This property controls the size of the title text displayed in the Sunburst chart.

Examples
<SfSunburstChart Title="Employee Distribution">
    <SunburstTitleSettings Size="18px" />
</SfSunburstChart>

Implements