npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@rogieking/figui3

v12.0.5

Published

A lightweight web components library for building Figma plugin and widget UIs with native look and feel

Readme

FigUI3

A lightweight, zero-dependency web components library for building Figma plugin and widget UIs with native look and feel.

npm version License

Live Playground & Demos

Features

  • Figma UI3 design system
  • Zero dependencies
  • ~228 KB JS + ~102 KB CSS minified
  • Built with Web Components
  • Automatic light/dark theme support
  • Accessible with ARIA attributes and keyboard navigation
  • Framework agnostic (React, Vue, Svelte, or vanilla JS)

Accessibility Coverage

FigUI3 components are built to preserve native semantics where possible and add ARIA only where custom elements need extra state or naming.

  • Form primitives forward accessible names and state to their native controls, including combo inputs, dropdowns, text, number, slider, checkbox, radio, switch, color, and fill inputs.
  • Selection components use standard keyboard patterns: tabs use roving focus and aria-controls, segmented controls expose a radio-group pattern with focus following arrow selection, choosers expose listbox/options, and menus support trigger state, item focus, Escape close, and disabled items.
  • Dialog, popup, tooltip, and toast surfaces expose names, close affordances, live-region behavior, Escape dismissal, and focus return behavior appropriate to their role.
  • Media components render their visual surface inside fig-preview; image/video semantics stay on the native media element, upload controls remain keyboard reachable, slotted image overlays stay in light DOM for framework ownership, and generated video controls render below the preview instead of as an overlay.
  • Display and pointer components expose useful semantics when interactive or informative: handles, swatches, color tips, layers, spinners, shimmers, and skeletons sync names, busy states, disabled states, keyboard movement, inert states, or hidden states as appropriate.
  • Focus styling uses shared --figma-focus-outline, --figma-focus-outline-offset, and --figma-focus-outline-radius tokens so visible focus treatment stays consistent across components.
  • Component contracts include Playwright keyboard/focus coverage plus an axe smoke suite for representative form, media, overlay, selection, and loading fixtures.

Quick Start

Install:

npm install @rogieking/figui3

Import:

import "@rogieking/figui3/fig.css";
import "@rogieking/figui3/fig.js";

fig.js registers <fig-layer> with the other core elements. Add its standalone stylesheet when you need the layer-list presentation:

import "@rogieking/figui3/fig-layer.css";

Editor and experimental Lab components are distributed separately under PolyForm Shield by @rogieking/figui3-extended:

import "@rogieking/figui3-extended/fig-editor.css";
import "@rogieking/figui3-extended/fig-editor.js";

For server-rendered apps, use the SSR-safe registration entry point. Call it after hydration from a React effect instead of statically importing the side-effect JavaScript bundles:

import { useEffect } from "react";
import { register } from "@rogieking/figui3/register.js";

function RegisterFigUI() {
  useEffect(() => {
    void register();
  }, []);
  return null;
}

Render <RegisterFigUI /> inside the hydrated root. Direct fig.js imports remain convenient for client-only apps, but register immediately when evaluated in a browser.

Or use a CDN:

<link rel="stylesheet" href="https://unpkg.com/@rogieking/figui3@latest/dist/fig.css" />
<script type="module" src="https://unpkg.com/@rogieking/figui3@latest/dist/fig.js"></script>

Agent skills ship in .cursor/skills/ (included in the npm package):

  • figui3 — core fig.js components
  • propskit — declarative property panels; examples are included in /propskit

Cursor discovers this repository's root .cursor/skills/ automatically. In a consuming project, npm installs the packaged copies under node_modules/@rogieking/figui3/.cursor/skills/; Cursor does not automatically discover skills inside node_modules, but agents can read those files directly.

See the generated bundle registration inventory for the exact tags registered by Core.

Minimal example:

<fig-field direction="horizontal">
  <label>Color</label>
  <fig-input-color value="#FF5733" text="true"></fig-input-color>
</fig-field>
<fig-button variant="primary">Save</fig-button>

PropsKit

PropsKit renders declarative property controls using only the Core bundle:

import "@rogieking/figui3/fig.css";
import {
  figCreateProps,
  figCreatePropsRoot,
} from "@rogieking/figui3/propskit.js";

const kit = figCreateProps("Appearance", {
  opacity: 75,
  width: {
    type: "number",
    control: "number",
    default: 320,
    units: "px",
  },
  visible: true,
  title: "Hello",
  layout: {
    _collapsed: true,
    alignment: {
      type: "options",
      default: "Center",
      options: ["Left", "Center", "Right"],
    },
  },
});

const root = figCreatePropsRoot({
  target: document.querySelector("#properties"),
  panelIds: [kit.id],
});

const unsubscribe = kit.subscribe((values) => {
  console.log(values);
});

Numbers render as fig-slider by default. Use control: "number" for fig-input-number or variant: "delta" for a delta slider. On sliders, stepper: true enables stepper mode. Exact number inputs show steppers by default; set stepper: false to hide them. Nested objects become static fig-group sections. Add _collapsed: false for an initially open collapsible group or _collapsed: true for an initially closed one. Supported controls include text, switch, color, gradient, palette, options, easing, rotate, point, joystick, file, image, video, audio, and actions. Image and video definitions accept options as source strings or { value, label } entries. Multiple options render in a fig-chooser; the resolved value is the selected source string, defaulting to the first option. Omit options for an upload-only control. Audio keeps its optional multiple / maxItems array model. Pass null, an empty string, or whitespace as the name to mount controls directly without an outer panel or generated header.

Joystick definitions store coordinates on a 0…100 scale by default. Set unitScale: 1 to store the component's normalized 0…1 coordinates instead.

Call unsubscribe(), root.destroy(), and kit.destroy() when the owning view unmounts. Interactive examples are available at /propskit in the playground.

onInput and onChange report user interactions only. Programmatic setValue(), setValues(), and resetValues() calls update subscribers without echoing through those interaction callbacks.


Components

Editor and Lab entries below are cross-package references and require @rogieking/figui3-extended; they are not included in this MIT package.

| Component | Tag | Description | |---|---|---| | Button | <fig-button> | Buttons with variants, toggle, select, upload | | Play Button | <fig-button-play> | Play/pause button with a timed progress ring | | Dropdown | <fig-dropdown> | Native select wrapper with Figma styling | | Select | <fig-select> | Custom listbox select (requires fig-editor.js) | | Split Input | <fig-split-input> | Text or number input with dropdown suggestions | | Checkbox | <fig-checkbox> | Checkbox with indeterminate state | | Radio | <fig-radio> | Radio button | | Switch | <fig-switch> | Toggle switch | | Slider | <fig-slider> | Range, hue, opacity, delta, stepper | | Carousel | <fig-carousel> | Timed image and video carousel with generated playback controls | | Audio | <fig-audio> | Waveform audio player with shared media controls | | Audio Waveform | <fig-audio-waveform> | Responsive waveform generated from an audio URL | | Input Slider | <fig-input-slider> | Experimental standalone slider primitives | | Input Wheel | <fig-input-wheel> | Standalone SVG tick-and-handle numeric scrubber | | Text Input | <fig-input-text> | Styled text/textarea input | | Number Input | <fig-input-number> | Numeric input with units | | Input Rotate | <fig-input-rotate> | Compact X/Y/Z rotation trigger | | Input Point | <fig-input-point> | Paired X/Y numeric input | | File Input | <fig-input-file> | File upload with image previews and audio playback waveforms | | Angle | <fig-angle> | Instrument-style angle/rotation dial | | Swatch | <fig-swatch> | Color/gradient/image swatch | | Color Tip | <fig-color-tip> | Compact color tip with picker | | Color Input | <fig-input-color> | Color picker with hex/alpha | | Input Palette | <fig-input-palette> | Editable multi-color palette | | Property | <fig-property> | Composable editor property row | | Palette Editor | <fig-palette-editor> | Reusable reorderable palette editor | | Gradient Editor | <fig-gradient-editor> | Full gradient editor with reorderable stops | | Gradient Popup | <dialog is="fig-popup-gradient"> | Reusable full gradient editor popup | | Palette Popup | <dialog is="fig-popup-palette"> | Reusable palette editor popup | | Reorder | <fig-reorder> | Pointer- and keyboard-reorderable list | | Gradient Input | <fig-input-gradient> | Gradient editor with stops | | Fill Input | <fig-input-fill> | Solid, gradient, image, video fill | | Fill Picker | <fig-fill-picker> | Full fill picker dialog | | Toolbelt | <fig-toolbelt> / <fig-toolbelt-group> / <fig-toolbelt-item> | Groupable selectable toolbar with directional overflow | | Tabs | <fig-tabs> / <fig-tab> | Tabbed navigation | | Segmented Control | <fig-segmented-control> / <fig-segment> | Segmented button group | | Chooser | <fig-chooser> / <fig-choice> | Selection list with drag scroll | | Field | <fig-field> | Form field wrapper with layout | | Group | <fig-group> | Named or collapsible section group | | Joystick | <fig-joystick> | 2D position input | | Origin Grid | <fig-origin-grid> | Transform-origin grid | | Easing Curve | <fig-easing-curve> | Bezier/spring curve editor | | Easing Popup | <dialog is="fig-popup-easing"> | Reusable easing editor popup | | 3D Rotate | <fig-3d-rotate> | 3D cube rotation control | | Handle | <fig-handle> | Draggable handle on a surface | | Canvas Control | <fig-canvas-control> | Point with optional radius, angle, or second point | | Dialog | <fig-dialog> | Modal/non-modal dialog | | Popup | <fig-popup> | Anchored floating surface | | Toast | <fig-toast> | Toast notification | | Tooltip | <fig-tooltip> | Hover/click tooltip | | Separator | <fig-separator> / <fig-menu-separator> | Visual divider with an optional label | | Menu | <fig-menu> | Triggered menu with keyboard navigation | | Header | <fig-header> | Section header | | Layer | <fig-layer> | Core-registered collapsible layer list item; styled by fig-layer.css | | Preview | <fig-preview> | Thin visual preview layer | | Media | <fig-media> | Shared media host for image/video | | Image | <fig-image> | Image display/upload | | Card | <fig-card> | Media card with label, link, and selection chrome | | Video | <fig-video> | Video display/upload with playback controls | | Avatar | <fig-avatar> | Profile image or initials | | Icon | <fig-icon> | Masked icon from design tokens | | Spinner | <fig-spinner> | Loading spinner | | Shimmer | <fig-shimmer> | Shimmer loading placeholder | | Skeleton | <fig-skeleton> | Skeleton loading placeholder |


Form Controls

Button

<fig-button> — demo

| Attribute | Type | Default | Description | |---|---|---|---| | variant | string | "primary" | "primary", "secondary", "property", "destructive", "destructiveSecondary", "destructiveGhost", "destructiveLink", "ghost", "link" | | type | string | "button" | "button", "toggle", "submit", "select", "upload" | | size | string | — | "large" | | selected | boolean | false | Selected state (toggle type) | | disabled | boolean | false | Disabled state | | icon | boolean | "compact" | false | Icon-only styling; "compact" content-sizes the button with no inline padding | | pill | boolean | false | Fully rounded button shape | | align | string | "center" | Content alignment: "start", "center", or "end" | | href | string | — | URL for link buttons | | target | string | — | Link target (e.g. "_blank") |

<fig-button>Primary</fig-button>
<fig-button variant="secondary">Secondary</fig-button>
<fig-button variant="destructive">Delete</fig-button>
<fig-button variant="destructiveSecondary">Destructive secondary</fig-button>
<fig-button variant="destructiveGhost">Destructive ghost</fig-button>
<fig-button variant="destructiveLink">Destructive link</fig-button>
<fig-button pill>Pill</fig-button>
<fig-button full align="start">Start aligned</fig-button>
<fig-button variant="property">
  <fig-icon name="settings" slot="prepend"></fig-icon>
  <span slot="label">Effects</span>
</fig-button>
<fig-button type="toggle" selected="true">Toggle</fig-button>
<fig-button variant="ghost" icon>
  <svg><!-- icon --></svg>
</fig-button>

Wrap labels that may truncate in an authored slot="label" element. A direct <label> child receives the same truncation styles without FigUI adding a slot or otherwise mutating the authored DOM. Raw text remains supported but cannot reliably render an ellipsis inside the button's flex layout.

type="select" and type="upload" are visual wrappers for native select/file controls. They avoid nested native buttons, show the shared focus outline on the wrapper, and open the native picker from keyboard activation where supported.

variant="property" shares the secondary visual treatment and adds the full-width, start-aligned property-trigger layout. Author a leading icon with slot="prepend". The consumer owns any corresponding popup or dialog and can use selected, aria-haspopup, aria-expanded, and aria-controls on the button.


Play Button

<fig-button-play> embeds a secondary, pill-shaped icon fig-button and switches between the shared play and pause icons. Without progress, it runs an internal timer and preserves elapsed time across pause/resume. Authoring progress switches it to externally controlled mode.

| Attribute | Type | Default | Description | |---|---|---|---| | playing | boolean | false | Current play/pause state | | duration | number | 5 | Internal timer duration in seconds | | progress | number | — | Controlled progress from 0 to 1 | | variant | string | "secondary" | Forwarded to the embedded fig-button | | size | string | — | Forwarded button size: "large" | | disabled | boolean | false | Disables interaction and pauses the timer |

<fig-button-play duration="8"></fig-button-play>
<fig-button-play progress="0.4" playing></fig-button-play>

Methods: play(), pause(), toggle(), and reset(). User interaction emits bubbling play and pause events. The internal timer emits complete at the end.


Dropdown

<fig-dropdown> — demo

| Attribute | Type | Default | Description | |---|---|---|---| | value | string | — | Selected value | | type | string | "select" | "select" or "dropdown" | | label | string | — | Accessible label for the generated native <select> | | variant | string | — | "ghost" for a borderless control with secondary hover fill | | size | string | — | "large" for a 32px-tall control | | disabled | boolean | false | Disabled state |

<fig-dropdown value="2" size="large">
  <option value="1">Option 1</option>
  <option value="2">Option 2</option>
</fig-dropdown>

Keyboard activation follows the native select pattern. Enter opens the closed picker.


Select

<fig-select> — demo

Custom listbox select with overflow chevrons, grouped options, and sticky separators. Import fig-editor.js and fig-editor.css. Prefer this over fig-dropdown for Figma-style menus.

| Attribute | Type | Default | Description | |---|---|---|---| | value | string | — | Selected option value | | label | string | — | Closed-state / accessible label | | options | string | — | Comma, newline, or JSON options if no authored fig-select-option children | | menu-anchor | CSS selector | — | Alternate element to align the open menu against | | variant | string | — | "primary" for brand emphasis, "ghost" for a borderless control, or "input" for input-style fill and interaction states | | size | string | — | "large" for a 32px-tall trigger | | icon | boolean | false | Render a square chevron-only trigger; provide aria-label | | subtle | boolean | false | Use the secondary hover/focus fill for every option | | full | boolean | false | Stretch to available width | | position | string | — | Omit to overlay the selected option on the trigger; set bottom left, bottom right, top left, top right, bottom center, or top center to place the menu like a popup | | disabled | boolean | false | Disabled state |

Author options in <fig-select-options>, or pass options. Add subtle to one <fig-select-option> for the secondary hover/focus fill, or to <fig-select> to apply it to every option. Use label on <fig-select-option> when the option content is rich. fig-separator with sticky pins group labels while scrolling.

<fig-select value="center" label="Align" size="large">
  <fig-select-options>
    <fig-select-option value="left">Left</fig-select-option>
    <fig-select-option value="center">Center</fig-select-option>
    <fig-select-option value="right">Right</fig-select-option>
  </fig-select-options>
</fig-select>

Set menu-anchor to a selector, or assign an element to the menuAnchor property. The menu matches the anchor width and centers its selected row over the anchor. If the anchor is narrower than the menu’s usable minimum, the wider menu is centered over it in the default overlay mode. Removing the anchor restores trigger-text alignment. An explicit position keeps the anchor-derived width while applying normal popup placement and edge alignment relative to the menu anchor.

document.querySelector("fig-select").menuAnchor =
  document.querySelector("#menu-anchor");

Events: input, change, optionhover (detail is the hovered option value), optionfocus (detail is the keyboard-focused option value while the menu is open).

Methods: focus(options) focuses the trigger. activate(options) focuses the trigger and opens the menu; disabled selects remain closed.


Split Input

<fig-split-input> — demo

| Attribute | Type | Default | Description | |---|---|---|---| | type | text | number | text | Main input control | | options | string | — | Comma-separated suggestion list | | placeholder | string | — | Placeholder text | | value | string | — | Current value | | disabled | boolean | false | Disabled state | | full | boolean | false | Expand to the available width |

<fig-split-input options="House, Apartment, Condo" placeholder="Residence type"></fig-split-input>
<fig-split-input type="number" options="8, 16, 24, 32" value="16"></fig-split-input>

<fig-combo-input> remains available as a legacy alias. The suggestion trigger uses fig-select when fig-editor.js is registered and falls back to core fig-dropdown. Typed values that exactly match an option select and check it; unmatched values clear the option selection.


Checkbox

<fig-checkbox> — demo

| Attribute | Type | Default | Description | |---|---|---|---| | checked | boolean | false | Whether checked | | indeterminate | boolean | false | Indeterminate state | | disabled | boolean | false | Disabled state | | name | string | — | Form field name | | value | string | — | Value when checked | | label | string | — | Label text (alternative to slotted content) |

<fig-checkbox>Accept terms</fig-checkbox>
<fig-checkbox checked>Selected</fig-checkbox>
<fig-checkbox indeterminate>Parent option</fig-checkbox>

Radio

<fig-radio> — demo

| Attribute | Type | Default | Description | |---|---|---|---| | checked | boolean | false | Whether selected | | disabled | boolean | false | Disabled state | | name | string | — | Radio group name | | value | string | — | Value when selected |

<fig-radio name="size" value="small">Small</fig-radio>
<fig-radio name="size" value="medium" checked>Medium</fig-radio>
<fig-radio name="size" value="large">Large</fig-radio>

Switch

<fig-switch> — demo

| Attribute | Type | Default | Description | |---|---|---|---| | checked | boolean | false | Whether on | | disabled | boolean | false | Disabled state | | name | string | — | Form field name | | value | string | — | Value when on |

<fig-switch>Enable notifications</fig-switch>
<fig-switch checked>Active feature</fig-switch>

Checkboxes, radios, and switches expose focus(options) and activate(). activate() uses the native input behavior, including its disabled state and normal input / change events.


Inputs

Slider

<fig-slider> — demo

| Attribute | Type | Default | Description | |---|---|---|---| | type | string | "range" | "range", "hue", "opacity", "delta", "stepper" | | value | number | midpoint for type="range" | Current value | | min | number | 0 | Minimum | | max | number | 100 | Maximum | | step | number | 1 | Step increment | | default | number | — | Explicit reference value; adds a tick and native snap target when valid | | text | boolean | true | Show text input; set text="false" to hide | | placeholder | string | "##" | Text input placeholder | | units | string | — | Unit label (e.g. "%", "px") | | transform | number | — | Display value multiplier | | color | string | — | Track color (opacity type) | | variant | string | — | Use "classic" to opt into the previous slider appearance | | precision | number | — | Decimal places for output | | disabled | boolean | false | Disabled state |

Events: input (continuous), change (on release), with detail { value, angle, units }. Event values are rounded to precision; the component retains its higher-precision internal value.

<fig-slider min="0" max="100" value="50" default="25" units="%"></fig-slider>
<fig-slider type="hue" value="180" text="false"></fig-slider>
<fig-slider type="opacity" value="75" color="#FF5733" units="%"></fig-slider>

For type="range", omitting value follows native range behavior and starts at the midpoint of min and max. An explicitly authored, in-range, step-aligned default renders a tick and is passed to the native range input as a snap target; internally inferred defaults do not. Arrow keys move by step; hold Shift to move by a larger step.


Audio

<fig-audio>

An audio player that composes fig-audio-waveform with the shared fig-media-controls. The waveform progress and playback controls stay synchronized with an internal native audio element.

| Attribute | Type | Default | Description | |---|---|---|---| | src | string | — | Audio URL used for playback and waveform generation | | variant | bars | ribbon | bars | Forwarded to the generated or authored waveform | | autoplay | boolean | false | Start playback automatically when allowed by the browser | | controls | boolean | false | Show generated playback controls | | muted | boolean | false | Mute audio playback | | loop | boolean | false | Restart playback automatically when it ends |

Authored direct fig-audio-waveform and fig-media-controls children are preserved and synchronized. The audioEl property exposes the native audio element; play(), pause(), and toggle() control playback.

<fig-audio src="track.mp3" controls></fig-audio>
<fig-audio src="ambience.wav" variant="ribbon" autoplay muted loop></fig-audio>

Audio Waveform

<fig-audio-waveform>

A responsive waveform generated from an audio URL. Included in fig.js and fig.css.

| Attribute | Type | Default | Description | |---|---|---|---| | url | string | — | CORS-enabled audio URL to fetch, decode, and render | | variant | bars | ribbon | bars | Render rounded bars or a smooth mirrored ribbon | | progress | number | 0 | Completed fraction from 0 to 1; values are clamped | | polarization | number | 1.5 | Waveform contrast factor around half-height (1 is neutral) | | full | boolean | false | Fill the available width |

Set --fig-audio-waveform-stroke-width (default 1px) to control waveform bar thickness and the ribbon's minimum thickness. The responsive waveform targets one sample per 3px. URL fetch or decode failures render a quiet flat waveform fallback.

<fig-audio-waveform
  url="https://example.com/audio.wav"
  variant="ribbon"
  progress="0.42"
></fig-audio-waveform>

Input Slider

<fig-input-slider> and variant elements

Experimental standalone slider primitives. Import fig-input-slider.js and fig-input-slider.css directly, or use the fig-lab bundle.

<fig-input-slider value="50" default="50"></fig-input-slider>
<fig-input-slider value="50">
  <fig-input-number value="50" units="%"></fig-input-number>
</fig-input-slider>
<fig-input-slider-hue
  value="180"
  color="#336699"
  color-space="oklch">
</fig-input-slider-hue>
<fig-input-slider-opacity color="#0D99FF" value="75"></fig-input-slider-opacity>
<fig-input-slider-delta value="0" default="0"></fig-input-slider-delta>
<fig-input-slider-stepper value="50"></fig-input-slider-stepper>
<fig-input-slider-wheel value="0" step="1"></fig-input-slider-wheel>

All variants support name, value, default, min, max, step, precision, ghost, and disabled. Hue and opacity also support color. Hue supports color-space="srgb|srgb-linear|display-p3|oklab|oklch|hsl"; it defaults to srgb, and oklch/hsl use shorter-hue interpolation. The base slider supports multiple handles with JSON arrays such as value="[20,80]".

An authored direct-child <fig-input-number> is preserved and synchronized with a single slider value in both directions. Its own attributes configure its display; slider attributes are not forwarded. The number input is hidden while the slider has multiple values.

Use occlusion-targets with a CSS selector list to fade handles beneath matching elements in the slider’s parent scope. Parent matches, siblings, and children are supported. Assign an array of elements to occlusionTargets for additional programmatic targets; the getter returns a defensive copy. Attribute, programmatic, and automatic targets are additive. A direct number child is automatic, as is the label of a containing fig-property[activation="row"].

Set --fig-input-slider-handle-occlusion-target-overlap-opacity (default 0) for the fully occluded opacity and --fig-input-slider-handle-occlusion-target-overlap-fade-threshold (default var(--spacer-2)) for the distance where fading begins.

Events: bubbling, composed input and change with { control, name?, value, handleIndex }. Double-click resets to the default. The wheel variant also provides spinTo(), beginScrub(), updateScrub(), and endScrub().


Input Wheel

<fig-input-wheel>

A standalone interactive SVG tick-and-handle control for scrubbing numeric values. It is experimental and requires fig-lab.js and fig-lab.css.

| Attribute | Type | Default | Description | |---|---|---|---| | value | number | 0 | Current numeric value | | step | number | 1 | Scrub increment | | spin | boolean/string | true | Keep ticks synchronized to value; set "false" to leave them stationary | | min | number | — | Inclusive lower bound; omit for no minimum | | max | number | — | Inclusive upper bound; omit for no maximum | | disabled | boolean | false | Disable interaction |

The value, min, max, and step properties mirror their attributes. aria-valuetext is numeric. spinTo(value) animates to a new value when spin is enabled. focus(), beginScrub(), updateScrub(), and endScrub() expose the interaction lifecycle for imperative integrations.

Events: numeric input while scrubbing and change on commit. Both bubble across shadow boundaries.

<fig-input-wheel></fig-input-wheel>
<fig-input-wheel value="50" min="0" max="100"></fig-input-wheel>
<fig-input-wheel value="1.5" step="0.25"></fig-input-wheel>

Input defaults and reset

Property-compatible controls expose the same reset contract: parsed default and defaultValue aliases, boolean isDefault, and resetToDefault(). Reset is a no-op while disabled or already at default; otherwise it emits the control’s normal input event followed by change.

Scalar controls author default. Checkbox and switch use default-checked. Point and rotate use default-x, default-y, and default-z where applicable. File inputs use default-url and default-filename; browser-selected local files are cleared but never restored. Without authored defaults, controls use their type fallback: numeric axes 0 (clamped), empty text/file/palette, unchecked boolean, first valid select option, #D9D9D9 color, and built-in gradient/easing values.

Text Input

<fig-input-text> — demo

| Attribute | Type | Default | Description | |---|---|---|---| | value | string | — | Input value | | default | string | "" | Default/reset value | | placeholder | string | — | Placeholder text | | type | string | "text" | "text" or "number" | | size | string | — | Set to "large" for a 32px-tall input | | disabled | boolean | false | Disabled state | | multiline | boolean | false | Use textarea | | min | number | — | Min (number type) | | max | number | — | Max (number type) | | step | number | — | Step (number type) | | transform | number | — | Display multiplier |

<fig-input-text value="Hello" placeholder="Enter text..."></fig-input-text>
<fig-input-text size="large" placeholder="Large input"></fig-input-text>
<fig-input-text multiline placeholder="Enter description..."></fig-input-text>

Number Input

<fig-input-number> — demo

| Attribute | Type | Default | Description | |---|---|---|---| | value | string | — | Numeric value | | default | number | 0 | Default/reset value, clamped to bounds | | placeholder | string | — | Placeholder text | | size | string | — | Set to "large" for a 32px-tall input | | variant | string | — | Set to "ghost" for a borderless control | | min | number | — | Minimum | | max | number | — | Maximum | | step | number | — | Step increment | | units | string | — | Unit string (e.g. "px", "%") | | units-disallow | string | "px" | Comma-separated unit disallow list (e.g. "px,rem") | | unit-position | string | "suffix" | "suffix" or "prefix" | | transform | number | — | Display multiplier | | precision | number | — | Fixed displayed decimal places; omitted values use up to two places | | steppers | boolean | true | Show spin buttons; set to "false" to hide | | tabular | boolean | false | Tabular numerals (font-variant-numeric: tabular-nums) | | disabled | boolean | false | Disabled state |

<fig-input-number value="100" units="px"></fig-input-number>
<fig-input-number size="large" value="100" units="px"></fig-input-number>
<fig-input-number variant="ghost" value="100" units="px"></fig-input-number>
<fig-input-number tabular value="100" units="px"></fig-input-number>
<fig-input-number value="50" units="%" min="0" max="100"></fig-input-number>

Input Rotate

<fig-input-rotate> — demo

An editor-bundle property button that summarizes X, Y, and Z rotation values with up to one decimal place, matching the popup fields. variant="simple" omits the prepend icon and X/Y/Z labels. Clicking it opens an anchored fig-popup containing <fig-3d-rotate fields="rotateX,rotateY,rotateZ" aspect-ratio="4/3">.

| Attribute | Type | Default | Description | |---|---|---|---| | x | number | 0 | X-axis rotation | | y | number | 0 | Y-axis rotation | | z | number | 0 | Z-axis rotation | | default-x | number | 0 | Default X-axis rotation | | default-y | number | 0 | Default Y-axis rotation | | default-z | number | 0 | Default Z-axis rotation | | units | string | "deg" | Unit suffix; "deg" and "°" display as ° | | variant | "default" | "simple" | "default" | simple omits the prepend icon and axis labels | | open | boolean | false | Open the rotation popup | | full | boolean | false | Fill the parent width |

<fig-input-rotate x="10" y="20" z="30" default-x="0" default-y="0" default-z="0"></fig-input-rotate>

Popup edits update x, y, and z and emit input and change with { x, y, z } in detail. focus(options) focuses the trigger; activate(options) focuses and clicks it to open the popup.

Requires fig-editor.js and fig-editor.css.


Input Point

<fig-input-point> — demo

An editor-bundle property button that summarizes X and Y values with up to one decimal place. Clicking it opens an anchored popup containing <fig-origin-grid fields aspect-ratio="4/3">. Popup edits reflect to the x and y attributes and emit numeric { x, y } in detail.

| Attribute | Type | Default | Description | |---|---|---|---| | x | number | 0 | Horizontal coordinate | | y | number | 0 | Vertical coordinate | | default-x | number | 0 | Default horizontal coordinate | | default-y | number | 0 | Default vertical coordinate | | units | string | — | Unit suffix displayed in the trigger | | open | boolean | false | Open the point editor popup | | disabled | boolean | false | Disable the trigger and popup editing | | full | boolean | false | Fill the parent width |

<fig-input-point x="24" y="16" default-x="0" default-y="0" units="%"></fig-input-point>

focus(options) focuses the trigger; activate(options) focuses and clicks it to open the popup.

Requires fig-editor.js and fig-editor.css.


File Input

<fig-input-file> — demo

| Attribute | Type | Default | Description | |---|---|---|---| | accepts | string | — | Native file chooser filter | | preview | "true" | "false" | "large" | false | Show compact media previews, or use large for an upload-enabled fig-image/fig-video preview | | label | string | generated | Empty-state button label; defaults to Upload audio, Upload image, or Upload file from the known file type | | upload | "icon" | — | Render an Add icon button while empty and only a Remove icon button when populated | | multiple | boolean | false | Allow multiple files | | remove | boolean | true | Show the remove button when a file is selected; set to "false" to omit it | | disabled | boolean | false | Disabled state | | variant | string | "property" | Internal button variant | | default-url | string | "" | External URL restored by resetToDefault() | | default-filename | string | "" | Filename restored by resetToDefault() |

focus(options) focuses the upload control. activate(options) triggers its native file chooser, preview action, or playback button and does nothing when disabled.

Known image and audio files use media-specific icons; unmatched files retain the upload icon. A present or "true" preview uses the compact image swatch, audio playback preview, or video icon. Audio previews show the audio icon and filename at rest, reveal play and waveform controls on hover or focus, and keep the pause control and waveform visible while playing. preview="large" renders known images and videos as upload-enabled fig-image or fig-video previews; audio and other formats retain their compact preview behavior. preview="false" disables previews. Image preview supports .png, .jpg, .jpeg, .gif, .webp, .svg, and .avif; audio playback supports .mp3, .wav, .aac, .m4a, .ogg, and .flac; video detection supports common formats including .mp4, .webm, .mov, .m4v, .avi, .mkv, .ogv, .mpeg, .mpg, and .3gp.

<fig-input-file accepts="image/*"></fig-input-file>
<fig-input-file accepts="image/*" upload="icon" label="Add image"></fig-input-file>
<fig-input-file accepts="image/*" preview></fig-input-file>
<fig-input-file accepts="video/*" preview="large"></fig-input-file>
<fig-input-file accepts="audio/*"></fig-input-file>
<fig-input-file accepts=".mp3,.opus" label="Choose audio"></fig-input-file>

Angle

<fig-angle> — demo

Instrument-style angle/rotation control with an interactive dial, text input, CSS angle units, 15-degree Shift snapping, and unbounded positive/negative winding by default. Degree units display as ° in the number field. Accepts unit suffixes in text input (90°, 90deg, 3.14rad, 0.5turn, 100grad). Add min and/or max to clamp the value. Changing units preserves the physical angle and converts value, default, min, max, and step (for example, 90deg becomes 0.250turn). When the value differs from default, an inset reset button restores the default and emits input and change.

The rotation arrow starts at default (or zero when omitted) and sweeps along the outer dial boundary to the current angle. Positive deltas run clockwise, negative deltas run counterclockwise, and complete turns remain visible. With rotations, the number field displays the remainder modulo one turn while a signed ×N suffix preserves complete rotations. The surface receives the shared focus outline when the dial or number input is focused or dragged. Dial Arrow keys move by step, with Shift+Arrow moving by 15°. The internal number input keeps its built-in Up/Down stepping, Shift×10 stepping, and Alt-drag scrubbing. customElements.get("fig-angle").rotationIcon(angle, size) returns a standalone zero-origin SVG version for reuse elsewhere; size defaults to 48.

| Attribute | Type | Default | Description | |---|---|---|---| | value | number | 0 | Angle value | | default | number | 0 | Default/reset value, clamped to bounds | | precision | number | unit-dependent | Decimal places (0 deg/grad, 2 rad, 3 turn) | | dial | boolean | true | Show circular dial | | min | number | — | Minimum (omit for unbounded) | | max | number | — | Maximum (omit for unbounded) | | step | number | unit-dependent | Keyboard and text-input step (1 deg/°, 0.01 rad, 0.001 turn, 0.1 grad) | | units | string | "deg" | "deg" / "°", "rad", "turn", "grad" | | rotations | boolean | false | Show a signed full-rotation counter and modulo the displayed angle |

The defaultValue property returns the resolved numeric default in the active unit.

Events: input (continuous), change (on release).

<fig-angle value="90"></fig-angle>
<fig-angle value="180" default="90"></fig-angle>
<fig-angle units="rad" value="3.14159"></fig-angle>
<fig-angle units="turn" value="0.5" default="0.25"></fig-angle>
<fig-angle units="grad" value="100"></fig-angle>
<fig-angle rotations value="1080"></fig-angle>

Color & Fill

Swatch

<fig-swatch> — demo

A color/gradient/image swatch element with checkerboard background for alpha.

| Attribute | Type | Default | Description | |---|---|---|---| | background | string | — | CSS background value | | size | string | "small" | "small" or "large" | | selected | boolean | false | Selection ring | | disabled | boolean | false | Disabled state | | alpha | number | — | Opacity (0-1) |

<fig-swatch background="#FF5733"></fig-swatch>
<fig-swatch background="linear-gradient(90deg, #FF0000, #0000FF)" size="large"></fig-swatch>

Color Tip

<fig-color-tip> — demo

A compact solid-color swatch. Uses <fig-fill-picker> when the optional picker is registered, otherwise falls back to the native color input.

| Attribute | Type | Default | Description | |---|---|---|---| | value | string | — | Color string (hex/rgb/hsl/named) | | selected | boolean | false | Selected state | | disabled | boolean | false | Disabled state | | alpha | boolean | false | Show alpha controls | | control | string | — | "add" or "remove" for icon-only mode |

Events:

| Event | Detail | |---|---| | input | { color, alpha, opacity } — while editing | | change | { color, alpha, opacity } — on commit | | add | — (when control="add" is clicked) | | remove | — (when control="remove" is clicked) |

<fig-color-tip value="#FF5733"></fig-color-tip>
<fig-color-tip value="#00AAFF" alpha="true"></fig-color-tip>

Color Input

<fig-input-color> — demo

| Attribute | Type | Default | Description | |---|---|---|---| | value | string | — | Hex color (e.g. "#FF5733" or "#FF573380") | | default | string | "#D9D9D9" | Default/reset color | | text | boolean | false | Show hex text input | | alpha | boolean | true | Show alpha slider; set alpha="false" to hide opacity controls | | mode | string | — | Color mode ("hex", "rgb", "hsl") | | picker-* | string | — | Forwarded to <fig-fill-picker> when the optional picker is registered | | disabled | boolean | false | Disabled state |

Events:

| Event | Detail | |---|---| | input | { value, hex, rgba, color, alpha, opacity } | | change | { value, hex, rgba, color, alpha, opacity } |

value, hex, and rgba retain their legacy values. The additive aliases use opaque #RRGGBB for color, 0–1 for alpha, and 0–100 for opacity.

<fig-input-color value="#FF5733" text="true"></fig-input-color>

When fig-editor.js is imported, swatch activation opens <fig-fill-picker>. Without it, the native color input is used.


Input Palette

<fig-input-palette>

An editable palette of solid colors, each rendered as a <fig-input-color> swatch with add/remove support.

| Attribute | Type | Default | Description | |---|---|---|---| | value | string | — | JSON array of hex strings or {color, alpha} objects | | default | string | "[]" | Default/reset palette | | disabled | boolean | false | Disabled state | | min | number | 2 | Minimum number of colors | | max | number | 8 | Maximum (add button hidden at max) | | open | boolean | false | Expanded rows with text inputs per color | | fixed | boolean | false | Lock palette length — no add or remove (fixed or fixed="true") | | edit | "true" | "false" | "picker" | "true" | Inline editor, compact preview, or popup palette editor |

Events:

| Event | Detail | |---|---| | input | Full color array (during editing) | | change | Full color array (on commit or add) |

<fig-input-palette value='["#FF0000","#00FF00","#0000FF"]'></fig-input-palette>
<fig-input-palette edit="false" value='["#FF0000","#00FF00","#0000FF"]'></fig-input-palette>
<fig-input-palette edit="picker" value='[{"color":"#FF0000","alpha":0.5},{"color":"#00FF00","alpha":1}]'></fig-input-palette>

The editable palette is a single tab stop. Enter or Space expands inline mode or opens picker mode. activate(options) performs the same action after focusing the trigger. edit="false" renders only the compact preview. Picker mode requires fig-editor.js.

Property

<fig-property>

An editor-bundle property row. Supply one or more controls in slot="input" and optionally author slot="label", slot="leading", or slot="trailing" content. Authored label markup takes precedence over the label attribute. Set ratio="label:input" to change the default 1:2 track split, such as ratio="1:1" or ratio="2:3"; positive decimals are accepted and invalid values fall back to 1:2. The reflected ratio property supports React assignment. Override --fig-property-label-ratio, --fig-property-input-ratio, or --fig-property-label-track for lower-level CSS control. The leading="drag|chevron" and trailing="remove|add|bind|space" attributes generate common accessories; space reserves the width of an icon button without rendering one, and authored slot content takes precedence. Leading and trailing content appears on hover or focus by default. Set show-leading="false" or show-trailing="false" to hide it, or add an empty show-leading or show-trailing attribute to always show it. Add selected or selected="true" for the selected background; selected="false" leaves the row unselected. Generated trailing actions emit bubbling, composed events named remove, add, or bind with the first slotted control in detail.input. Input events bubble directly from the supplied controls. focus(options) delegates focus to the first slotted control, while activate(options) delegates to its activate() method and falls back to focus when that method is unavailable. The isDefault getter is true only when at least one resettable slotted control exists and every resettable control reports isDefault === true. Right-clicking the row opens a context menu with “Reset to default” and sets selected on the row while that menu is open. An authored selected value, including selected="false", is restored when the menu closes. The action walks the slotted controls and resets every enabled control that implements resetToDefault(). It is disabled when no control can be reset or every resettable control reports isDefault === true. Set context-menu="none" to leave the native contextmenu event untouched and disable the generated reset menu. Set activation="row" to activate from the label or unused row surface; direct input and accessory clicks keep their native behavior. Focus within the control moves the shared outline to the row and applies the selected background. Row activation ignores ratio and content-sizes slotted controls even when they have full; color, gradient, palette, and point controls use the standard compact input width.

<fig-property label="Size" ratio="1:1" leading="drag" trailing="remove">
  <fig-input-number slot="input" value="16" units="px" full></fig-input-number>
</fig-property>

Import fig-property.js and fig-property.css directly, or use the fig-editor bundle, which includes both.

Color Utilities

fig-color.js is a side-effect-free color math entry point shared by core and editor components.

import {
  figHexToOklch,
  figOklchToHex,
  figOklabDistance,
  figMapOklchToGamut,
} from "@rogieking/figui3/fig-color.js";

RGB channels use 0–255; HSL/HSV saturation, lightness, and value use 0–100; OKLab/OKLCH lightness uses 0–1, chroma is unbounded, and hue uses normalized degrees. Achromatic colors return hue 0. figHexToRGB() returns alpha and figRGBToHex() accepts optional alpha; color-space conversion otherwise leaves alpha to the caller. Converters support colorSpace: "srgb" | "display-p3", and figMapOklchToGamut() reduces chroma while preserving lightness and hue.

Palette Editor

<fig-palette-editor>

A reusable editor-bundle component for ordered color arrays. It uses <fig-reorder> for pointer and keyboard reordering and emits normalized color arrays from input and change. New colors are selected deterministically in OKLCH to remain perceptually distinct while matching the palette’s lightness and chroma. It supports value, min, max, fixed, disabled, overflow="fade|visible", and show-rows; omit max for an unlimited number of colors. Overflow defaults to a bounded list showing 6.5 rows with vertical fades. Set show-rows to change that height or use overflow="visible" to show every row. show-rows maps to --fig-palette-editor-overflow-show-rows.

<fig-palette-editor value='["#94BD00","#83AD00","#1A632A","#003905"]'></fig-palette-editor>

Gradient Editor

<fig-gradient-editor>

A reusable editor-bundle component for gradient type, direction, stop handles, and reorderable stop rows. It supports value, color-space, disabled, overflow="fade|visible", and show-rows. Stops default to a bounded list showing 6.5 rows with vertical fades; show-rows maps to --fig-gradient-editor-overflow-show-rows, and overflow="visible" shows every stop. Stop row and bar-handle selection stay synchronized and scroll the selected row into view. The first stop is selected initially. Selecting another row makes Add Stop insert midway between it and the following stop; the new stop is selected and focused. Its value property is the normalized gradient config. Bubbling input and change events include { type, gradient, css }.

<fig-gradient-editor
  value='{"type":"linear","angle":90,"stops":[{"position":0,"color":"#0D99FF","opacity":100},{"position":100,"color":"#9747FF","opacity":100}]}'
></fig-gradient-editor>

fig-fill-picker uses this component for its Gradient tab.

Gradient Popup

<dialog is="fig-popup-gradient">

A reusable fig-popup subclass that owns a <fig-gradient-editor>. It supports value, color-space, disabled, overflow, and show-rows, plus inherited popup positioning. Its bubbling input and change events include { type, gradient, css }.

<fig-button id="gradient-trigger">Edit gradient</fig-button>
<dialog
  is="fig-popup-gradient"
  anchor="#gradient-trigger"
  value='{"type":"linear","angle":90,"stops":[{"position":0,"color":"#0D99FF","opacity":100},{"position":100,"color":"#9747FF","opacity":100}]}'
  open
></dialog>

Palette Popup

<dialog is="fig-popup-palette">

A reusable fig-popup subclass that owns a <fig-palette-editor>. It supports value, min, max, fixed, and disabled, plus the standard popup positioning attributes. Its value property and bubbling input / change events use normalized { color, alpha }[] values.

<fig-button id="palette-trigger">Edit palette</fig-button>
<dialog
  is="fig-popup-palette"
  anchor="#palette-trigger"
  value='["#94BD00","#83AD00","#1A632A","#003905"]'
  open
></dialog>

Reorder

<fig-reorder>

An editor-bundle wrapper for reordering direct children with pointer or keyboard controls. Use handle for rows containing interactive controls, and items to limit which direct children participate.

<fig-reorder axis="vertical" handle=".drag-handle">
  <div><button class="drag-handle" aria-label="Reorder">Move</button>First</div>
  <div><button class="drag-handle" aria-label="Reorder">Move</button>Second</div>
</fig-reorder>

Attributes: axis, handle, items, indicator, and disabled. The bubbling reorder event includes { oldIndex, newIndex, item }.


Gradient Input

<fig-input-gradient>

A gradient editor with draggable stops. With edit="picker" and the editor bundle registered, it opens the reusable dialog[is="fig-popup-gradient"]; otherwise it renders the gradient swatch without opening a picker. activate(options) opens picker mode like a click and focuses inline mode.

| Attribute | Type | Default | Description | |---|---|---|---| | value | string | — | JSON gradient fill data | | edit | boolean/string | true | true, false, or "picker" | | mode | string | "handle" | "handle" renders color stop handles without tips; "tip" renders persistent color tips | | disabled | boolean | false | Disabled state | | picker-* | string | — | Passthrough picker attributes |

Supported interpolation spaces: srgb, srgb-linear, display-p3, oklab, oklch (with hueInterpolation: shorter, longer, increasing, decreasing).

Events:

| Event | Detail | |---|---| | input | { type, gradient } | | change | { type, gradient } |

<fig-input-gradient
  value='{"type":"gradient","gradient":{"type":"linear","angle":90,"interpolationSpace":"oklab","stops":[{"position":0,"color":"#FF0000","opacity":100},{"position":100,"color":"#0000FF","opacity":100}]}}'
></fig-input-gradient>

Fill Input

<fig-input-fill> — demo

A comprehensive fill input supporting solid, gradient, image, video, and webcam fills. Without the optional picker, it renders a passive preview.

| Attribute | Type | Default | Description | |---|---|---|---| | value | string | — | JSON fill data | | disabled | boolean | false | Disabled state | | mode | string | — | Lock to a fill mode | | alpha | boolean | true | Show alpha controls | | webcam-mode | string | live | Forwarded to the picker: live or snapshot | | default-video | string | — | Forwarded sample clip URL when Video has no file | | picker-* | string | — | Forwarded to <fig-fill-picker> when the optional picker is registered |

Add aria-label to name the generated picker, hex field, and opacity field as one fill control group.

Solid alpha is 0–1 (canonical). opacity 0–100 is also emitted for compatibility. Gradient values include css. Webcam JSON is { type, webcam } — never a live MediaStream. Read webcamStream or listen for webcamstream. Video swatches use video.poster, not the mp4 URL.

Events:

| Event | Detail | |---|---| | input | { type, color?, gradient?, image?, video?, webcam?, css } | | change | { type, color?, gradient?, image?, video?, webcam?, css } | | webcamstream | { stream, deviceId } |

<fig-input-fill value='{"type":"solid","color":"#FF5733","opacity":100}'></fig-input-fill>

Fill Picker

<fig-fill-picker> — demo

Optional full fill picker dialog supporting solid, gradient, image, video, and webcam. Import fig-editor.js and fig-editor.css to register and style it.

| Attribute | Type | Default | Description | |---|---|---|---| | value | string | — | JSON fill value | | disabled | boolean | false | Disabled state | | alpha | boolean | true | Show alpha controls | | mode | string | — | Lock to mode: "solid", "gradient", "image", "video", "webcam" | | webcam-mode | string | live | live keeps the camera after close; Capture always writes an image still | | default-video | string | — | Sample clip URL when Video is selected with no file |

Webcam JSON is { type: "webcam", webcam: { live, snapshot, deviceId, scaleMode, scale, opacity } }. The live MediaStream is webcamStream / webcamstream, not value. Closing the dialog does not stop a live camera; call releaseWebcam() or disconnect the element. Capture in live mode only updates webcam.snapshot. Video JSON includes poster; the swatch paints that, never url(file.mp4).

Events:

| Event | Detail | |---|---| | input | { type, gradient?, color?, image?, video?, webcam?, css } | | change | { type, gradient?, color?, image?, video?, webcam?, css } | | webcamstream | { stream, deviceId } |

<fig-fill-picker value='{"type":"solid","color":"#FF5733"}'>
  <fig-swatch></fig-swatch>
</fig-fill-picker>

Selection

Toolbelt

<fig-toolbelt> / <fig-toolbelt-group> / <fig-toolbelt-item>

A selectable horizontal or vertical toolbar that keeps authored items in the light DOM. Its internal part="viewport" owns scrolling and overflow fades, while generated paging buttons remain outside the masked viewport.

| Attribute | Type | Default | Description | |---|---|---|---| | value | string | — | Selected item value | | disabled | boolean | false | Disable all items | | layout | horizontal | vertical | horizontal | Item and keyboard-navigation direction | | overflow | buttons | scrollbar | scrollbar | Generated paging buttons or buttonless scrolling; scrollbars remain hidden |

fig-toolbelt-item is optional. Use it to make custom content one selectable item, or place valued fig-button controls directly inside the toolbelt, groups, tooltips, or fig-button-combo; each unwrapped button is independently selectable and keyboard-navigable. A button inside fig-toolbelt-item belongs to that wrapper and is not counted separately. A button inside fig-menu is that menu's trigger and is not counted as a tool.

Wrap related controls in fig-toolbelt-group; adjacent groups receive a direction-aware separator. Add aria-label to groups when the grouping has a meaningful name. Items and direct buttons support value, selected, and disabled. input and change bubble from the toolbelt with the selected value. ArrowLeft/ArrowRight navigate horizontal toolbelts; ArrowUp/ArrowDown navigate vertical toolbelts. Home and End move to the edges; Enter or Space selects the focused control.

Place an item, group, or custom element in slot="prepend" or slot="append" to keep it fixed outside the scrolling and faded viewport. Slotted toolbelt items remain part of selection and keyboard navigation.

Use --fig-toolbelt-gap, --fig-toolbelt-group-gap, --fig-toolbelt-group-separator-color, --fig-toolbelt-overflow-fade-size, --fig-toolbelt-padding-block, --fig-toolbelt-padding-inline, --fig-toolbelt-item-height, and --fig-toolbelt-item-padding to customize layout. The toolbelt fade defaults to calc(var(--spacer-6) + var(--spacer-2)).

<fig-toolbelt layout="horizontal" overflow="buttons" value="move" aria-label="Design tools">
  <fig-toolbelt-item slot="prepend" value="move" selected>Move</fig-toolbelt-item>
  <fig-toolbelt-group aria-label="Transform tools">
    <fig-button value="frame">Frame</fig-button>
  </fig-toolbelt-group>
  <fig-toolbelt-group aria-label="Shape tools">
    <fig-button-combo>
      <fig-button value="shape">Shape</fig-button>
      <fig-button value="shape-menu" aria-label="Shape menu">⌄</fig-button>
    </fig-button-combo>
  </fig-toolbelt-group>
  <fig-toolbelt-item slot="append" value="settings">Settings</fig-toolbelt-item>
</fig-toolbelt>

Tabs

<fig-tabs> / <fig-tab> — demo

| Attribute | Type | Default | Description | |---|---|---|---| | value | string | — | Selected tab value | | name | string | — | Tabs group identifier | | disabled | boolean | false | Disable all tabs | | overflow | string | "buttons" | "buttons" adds paging controls; "fade" uses horizontal edge fades without buttons |

Events: input, change with selected tab value.

Tabs use role="tablist" / role="tab" and roving focus. Use content="#panel-id" on each <fig-tab> to associate generated tab panels. Focus-visible tabs use the shared focus outline tokens. Overflow buttons are enabled by default. Set overflow="fade" for buttonless scrolling with fig-overflow-fade fig-overflow-fade-horizontal applied to the tabs container.

<fig-tabs value="tab1">
  <fig-tab value="tab1">General</fig-tab>
  <fig-tab value="tab2">Advanced</fig-tab>
</fig-tabs>

<fig-tabs value="tab1" overflow="fade">
  <fig-tab value="tab1">General</fig-tab>
  <fig-tab value="tab2">Advanced</fig-tab>
</fig-tabs>

Segmented Control

<fig-segmented-control> / <fig-segment> — demo

| Attribute | Type | Default | Description | |---|---|---|---| | name | string | — | Group identifier | | value | string | — | Selected segment value | | animated | boolean | false | Animate indicator transitions | | sizing | string | "equal" | "equal" or "auto" width mode | | size | string | — | Set to "large" for a 32px-tall control |

Events: input, change — detail contains the selected value.

Segmented controls expose a radio-group pattern. Arrow keys, Home, and End move selection between enabled segments and move focus to the selected segment.

<fig-segmented-control>
  <fig-segment value="left" selected="true">Left</fig-segment>
  <fig-segment value="center">Center</fig-segment>
  <fig-segment value="right">Right</fig-segment>
</fig-segmented-control>

Chooser

<fig-chooser> / <fig-choice>

A selection list controller. <fig-choice> elements are selectable options within a <fig-chooser>. When app code rebuilds a chooser by setting fig-chooser.innerHTML, the chooser restores its overflow buttons automatically. Choices remain direct light-DOM children (React-safe).

fig-chooser attributes:

| Attribute | Type | Default | Description | |---|---|---|---| | value | string | — | Selected choice value. Omit to select the first choice; value="" means none. | | choice-element | string | "fig-choice" | CSS selector for child choices | | layout | string | "vertical" | "vertical", "horizontal", "grid" | | columns | number | 2 | Grid column count when layout="grid" | | disabled | boolean | false | Disabled state | | drag | boolean | false | Enable drag-to-scroll | | overflow | string | — | Overflow behavior | | loop | boolean | false | Loop keyboard navigation | | auto-scroll | boolean | true | Automatically center the selection after selection, layout, resize, or media changes. Set to "false" to disable. | | scroll-behavior | string | "smooth" | Selection and overflow-button scrolling behavior: "smooth" or "auto". The CSS scroll-behavior property can also override it. |

fig-choice attributes:

| Attribute | Type | Default | Description | |---|---|---|---| | value | string | — | Choice identifier | | selected | boolean | false | Selected state; reflected to direct element children | | disabled | boolean | false | Disabled state |

Events (on fig-chooser): input, change — detail is the selected value string.

Selection follows the native <select> pattern: set chooser.value with a choice value, or set chooser.selectedChoice with a choice element. Neither programmatic selection nor scrolling emits events.

When auto-scroll="false", reveal the current selection explicitly with chooser.scrollSelectionIntoView(options?). It accepts native-style ScrollIntoViewOptions (behavior, block, and inline) and centers by default.

<fig-chooser value="opt1">
  <fig-choice value="opt1">Option 1</fig-choice>
  <fig-choice value="opt2">Option 2</fig-choice>
  <fig-choice value="opt3">Option 3</fig-choice>
</fig-chooser>

Spatial Controls

Joystick

<fig-joystick>

A 2D position input control with optional X/Y fields.

| Attribute | Type | Default | Description | |---|---|---|---| | value | string | "50% 50%" | Position as percentages | | precision | number | — | Decimal places | | transform | number | — | Output scaling | | fields | boolean | false | Show X/Y inputs | | coordinates | string | "screen" | "screen" (0,0 top-left) or "math" (0,0 bottom-left) | | aspect-ratio | string | "1 / 1" | Plane ratio | | axis-labels | string | — | Comma- or space-delimited labels. 1 value: top. 2 values: x y. 4 values: left right top bottom |

Events:

| Event | Detail | |---|---| | input | { x, y, value } — while dragging | | change | { x, y, value } — on release |

<fig-joystick value="50% 50%" fields="true" precision="2"></fig-joystick>

Keyboard focus lands on the internal handle. Arrow keys move the handle and keep focus on it during interaction.


Origin Grid

<fig-origin-grid>

A transform-origin grid control with a draggable handle and optional X/Y percentage fields.

| Attribute | Type | Default | Description | |---|---|---|---| | `value