API
Radio
Native radio buttons and radio groups, restyled.
Installation
pnpm dlx zazz-ui add radionpx zazz-ui add radioyarn dlx zazz-ui add radiobunx zazz-ui add radioAlso 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
<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
| Attribute | Kind | Values | Notes |
|---|---|---|---|
data-ui="radio-group" | Identity | free value | Identity token in data-ui. |
data-ui="radio" | Identity | free value | Identity 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.
| Hook | Default | State |
|---|---|---|
--ui-radio-bg | var(--ui-field-bg) | — |
--ui-radio-bg--checked | var(--color-primary) | checked |
--ui-radio-border-color | var(--ui-field-border-color) | — |
--ui-radio-border-color--checked | var(--ui-field-border-color--hover) | checked |
--ui-radio-border-color--hover | var(--ui-field-border-color--hover) | hover |
--ui-radio-border-style | var(--ui-field-border-style) | — |
--ui-radio-border-width | var(--ui-field-border-width) | — |
--ui-radio-corner-shape | round | — |
--ui-radio-dot-color | var(--color-primary-foreground) | — |
--ui-radio-dot-mask | radial-gradient( circle calc(var(--ui-radio-dot-size) / 4), #000 calc(100% - 0.5px), #0000 calc(100% + 0.5px) ) | — |
--ui-radio-dot-size | calc(var(--ui-radio-size) * 0.85) | — |
--ui-radio-radius | var(--radius-full) | — |
--ui-radio-size | calc(var(--spacing) * 4.5) | — |