VibeUI

Button Group

Required Choice

A required choice that shows its own error: while nothing is checked the root matches :not(:has(input:checked)) and the whole group turns red.

  • buttongroup
  • validation
  • required
  • css-only

Preview

1440pxHost theme

Use it with AI

  1. 1. Copy the link.
  2. 2. Write to your agent in your own words and drop the link into the sentence.
  3. 3. The agent opens the link and installs the component from the registry.

put this in the header: https://vibeui.ru/c/buttongroup-033?lang=en

Payment method

Pick a payment method — the order needs one

Show the full instructions

What the link says, spelled out. Use it when your agent cannot open links — paste this text instead.

# Install and place "buttongroup-033" (Required Choice) from VibeUI

## 1. Install first — do not skip, do not recreate
Run this exact command before writing any code:
npx shadcn@latest add https://vibeui.ru/r/buttongroup-033.json

Registry item: https://vibeui.ru/r/buttongroup-033.json
Installs to: components/vibeui/buttongroup-033.tsx (the exact path follows this project's components.json aliases).
npm dependencies: none.
Registry dependencies: none.

Install it from the registry. Do not recreate it from the description,
do not substitute a similar component from another library, and do not
rewrite it to match the project's existing style.

## 2. What it is
A required choice that shows its own error: while nothing is checked the root matches :not(:has(input:checked)) and the whole group turns red.

A required group that raises its error in pure CSS until a choice is made. Zero dependencies, one file, a server component.

## 3. How to use it
import { Buttongroup033 } from "@/components/vibeui/buttongroup-033"

<Buttongroup033
  options={["Cash", "Card", "Invoice"]}
  question="Payment method"
  error="Pick a payment method"
  errorId="pay-error"
/>

Read the installed file for the full prop list.

## 4. Where to place it
This is a small inline component. Put it exactly where the user asked,
inside the existing markup. Do not create a new page, section or
wrapper for it. If a similar control already sits in that spot,
replace it instead of adding a second one.

Placement: ___
(The user fills this line in. If it is still blank, ask where to put it
instead of guessing.)

## 5. Keep exactly as installed
- the local --vibeui-buttongroup-033-* palette — do not swap it for your theme tokens
- the absence of a preselected option: a default would submit a value nobody chose
- required on every radio — without it the form submits empty no matter how the group looks
- aria-describedby with the error text: a red border communicates nothing on its own
- the icon next to the error — colour stays a second channel, not the only one
- clear:both on the legend and the track: a floated legend otherwise makes the flex children wrap around it

## 6. You may change
- the set of options through options
- the question text through question
- the error text through error and its id through errorId
- the form field name through name and the selected accent through accent

## 7. Rules
- The error shows immediately, before any submit attempt: add a toggle class on the form if that feels aggressive.
- errorId must be unique on the page: two groups sharing an id point at someone else's text.
- Real validation still belongs on the server: the required attribute is trivially bypassed.
- Do not lift the CSS variables into globals.css: the component has to stay a single file.

## 8. Verify
- it renders with no console errors;
- it looks like the preview on the VibeUI page you copied this from;
- if it does not, you changed something listed in section 5 — put it back.

For developers

npx shadcn@latest add https://vibeui.ru/r/buttongroup-033.json
https://vibeui.ru/r/buttongroup-033.json

Компонент самодостаточен: один файл, без зависимостей, собственная палитра в переменных --vibeui-buttongroup-033-*. Серверный: ни один radio не отмечен заранее — иначе форма отправит значение, которого пользователь не выбирал. Состояние ошибки описано одним селектором [data-vibeui-block]:not(:has(input:checked)): он краснит рамки сегментов и раскрывает строку ошибки, и всё это без обработчиков. Ошибка связана с fieldset через aria-describedby и продублирована значком: цвет один её не сообщает. Legend видимый, с float:left;width:100%;clear:both — без clear следующие flex-дети обтекали бы его; звёздочка помечена aria-hidden, обязательность несут атрибуты required у input.

Component source

The same file your agent installs. Here in case you would rather copy it by hand.

import type { ComponentPropsWithoutRef, CSSProperties } from "react"

export type Buttongroup033Props = Omit<
  ComponentPropsWithoutRef<"fieldset">,
  "children"
> & {
  options?: string[]
  question?: string
  error?: string
  errorId?: string
  name?: string
  accent?: string
}

// Идея компонента: обязательный выбор, который сам показывает ошибку.
// Ни один radio не отмечен заранее — иначе форма отправит значение, которое
// пользователь не выбирал. Пока выбора нет, корень попадает под селектор
// :not(:has(input:checked)): рамка сегментов краснеет, а строка ошибки
// раскрывается. Как только вариант выбран, всё возвращается в норму, и для
// этого не нужен ни один обработчик. Ошибка связана с полем через
// aria-describedby и продублирована значком: цвет один её не сообщает.
const STYLES = `
:where([data-vibeui-block="buttongroup-033"]){
--vibeui-buttongroup-033-surface:oklch(1 0 0);
--vibeui-buttongroup-033-fg:oklch(0.25 0.016 265);
--vibeui-buttongroup-033-muted:oklch(0.56 0.014 265);
--vibeui-buttongroup-033-border:oklch(0.89 0.008 265);
--vibeui-buttongroup-033-on:oklch(0.96 0.03 265);
--vibeui-buttongroup-033-accent:oklch(0.52 0.16 265);
--vibeui-buttongroup-033-danger:oklch(0.55 0.19 27);
--vibeui-buttongroup-033-danger-soft:oklch(0.97 0.02 27);
--vibeui-buttongroup-033-radius:0.625rem;
--vibeui-buttongroup-033-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="buttongroup-033"]{
box-sizing:border-box;display:block;width:100%;max-width:24rem;
margin:0;padding:0;border:0;
background:var(--vibeui-buttongroup-033-surface);
font-family:var(--vibeui-buttongroup-033-font);
}
[data-vibeui-block="buttongroup-033"] *{box-sizing:border-box}
[data-vibeui-block="buttongroup-033"] legend{
padding:0;margin:0 0 0.5rem;float:left;width:100%;clear:both;
color:var(--vibeui-buttongroup-033-fg);
font-size:0.8125rem;font-weight:650;line-height:1.35;
}
[data-vibeui-block="buttongroup-033"] [data-part="required"]{
color:var(--vibeui-buttongroup-033-danger);margin-inline-start:0.125rem;
}
[data-vibeui-block="buttongroup-033"] [data-part="track"]{display:flex;clear:both;isolation:isolate}
[data-vibeui-block="buttongroup-033"] [data-part="segment"]{
position:relative;z-index:0;flex:1 1 0;min-width:0;
display:inline-flex;align-items:center;justify-content:center;
height:2.375rem;padding:0 0.625rem;margin-inline-start:-1px;
border:1px solid var(--vibeui-buttongroup-033-border);
background:var(--vibeui-buttongroup-033-surface);
color:var(--vibeui-buttongroup-033-muted);
font-size:0.8125rem;font-weight:600;line-height:1;white-space:nowrap;cursor:pointer;
transition:background-color .16s ease,color .16s ease,border-color .16s ease;
}
[data-vibeui-block="buttongroup-033"] [data-part="segment"]:first-child{
margin-inline-start:0;
border-start-start-radius:var(--vibeui-buttongroup-033-radius);
border-end-start-radius:var(--vibeui-buttongroup-033-radius);
}
[data-vibeui-block="buttongroup-033"] [data-part="segment"]:last-child{
border-start-end-radius:var(--vibeui-buttongroup-033-radius);
border-end-end-radius:var(--vibeui-buttongroup-033-radius);
}
[data-vibeui-block="buttongroup-033"] input{
position:absolute;inset:0;width:100%;height:100%;margin:0;opacity:0;cursor:pointer;
}
[data-vibeui-block="buttongroup-033"] [data-part="segment"]:has(input:checked){
z-index:1;
background:var(--vibeui-buttongroup-033-on);
border-color:var(--vibeui-buttongroup-033-accent);
color:var(--vibeui-buttongroup-033-accent);
}
[data-vibeui-block="buttongroup-033"] [data-part="segment"]:has(input:focus-visible){
z-index:2;outline:2px solid var(--vibeui-buttongroup-033-accent);outline-offset:1px;
}
/* Пока не выбрано ничего — группа в состоянии ошибки. Без JS. */
[data-vibeui-block="buttongroup-033"]:not(:has(input:checked)) [data-part="segment"]{
border-color:var(--vibeui-buttongroup-033-danger);
background:var(--vibeui-buttongroup-033-danger-soft);
}
[data-vibeui-block="buttongroup-033"] [data-part="error"]{
display:none;align-items:flex-start;gap:0.375rem;
margin:0.4375rem 0 0;
color:var(--vibeui-buttongroup-033-danger);
font-size:0.75rem;line-height:1.4;
}
[data-vibeui-block="buttongroup-033"]:not(:has(input:checked)) [data-part="error"]{display:flex}
[data-vibeui-block="buttongroup-033"] [data-part="error"] svg{
width:0.9375rem;height:0.9375rem;flex:none;margin-top:0.0625rem;
stroke:currentColor;fill:none;stroke-width:2;stroke-linecap:round;
}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="buttongroup-033"] *{animation:none!important;transition:none!important}}
`

const DEFAULT_OPTIONS = ["Наличными", "Картой", "По счёту"]

/**
 * Обязательный выбор, показывающий ошибку одним CSS, пока ничего не выбрано.
 * Один файл, ноль зависимостей, собственная палитра.
 */
export function Buttongroup033({
  options = DEFAULT_OPTIONS,
  question = "Способ оплаты",
  error = "Выберите способ оплаты — без него заказ не оформить",
  errorId = "buttongroup-033-error",
  name = "buttongroup-033",
  accent,
  className,
  style,
  ...props
}: Buttongroup033Props) {
  const palette = {
    ...(accent ? { "--vibeui-buttongroup-033-accent": accent } : null),
    ...style,
  } as CSSProperties

  return (
    <>
      <style href="vibeui-buttongroup-033" precedence="medium">
        {STYLES}
      </style>
      <fieldset
        {...props}
        data-vibeui-block="buttongroup-033"
        className={className}
        style={palette}
        aria-describedby={errorId}
      >
        <legend>
          {question}
          <span data-part="required" aria-hidden="true">
            *
          </span>
        </legend>
        <div data-part="track">
          {options.map((option) => (
            <label key={option} data-part="segment">
              <input type="radio" name={name} value={option} required />
              <span>{option}</span>
            </label>
          ))}
        </div>
        <p data-part="error" id={errorId}>
          <svg viewBox="0 0 24 24" aria-hidden="true">
            <path d="M12 4v10M12 18h.01" />
          </svg>
          <span>{error}</span>
        </p>
      </fieldset>
    </>
  )
}