Icon

269 icons · 16 × 16 · click one to download its SVG

Icons beside words

Every drawing occupies a square, with its lower edge on the text line.

Real library icons

Each drawing is selected with the type attribute.

Glyph, primary and secondary

The same drawing in three treatments.

AttributeTypeDefaultWhat it does
typestringEmptyFile name from DS1/x-icon/, without .svg.
variantglyph, primary, secondaryglyphPlain drawing or a background treatment.

Use type="check", not name="check". There is no size attribute. The drawing follows the system’s --sf scale. Use --icon-color when a control needs a different ink.

A decorative icon beside text can have aria-hidden="true". Give an icon-only button an accessible name on its actual button. A tooltip supplements that name; it is not a replacement for it.

The source files live in DS1/x-icon/. Add missing drawings to that library first, then generate the runtime map and public collection. Products carry the icons they use as local files.

ds-icon draws the most common icons at once and loads the rest in one deferred chunk the first time one is asked for. A component that always draws one icon ships that drawing with itself through provideIcons({ name: svg }), as ds-avatar does with its person, so it never waits for the chunk.

Button · Tooltip · All components