shape
appearance
size
State
<button kuiIconButton type="button" appearance="primary" aria-label="Settings">
<kui-icon [source]="settingsIcon" />
</button>| Name | Type | Default | Description |
|---|---|---|---|
| shape | 'solid' | 'soft' | 'outline' | 'ghost' | 'ghost' | Surface treatment. Defaults to ghost. Combines freely with appearance. |
| appearance | 'primary' | 'danger' | 'success' | 'warning' | null | null | Semantic color intent. Without an explicit value, solid/soft use primary colors and outline/ghost use neutral defaults. |
| size | 'xs' | 'sm' | 'md' | 'lg' | 'md' | Square control size mapped to Kikita control height tokens (matches kui-input height at md). |
| disabled | boolean | false | Disables native button behavior. Anchor icon buttons receive aria-disabled and leave tab order. |
| loading | boolean | false | Replaces the icon (and any projected content) with a centered kui-loader spinner, sets aria-busy, and behaves like disabled. |
| icon | KuiIconName | undefined | undefined | Renders a kui-icon resolved by name as the button content, prepended before any other projected content, without hand-projecting kui-icon. |