Icon
Media
stable
Universal icon renderer that adapts to MDI class icons, SVG paths, component-based icons and Unicode ligatures.
API
Props
All props accepted by this component, with their type, default value and description.
- iconTIcon
- Icon identifier. Accepts an MDI name (mdi-*), a SVG path string, or a component reference.
- colorTColor
- Icon color. Accepts a semantic intent or a CSS color string.
- disabledbooleanfalse
- Disables pointer interaction and applies a muted visual state.
- bgColorTColor
- Background color rendered behind the icon.
- idstring
- classstring | Array<string> | object
- stylestring | Array<string> | object | StyleValue
- tagstring'i'
- HTML element rendered at the root. Defaults to <i>.
- sizeTSize | number'default'
- Controls the icon font-size via design tokens.
- paddingboolean | number | string
- Shorthand padding applied to the icon container.
- paddingTopboolean | number | string
- paddingLeftboolean | number | string
- paddingBottomboolean | number | string
- paddingRightboolean | number | string
- paddingBlockboolean | number | string
- paddingInlineboolean | number | string
- paddingInlineStartboolean | number | string
- paddingInlineEndboolean | number | string
- paddingBlockStartboolean | number | string
- paddingBlockEndboolean | number | string
- marginboolean | number | string
- Shorthand margin around the icon container.
- marginTopboolean | number | string
- marginLeftboolean | number | string
- marginBottomboolean | number | string
- marginRightboolean | number | string
- marginBlockboolean | number | string
- marginInlineboolean | number | string
- marginInlineStartboolean | number | string
- marginInlineEndboolean | number | string
- marginBlockStartboolean | number | string
- marginBlockEndboolean | number | string
- borderboolean | number | string | TDirectionBoth | Array<TDirectionBoth>false
- Applies a border around the icon container.
- borderTopboolean | number | string
- borderLeftboolean | number | string
- borderBottomboolean | number | string
- borderRightboolean | number | string
- borderBlockboolean | number | string
- borderInlineboolean | number | string
- borderInlineStartboolean | number | string
- borderInlineEndboolean | number | string
- borderBlockStartboolean | number | string
- borderBlockEndboolean | number | string
- borderColorstring
- borderStylestring
- borderTopColorTColor
- borderRightColorTColor
- borderBottomColorTColor
- borderLeftColorTColor
- borderInlineStartColorTColor
- borderInlineEndColorTColor
- borderBlockStartColorTColor
- borderBlockEndColorTColor
- heightnumber | string
- Explicit height override.
- maxHeightnumber | string
- maxWidthnumber | string
- minHeightnumber | string
- minWidthnumber | string
- widthnumber | string
- Explicit width override.
- roundedboolean | number | string | TRounded | null | undefined
- Border-radius token applied to the icon container.
- roundedTopRightboolean | number | string
- roundedTopLeftboolean | number | string
- roundedBottomLeftboolean | number | string
- roundedBottomRightboolean | number | string
- roundedStartStartboolean | number | string
- roundedStartEndboolean | number | string
- roundedEndStartboolean | number | string
- roundedEndEndboolean | number | string
API
Slots
Content slots exposed by this component.
- #default
- Text node that acts as the icon identifier (ligature mode). Also used to override the rendered icon with custom content.
Interactive
Playground
Edit props live and see the component update in real time. The generated code snippet updates as you change values.
Rendering the live preview…
Usage
Examples
Ready-to-paste code snippets for your templates.
Basic icons
Sizes
Styled icon container
Ecosystem
Family
Components from the same folder that share conventions and often compose together.