Forma icon · Actions
Add
A plus sign: create a new item or add something to the current collection.
- Name
add- Category
- Actions
- Introduced
- Forma 0.5.0
- Keywords
- new, create
- Grid
- 24 × 24, 1.8 stroke, round caps and joins
- Origin
- Original Forma artwork
Meaning and when to use it
A plus sign: create a new item or add something to the current collection.
Use it for
- Primary “New record” or “Add row” actions.
- Adding an item to a list, filter set or selection.
Avoid it for
- Zoom in or numeric increment; label those explicitly instead.
- Expanding a disclosure; use chevron-down.
Sizes
The default size is 1.25em, so the icon follows the surrounding text. These are the reviewed sizes; geometry keeps a one-unit safe margin at every size.
16px 20px 24px 32px 48px
<forma-icon class="forma-component-tag"><span class="forma-icon" style="--forma-icon-size:32px" data-forma-icon="add"><svg xmlns="http://www.w3.org/2000/svg" class="forma-icon__svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="M12 5V19M5 12H19"/></svg></span></forma-icon>
Click or tap the code once to select all of it, then copy.
Colour and contrast modes
The icon has no colour of its own: its stroke is currentColor. These swatches set only the parent’s colour role. Brands and themes change the ink through the same roles.
-
Primary text --forma-color-text-primary -
Secondary text --forma-color-text-secondary -
Accent --forma-color-accent-primary -
Secondary surface --forma-color-text-on-secondary-surface -
Inverse surface --forma-color-text-inverse
Forced colours and high contrast
In Windows high-contrast and other forced-colour modes the icon is drawn in the system text colour (CanvasText), or the button text colour inside buttons. Meaning must therefore never depend on the icon’s colour.
Grayscale and print
The ink is a vector stroke, not a background, so it prints when browsers drop backgrounds and stays legible in grayscale. Status is always carried by the words next to the icon.
Configurations and how to use them
Every configuration below uses the same generated snippet. Only the surrounding HTML changes. Copy the example that matches your context.
Button with a visible text label
The preferred configuration. The icon is decorative and the visible text names the control, so nothing else is needed.
<button type="button"><forma-icon class="forma-component-tag"><span class="forma-icon" data-forma-icon="add"><svg xmlns="http://www.w3.org/2000/svg" class="forma-icon__svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="M12 5V19M5 12H19"/></svg></span></forma-icon> Add task</button>
Click or tap the code once to select all of it, then copy.
Icon-only button
When space only allows the glyph, the button itself must carry the accessible name with aria-label. The SVG stays aria-hidden and the button keeps a touch target of about 44 by 44 CSS pixels.
<button type="button" aria-label="Add task" style="min-inline-size:2.75rem;min-block-size:2.75rem"><forma-icon class="forma-component-tag"><span class="forma-icon" data-forma-icon="add"><svg xmlns="http://www.w3.org/2000/svg" class="forma-icon__svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="M12 5V19M5 12H19"/></svg></span></forma-icon></button>
Click or tap the code once to select all of it, then copy.
Inline with status or body text
Placed before words, the icon repeats meaning the text already states. It scales with the surrounding font size because the default size is 1.25em.
<p><forma-icon class="forma-component-tag"><span class="forma-icon" data-forma-icon="add"><svg xmlns="http://www.w3.org/2000/svg" class="forma-icon__svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="M12 5V19M5 12H19"/></svg></span></forma-icon> Add task</p>
Click or tap the code once to select all of it, then copy.
Custom size
Set --forma-icon-size on the presentation span or any ancestor. Keep icons at 16px or larger.
<p style="--forma-icon-size:2rem"><forma-icon class="forma-component-tag"><span class="forma-icon" data-forma-icon="add"><svg xmlns="http://www.w3.org/2000/svg" class="forma-icon__svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="M12 5V19M5 12H19"/></svg></span></forma-icon> 2rem icon</p>
Click or tap the code once to select all of it, then copy.
Custom colour
The stroke is currentColor, so the parent’s colour role decides the ink. Never rewrite the SVG geometry or stroke to recolour it.
<p style="color:var(--forma-color-accent-primary)"><forma-icon class="forma-component-tag"><span class="forma-icon" data-forma-icon="add"><svg xmlns="http://www.w3.org/2000/svg" class="forma-icon__svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="M12 5V19M5 12H19"/></svg></span></forma-icon> <span style="color:var(--forma-color-text-primary)">Accent ink, primary text</span></p>
Click or tap the code once to select all of it, then copy.
Standalone meaningful image
Use the static SVG file with alt text when the icon stands alone and carries meaning, for example in a table cell with no other text.
<img src="add.svg" alt="Add" width="24" height="24">
Click or tap the code once to select all of it, then copy.
Decorative image
When nearby text already says the same thing, give the image an empty alt so assistive technology skips it.
Add
<p><img src="add.svg" alt="" width="20" height="20"> Add</p>
Click or tap the code once to select all of it, then copy.
Files and package paths
Copy the generated assets from the pinned package. Do not hand-copy path geometry: the compiled files are deterministic and verified against the digest below.
| Asset | Package path | Use |
|---|---|---|
| Static SVG | @echelon-foundry/design-system/icons/add.svg | <img>, CSS, print and offline documents |
| Decorative HTML | @echelon-foundry/design-system/icons/html/add.html | Inline markup inside a named control or next to text |
| Registry entry | @echelon-foundry/design-system/icons/registry.json | Name, label, category, keywords and digest for tools |
Download add.svg · Decorative HTML as text
<svg xmlns="http://www.w3.org/2000/svg" class="forma-icon__svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M12 5V19M5 12H19"/></svg>
Click or tap the code once to select all of it, then copy.
<forma-icon class="forma-component-tag"><span class="forma-icon" data-forma-icon="add"><svg xmlns="http://www.w3.org/2000/svg" class="forma-icon__svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="M12 5V19M5 12H19"/></svg></span></forma-icon>
Click or tap the code once to select all of it, then copy.
- Forma version
1.0.2- SVG sha256
0315ff7c86fb126c77474a5ae6f1fdc0b4becf7da7e12bb76baffa0353ce4c6f
Accessibility checklist
- The inline SVG is always aria-hidden and not focusable; it never names, operates or announces anything by itself.
- An icon-only control needs its own accessible name, for example aria-label="Add task".
- A standalone meaningful image uses alt text; a decorative image uses alt="".
- Icon names such as “add” are identifiers, not translated labels. Write the accessible name in the interface language.
- State and outcome are always written in text. Colour and the glyph only repeat it.
- Interactive parents keep a touch target of about 44 by 44 CSS pixels.