FS-Skia-UI
Icon
- Category: display
- Purpose: Named icon glyph or product symbol.
- API reference: FS.Skia.UI.Controls.Icon
← Back to the controls catalog
Overview
The Icon control is a display-category control in the FS.Skia.UI control suite.
Named icon glyph or product symbol. It requires the text attribute. It raises no events (it is a non-interactive, display-only control). Its accessibility role is Image.
Build it through the FS.Skia.UI.Controls.Icon module — the typed Props/MVU front door is the
preferred authoring surface (see
Typed control front door). Every
attribute is owned by the model; the control renders against the active Theme,
so its colours, sizing, and density follow the design tokens (see
Controls in the Spec Kit workflow).
Usage example
A runnable example that exercises this control lives in the controls gallery
sample, samples/ControlsGallery/Program.fs. It is compiled as part of the build,
so the example stays in lock-step with the public API.
Preview
A deterministic render-only preview of Icon (320×160), produced through the
render-only evidence path (Widget.render → SkiaViewer.captureScreenshotEvidence,
ViewerRenderTargetPng) and validated decodable / non-1×1 / non-trivial via
Testing.readPngArtifact. It shows the control rendered against the default
DesignTokens.Light theme.