Skip to main content
astrocraft-ui/ components · 101

Radio

Free · MIT

Headless, accessible, and styled entirely through the attribute surface below — bring your own CSS system, or start from the reference theme.

Install

Without a flag you get no styling at all — plain HTML carrying the attribute surface below. --theme copies the same theme in two dialects;--bridge lumos re-points either one onto Lumos for Astro's tokens (it needs a theme to re-point, and Lumos itself, already in your project).

Unstyled — behavior only, you write the CSS

Install command
npx astrocraft-ui add forms/radio

Plain-CSS theme — no build step

Install command
npx astrocraft-ui add forms/radio --theme css

Tailwind theme — needs Tailwind v4

Install command
npx astrocraft-ui add forms/radio --theme tailwind

Plain-CSS theme, re-pointed onto Lumos tokens

Install command
npx astrocraft-ui add forms/radio --theme css --bridge lumos

Tailwind theme, re-pointed onto Lumos tokens

Install command
npx astrocraft-ui add forms/radio --theme tailwind --bridge lumos

Live demo

Checkbox, Radio & Switch

Checkbox
Radio (shared name)
Switch

Attribute surface

With no class-merging machinery, these attributes are the whole extension point. State is a data-attribute or a native attribute; visibility is the hiddenattribute. Generated from source by pnpm slots.

ComponentSlotsVariantsRuntime stateNative state
`Radio.astro``radio` `radio-dot` `radio-root`——`:checked`

Source

What the command copies — 2 files, alias-free so the copy lands standing alone. This is the whole component; there is nothing else.

src/components/ui/forms/radio/Radio.astro
---
// src/components/ui/forms/radio/Radio.astro — headless primitive (see ../../README.md).
// Native <input type=radio> followed by the dot. Group radios by sharing a `name`. Zero-JS.
//
// SIBLING ORDER IS PART OF THE CONTRACT — the input comes FIRST so a theme can write
// `[data-slot="radio"]:checked ~ [data-slot="radio-dot"]`. See Checkbox for the full note.
import type { HTMLAttributes } from "astro/types";

type Props = HTMLAttributes<"input">;

const { class: className, ...rest } = Astro.props;
---

<span data-slot="radio-root">
  <input type="radio" class={className} data-slot="radio" {...rest} />
  <span data-slot="radio-dot" aria-hidden="true"></span>
</span>
src/components/ui/forms/radio/index.ts
import Radio from "./Radio.astro";

export { Radio };
export default Radio;

What you get

The component source, copied into your project by npx astrocraft-ui add forms/radio — no package dependency, no CSS to fight. Whatever the paid blocks compose, this is it.