BbIcon

Name of a registered icon to use, or a full raw <svg> string (e.g. an SVG file imported with ?raw).

Three forms: provider:name, local:name from the plugin's iconDir, and a bare name, which means local:. Write it as a complete literal: lucide:${status} is not bundled and draws the missing-icon placeholder unless listed in iconWhitelist. An unknown name never throws; a missing icon (v2’s type) does.

Label of the icon for accessibility.

Set it only when the icon is the only thing carrying the information. Beside its own text an icon should stay unlabelled, so assistive tech does not announce the same fact twice. It produces no title, so it never shows a tooltip — use v-bb-tooltip for that.

Passthrough, object form: { root: '…' }. See the pt:<part> row.

Passthrough, attribute form: one attribute per part, pt:<part>. Parts: root.

Defines the component size. Accepted values: - A key from the provided size map (keyof T), e.g. 'sm' | 'md' | 'lg' - A custom CSS size string (e.g. '20px', '1.5rem', '2em') - A number, typically interpreted as pixels by size parsers

The named keys come from the scale BbAvatar and every icon-bearing component share, so they can be retuned library-wide through the plugin's iconDefaultSizes. A hard pixel number opts out of that. An unparseable value warns and falls back to md.