Skip to content

Type to search the docs, API, and blog.

↑↓ navigate↵ openesc close
  • Zazz 0.14 alpha

    API

    Radio

    Native radio buttons and radio groups, restyled.

    Installation

    Source
    pnpm dlx zazz-ui add radio
    npx zazz-ui add radio
    yarn dlx zazz-ui add radio
    bunx zazz-ui add radio

    Also adds fields, which it depends on. Run zazz-ui init first if the project has no zazz/ folder yet.

    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <!-- Paint the right theme (background, form controls, scrollbars) before CSS loads -->
    <meta name="color-scheme" content="light dark">
    <!-- Zazz styles: base layers, then fields, radio in cascade order -->
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_layers.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_variables.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_shadows.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_breakpoints.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_reset.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_typography.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_view-transitions.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/primitives/fields/fields.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/primitives/radio/radio.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_properties.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_properties-sm.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_properties-md.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_properties-lg.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_properties-xl.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_properties-2xl.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_properties-disabled.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_properties-active.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_properties-focus-visible.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_properties-focus-within.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_properties-hover.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_properties-checked.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_properties-current.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_properties-open.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_properties-stuck.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_properties-starting.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-tier-sm.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-tier-md.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-tier-lg.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-tier-xl.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-tier-2xl.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-tier-disabled.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-tier-active.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-tier-focus-visible.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-tier-focus-within.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-tier-hover.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-tier-checked.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-tier-current.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-tier-open.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-tier-stuck.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-tier-starting.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-flow.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-grid.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-spacing.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-margin.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-sizing.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-typography.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-color.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-effects.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-box.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-pseudo.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_defaults.css">
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/_utilities-sr.css">
    <!-- Import map: bare specifiers in Zazz scripts resolve to pinned, SRI-checked files -->
    <script type="importmap">
    {
      "imports": {
        "signal-polyfill": "https://cdn.jsdelivr.net/npm/signal-polyfill@0.2.2/dist/index.js"
      },
      "integrity": {
        "https://cdn.jsdelivr.net/npm/signal-polyfill@0.2.2/dist/index.js": "sha384-0OqM7OXGT6Oz1z98u/geiFn/FUyz4iWexkXHCvbIGXRRDXl6bp6IKc0j78AQ6DEK"
      }
    }
    </script>
    <!-- Polyfill: Interest Invokers (interestfor) — native in Chromium only -->
    <script type="module" src="https://cdn.jsdelivr.net/npm/invokers@2.2.2/dist/esm/production/interest.js" integrity="sha384-hR2BVNtsS7fIIMwOm+f7MY0JZfuByGhQQfevCBB6evFATKzBsTw0JzH/RxD94z2T" crossorigin="anonymous"></script>
    <!-- Zazz behavior: side-effect modules by tag; the rest via module imports -->
    <script type="module" src="https://cdn.jsdelivr.net/npm/@zazz-ui/core@0.14.2/src/base/dialog-lifecycle.js"></script>
    <!-- Theme: apply the persisted (or preferred) scheme before first paint -->
    <script>
      (() => {
        try {
          // A stored choice pins the scheme with data-theme; with no choice the
          // page follows the system scheme.
          const storedTheme = localStorage.getItem("theme");
          if (storedTheme === "dark" || storedTheme === "light") {
            document.documentElement.dataset.theme = storedTheme;
          }
        } catch {
          /* no storage access: follow the system scheme */
        }
      })();
    </script>

    A <head> that loads the base layers and radio with its dependencies from jsDelivr, pinned to 0.14.2. To load the whole kit in two requests, see the CDN install.

    Examples

    Options
    <fieldset data-ui="radio-group">
      <legend>Options</legend>
      <div
        style="
          --display: flex-col;
          --gap: 2;
        "
      >
        <label data-ui="field" data-field-orientation="horizontal">
          <input data-ui="radio" type="radio" name="radio-options-example" value="option-1" />
          <span data-field-slot="label">Option 1</span>
        </label>
        <label data-ui="field" data-field-orientation="horizontal">
          <input data-ui="radio" type="radio" name="radio-options-example" value="option-2" checked />
          <span data-field-slot="label">Option 2</span>
        </label>
        <label data-ui="field" data-field-orientation="horizontal">
          <input data-ui="radio" type="radio" name="radio-options-example" value="option-3" />
          <span data-field-slot="label">Option 3</span>
        </label>
      </div>
    </fieldset>
    /**
     * radio.css — Radio ([data-ui~="radio"] on input[type="radio"]; groups wear [data-ui~="radio-group"])
     *
     * @layer      variables, components
     * @requires   _layers.css, _variables.css, _properties.css (--_*-resolved, --_focus-shadow), fields.css (field-group layout, --ui-field-* surface/border)
     * @uses       appearance: none — custom circle + masked ::before dot when :checked
     * @uses       --_touch-min (touch screens) — the circle keeps its size; an invisible ::after
     *             centred on it is at least the touch floor square
     * @uses       corner-shape — round by default, so circles stay circles; a hook takes any shape
     * @tokens     --ui-radio-* (@layer variables)
     */
    
    @layer variables {
      :root {
        --ui-radio-size: calc(var(--spacing) * 4.5);
        --ui-radio-bg: var(--ui-field-bg);
        --ui-radio-bg--checked: var(--color-primary);
        --ui-radio-dot-color: var(--color-primary-foreground);
        --ui-radio-border-width: var(--ui-field-border-width);
        --ui-radio-border-style: var(--ui-field-border-style);
        --ui-radio-border-color: var(--ui-field-border-color);
        --ui-radio-border-color--hover: var(--ui-field-border-color--hover);
        --ui-radio-border-color--checked: var(--ui-field-border-color--hover);
        --ui-radio-radius: var(--radius-full);
        --ui-radio-corner-shape: round;
        --ui-radio-dot-size: calc(var(--ui-radio-size) * 0.85);
        /* Drawn over the whole circle, centred: the dot's diameter is half
           --ui-radio-dot-size (as the 24-unit icon it replaced drew it). A
           replacement covers the circle too, e.g. `url(star.svg) center / 50% no-repeat`. */
        --ui-radio-dot-mask: radial-gradient(
          circle calc(var(--ui-radio-dot-size) / 4),
          #000 calc(100% - 0.5px),
          #0000 calc(100% + 0.5px)
        );
      }
    }
    
    @layer ui.components {
      /* ===========================================================================
      RADIO — data-ui="radio" (+ data-ui="radio-group")
      - appearance: none redraws the circle from theme tokens; the checked dot is a
        masked ::before so it tracks --ui-radio-dot-color, not color alone.
      - Group by shared `name` inside a <fieldset>/<legend> or [data-ui~="radio-group"].
      =========================================================================== */
    
      :where([data-ui~="radio"]) {
        position: relative;
        appearance: none;
        flex-shrink: 0;
        --_size-len: var(--_size-resolved, var(--ui-radio-size));
        --_size-num: var(--_size-resolved, var(--ui-radio-size));
        inline-size: calc(var(--_size-len) + var(--_size-num) * var(--spacing));
        block-size: calc(var(--_size-len) + var(--_size-num) * var(--spacing));
        min-inline-size: var(--spacing-control-min);
        min-block-size: var(--spacing-control-min);
    
        background-color: var(--_bg-resolved, var(--ui-radio-bg));
    
        /* touch: the hit area, --_touch-min square at least; collapses to the box on a mouse */
        &::after {
          content: "";
          position: absolute;
          inset: min(0px, calc((100% - var(--_touch-min)) / 2));
        }
    
        border-width: var(--_border-width-resolved, var(--ui-radio-border-width));
        border-style: var(--_border-style-resolved, var(--ui-radio-border-style));
        border-color: var(--_border-color-resolved, var(--ui-radio-border-color));
        --_radius-len: var(--_radius-resolved, var(--ui-radio-radius));
        --_radius-num: var(--_radius-resolved, var(--ui-radio-radius));
        border-radius: calc(
          var(--_radius-len) + var(--_radius-num) * var(--spacing) * var(--radius-multiplier)
        );
        corner-shape: var(--_corner-shape-resolved, var(--ui-radio-corner-shape));
    
        /* centres the ::before dot */
        display: inline-grid;
        place-items: center;
        background-clip: border-box;
    
        cursor: pointer;
    
        /* the transparent outline keeps focus visible in forced-colors */
        --_ring-offset-width: 0px;
        --_ring-width: 0px;
        --_focus-in: max(0, -1 * sign(var(--_focus-ring-w, 1px)));
        --_focus-shadow:
          0 0 0 calc(var(--_ring-offset-width) * (1 - var(--_focus-in))) var(--ring-offset-shadow-color),
          0 0 0 calc((var(--_ring-offset-width) + var(--_ring-width)) * (1 - var(--_focus-in)))
            var(--_ring-fill, var(--ring-shadow-color)),
          inset 0 0 0 calc(var(--_ring-offset-width) * var(--_focus-in)) var(--ring-offset-shadow-color),
          inset 0 0 0 calc((var(--_ring-offset-width) + var(--_ring-width)) * var(--_focus-in))
            var(--_ring-fill, var(--ring-shadow-color));
        box-shadow: var(--_focus-shadow, 0 0 #0000), var(--_shadow-resolved, 0 0 #0000);
        outline: abs(var(--_focus-ring-w, var(--outline-width))) var(--outline-style) transparent;
        outline-offset: calc(
          var(--outline-offset) - var(--_focus-in) *
            (2 * var(--outline-offset) + abs(var(--_focus-ring-w, var(--outline-width))))
        );
    
        transition-property: border-color, background-color, color, opacity, box-shadow;
        transition-duration: var(--default-transition-duration);
        transition-timing-function: var(--default-transition-timing-function);
      }
    
      @media (hover: hover) {
        :where([data-ui~="radio"]):hover {
          border-color: var(--_border-color-resolved, var(--ui-radio-border-color--hover));
        }
      }
    
      :where([data-ui~="radio"]):focus-visible {
        --_ring-offset-width: var(--ring-offset-width);
        --_ring-width: abs(var(--_focus-ring-w, var(--ring-width)));
        outline-color: transparent;
      }
    
      :where([data-ui~="radio"]):checked {
        background-color: var(--_bg-resolved, var(--ui-radio-bg--checked));
        border-color: var(--_border-color-resolved, var(--ui-radio-border-color--checked));
        color: var(--ui-radio-dot-color);
      }
    
      /* masked ::before dot painted in currentColor; the :where() closes before
         the pseudo-element, which is invalid inside it. The pseudo and its mask
         cover the circle's whole padding box, so they snap to the pixel grid with
         it: a dot-sized box or mask tile snaps on its own and lands up to a pixel
         off centre at fractional sizes. */
      :where([data-ui~="radio"]:checked)::before {
        content: "";
        position: absolute;
        inset: 0;
        pointer-events: none;
        background-color: currentColor;
        mask: var(--ui-radio-dot-mask);
        transition-property: background-color, opacity, transform;
        transition-duration: calc(var(--default-transition-duration) * 0.75);
        transition-delay: calc(var(--default-transition-duration) * 0.25);
        transition-timing-function: var(--default-transition-timing-function);
        transform: scale(1);
        opacity: 1;
    
        @starting-style {
          transform: scale(0);
          opacity: 0;
        }
      }
    }
    
    /* An invalid control remaps the --ui-field-* family on itself. */
    @layer ui.components {
      :where([data-ui~="radio"]):disabled {
        opacity: 0.5;
        cursor: not-allowed;
      }
    }

    Attributes

    radio attributes
    AttributeKindValuesNotes
    data-ui="radio-group"Identityfree valueIdentity token in data-ui.
    data-ui="radio"Identityfree valueIdentity token in data-ui.

    Requires: fields.

    Hooks

    Set a hook on :root, on a subtree, or inline on one element. A state hook (--…--hover) themes that state only; the primitive keeps its other states.

    radio hooks
    HookDefaultState
    --ui-radio-bgvar(--ui-field-bg)—
    --ui-radio-bg--checkedvar(--color-primary)checked
    --ui-radio-border-colorvar(--ui-field-border-color)—
    --ui-radio-border-color--checkedvar(--ui-field-border-color--hover)checked
    --ui-radio-border-color--hovervar(--ui-field-border-color--hover)hover
    --ui-radio-border-stylevar(--ui-field-border-style)—
    --ui-radio-border-widthvar(--ui-field-border-width)—
    --ui-radio-corner-shaperound—
    --ui-radio-dot-colorvar(--color-primary-foreground)—
    --ui-radio-dot-maskradial-gradient( circle calc(var(--ui-radio-dot-size) / 4), #000 calc(100% - 0.5px), #0000 calc(100% + 0.5px) )—
    --ui-radio-dot-sizecalc(var(--ui-radio-size) * 0.85)—
    --ui-radio-radiusvar(--radius-full)—
    --ui-radio-sizecalc(var(--spacing) * 4.5)—

    API