Skip to content

Files

Latest commit

dimodidimodi
Jan 9, 2024
b65ebb8 · Jan 9, 2024

History

History
240 lines (179 loc) · 6.55 KB
·

appearance.md

File metadata and controls

240 lines (179 loc) · 6.55 KB
·
title page_title description slug tags published position
Appearance
SplitButton Appearance
Apperance settings for the SplitButton for Blazor.
splitbutton-appearance
telerik,blazor,splitbutton,appearance,styling
true
10

SplitButton Appearance

This article describes the declarative settings of the SplitButton component, which affect its styling and appearance.

The SplitButton provides the same appearance parameters, as the regular [Button component]({%slug button-appearance%}):

Setting Parameter Values

The examples in this article use reflection to show all possible values of the SplitButton parameters. In a real-world scenario, there are two options to set the desired parameter values:

  • Use the static class members in the ThemeConstants.SplitButton namespace. This is the easier and recommended approach.
  • Set the actual string values directly.

The following two configurations will produce the same result.

caption Two ways to set SplitButton appearance parameters

<TelerikSplitButton FillMode="@ThemeConstants.SplitButton.FillMode.Solid"
                    Rounded="@ThemeConstants.SplitButton.Rounded.Large"
                    Size="@ThemeConstants.SplitButton.Size.Large"
                    ThemeColor="@ThemeConstants.SplitButton.ThemeColor.Primary">
    <SplitButtonContent> Foo </SplitButtonContent>
    <SplitButtonItems>
        <SplitButtonItem> Bar </SplitButtonItem>
    </SplitButtonItems>
</TelerikSplitButton>

<TelerikSplitButton FillMode="solid"
                    Rounded="lg"
                    Size="lg"
                    ThemeColor="primary">
    <SplitButtonContent> Foo </SplitButtonContent>
    <SplitButtonItems>
        <SplitButtonItem> Bar </SplitButtonItem>
    </SplitButtonItems>
</TelerikSplitButton>

FillMode

The FillMode parameter controls if the SplitButton will have a background and borders. The setting also affects the component's hover state. To set the parameter value, use the string members of the static class ThemeConstants.SplitButton.FillMode.

FillMode Class Member String Value
Solid (default) "solid"
Flat "flat"
Outline "outline"
Link "link"

caption SplitButton FillMode example

<p>SplitButton FillMode</p>

@foreach (var item in FillModes)
{
    var fillMode = item.GetValue(null).ToString();

    <TelerikSplitButton FillMode="@fillMode">
        <SplitButtonContent> @fillMode </SplitButtonContent>
        <SplitButtonItems>
            <SplitButtonItem> secondary </SplitButtonItem>
        </SplitButtonItems>
    </TelerikSplitButton>
}

@code {
    List<System.Reflection.FieldInfo> FillModes { get; set; }

    protected override void OnInitialized()
    {
        FillModes = typeof(ThemeConstants.SplitButton.FillMode)
            .GetFields().ToList();

        base.OnInitialized();
    }
}

Rounded

The Rounded parameter affects the SplitButton border-radius CSS styles. To set the parameter value, use the string members of the static class ThemeConstants.SplitButton.Rounded.

Rounded Class Member String Value
Small "sm"
Medium (default) "md"
Large "lg"
Full "full"

caption SplitButton Rounded example

<p>SplitButton Rounded</p>

@foreach (var item in RoundedOptions)
{
    var rounded = item.GetValue(null).ToString();

    <TelerikSplitButton Rounded="@rounded">
        <SplitButtonContent> @rounded </SplitButtonContent>
        <SplitButtonItems>
            <SplitButtonItem> secondary </SplitButtonItem>
        </SplitButtonItems>
    </TelerikSplitButton>
}

@code {
    List<System.Reflection.FieldInfo> RoundedOptions { get; set; }

    protected override void OnInitialized()
    {
        RoundedOptions = typeof(ThemeConstants.SplitButton.Rounded)
            .GetFields().ToList();

        base.OnInitialized();
    }
}

Size

The Size parameter can change some SplitButton dimensions, such as height, margins or paddings. Possible values are the string members of the static class ThemeConstants.SplitButton.Size.

Size Class Member String Value
Small "sm"
Medium (default) "md"
Large "lg"

caption SplitButton Size example

<p>SplitButton Size</p>

@foreach (var item in Sizes)
{
    var size = item.GetValue(null).ToString();

    <TelerikSplitButton Size="@size">
        <SplitButtonContent> @size </SplitButtonContent>
        <SplitButtonItems>
            <SplitButtonItem> secondary </SplitButtonItem>
        </SplitButtonItems>
    </TelerikSplitButton>
}

@code {
    List<System.Reflection.FieldInfo> Sizes { get; set; }

    protected override void OnInitialized()
    {
        Sizes = typeof(ThemeConstants.SplitButton.Size)
            .GetFields().ToList();

        base.OnInitialized();
    }
}

ThemeColor

The ThemeColor parameter sets the SplitButton's background and text color from a set of predefined options. Use the string members of the static class ThemeConstants.SplitButton.ThemeColor.

ThemeColor Class Member String Value
Base (default) "base"
Primary "primary"
Secondary "secondary"
Tertiary "tertiary"
Info "info"
Success "success"
Warning "warning"
Error "error"
Dark "dark"
Light "light"
Inverse "inverse"

caption SplitButton ThemeColor example

<p>SplitButton ThemeColor</p>

@foreach (var item in ThemeColors)
{
    var themeColor = item.GetValue(null).ToString();

    <TelerikSplitButton ThemeColor="@themeColor">
        <SplitButtonContent> @themeColor </SplitButtonContent>
        <SplitButtonItems>
            <SplitButtonItem> secondary </SplitButtonItem>
        </SplitButtonItems>
    </TelerikSplitButton>
}

@code {
    List<System.Reflection.FieldInfo> ThemeColors { get; set; }

    protected override void OnInitialized()
    {
        ThemeColors = typeof(ThemeConstants.SplitButton.ThemeColor)
            .GetFields().ToList();

        base.OnInitialized();
    }
}

@template

Next Steps

  • [Handle SplitButton Events]({%slug splitbutton-events%})
  • [Add SplitButton Icons]({%slug splitbutton-icons%})

See Also