SplitButton Icon OptionsPremium
You can enhance the textual content of the SplitButton by displaying SVG icons, font icons, or images.
The SplitButton supports the following icon options:
svgIcon—Displays an SVG icon. For available icons, refer to the list of SVG icons.icon—Displays a font icon from the Kendo UI theme. For available icons, refer to the list of font icons.iconClass—Displays an icon from a CSS class, such as a Font Awesome icon.imageUrl—Displays an image from a URL.arrowButtonSvgIconandarrowButtonIcon—Replaces the default chevron-down icon of the arrow button with an SVG or font icon.endSvgIconandendIcon—Displays an SVG or font icon after the label.prefixandsuffix—Displays custom React content before or after the label.
The following example demonstrates a SplitButton with a font icon, an SVG icon, a Font Awesome icon, and an image.
SVG Icons
To display an SVG icon, set the svgIcon property property of the SplitButton to the necessary SVGIcon.
import { gearIcon } from '@progress/kendo-svg-icons';
<SplitButton svgIcon={gearIcon} items={items} text="Settings" />;
Font Icons
To display a Font icon inside the SplitButton:
- Load the font icons in your project so that the icon renders as expected.
- Depending on the font icons library, you can set the:
iconproperty to a font icon in the Kendo UI theme.tsx<SplitButton icon="gear" items={items} text="Settings" />iconClassproperty to a third-party font icon library (such as FontAwesome).tsx<SplitButton iconClass="fa fa-cog" items={items} text="Settings" />
Image URL
To display an image from a URL, set the imageUrl property of the SplitButton.
<SplitButton imageUrl="https://example.com/icons/settings.png" items={items} text="Settings" />;
Arrow Button Icon
By default, the arrow button of the SplitButton displays a chevron-down icon. To replace it with a different SVG icon, set the arrowButtonSvgIcon property. To replace it with a font icon, set the arrowButtonIcon property.
The following example demonstrates how to replace the default chevron-down arrow icon with a custom SVG icon by setting the arrowButtonSvgIcon property.
End Icon
Set endIcon to a font icon name or endSvgIcon to an SVG icon definition to render an icon after the primary action text. These properties do not change the separate arrow button. To render font icons, set the icon type to font.
You can combine trailing icons with icon or svgIcon.
The following example demonstrates how to set an SVG icon and a font icon after the text of the primary action, and how to combine an end icon with a leading icon.
Prefix and Suffix Content
Use prefix and suffix to pass React content before and after the normal SplitButton content. The prefix appears before the leading icon, and the suffix appears after any trailing icon. Custom elements must use phrasing content and must not contain interactive content.
import { SvgIcon } from '@progress/kendo-react-common';
import { saveIcon } from '@progress/kendo-svg-icons';
<SplitButton prefix={<SvgIcon icon={saveIcon} />} items={items} text="Save" />;
The following example demonstrates how to set the prefix and suffix props of the SplitButton.