VibeUI

Checkbox

Choice Limit

Группа с потолком выбора: на лимите оставшиеся пункты выключаются, а полоса и счётчик заранее показывают, сколько ещё можно отметить.

  • checkbox
  • limit
  • survey
  • group

Превью

1440pxHost theme

Использовать с AI

  1. 1. Скопируйте ссылку.
  2. 2. Напишите агенту своими словами и вставьте её в предложение.
  3. 3. Агент откроет ссылку и поставит компонент из registry.

размести это в шапке: https://vibeui.ru/c/checkbox-012

Что для вас важнее всего

1 из 3

Можно отметить ещё 2.

Показать полную инструкцию

То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.

# Установка и размещение «checkbox-012» (Choice Limit) из VibeUI

## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/checkbox-012.json

Registry item: https://vibeui.ru/r/checkbox-012.json
Ставится в: components/vibeui/checkbox-012.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.

Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.

## 2. Что это
Группа с потолком выбора: на лимите оставшиеся пункты выключаются, а полоса и счётчик заранее показывают, сколько ещё можно отметить.

Группа чекбоксов с ограничением: счётчик «2 из 3», полоса заполнения и выключение невыбранных пунктов на лимите. Запрет объясняется до нажатия, а не сообщением об ошибке после. Ноль зависимостей, один файл.

## 3. Как использовать
import { Checkbox012 } from "@/components/vibeui/checkbox-012"

<Checkbox012
  legend="Что для вас важнее всего"
  limit={3}
  options={options}
  onChange={setValue}
/>

Полный список пропсов — в установленном файле.

## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.

Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)

## 5. Сохранить как установлено
- локальную палитру --vibeui-checkbox-012-* и не подменять её токенами вашей темы
- выключение только невыбранных пунктов: снять свою галочку пользователь должен мочь всегда
- счётчик «сколько из скольких» — без него лимит выглядит поломкой
- полосу заполнения рядом со счётчиком: длину замечают раньше числа
- текст под списком, объясняющий, что делать на лимите
- оставшиеся в списке заблокированные пункты: убирать их нельзя, они снова доступны после снятия галочки

## 6. Можно менять
- массив options и стартовый defaultValue
- limit — потолок выбора
- legend — название группы
- обработчик onChange и акцент через проп accent

## 7. Правила
- Лимит меньше двух превращает группу в переключатель: там нужны radio, а не чекбоксы.
- Компонент не сообщает о попытке превысить лимит: он её просто не допускает.
- Если вариантов больше десяти, добавьте поиск — заблокированные строки в длинном списке раздражают.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.

## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.

Для разработчика

npx shadcn@latest add https://vibeui.ru/r/checkbox-012.json
https://vibeui.ru/r/checkbox-012.json

Компонент самодостаточен: один файл, без зависимостей, собственная палитра в локальных переменных --vibeui-checkbox-012-*. Клиентский: "use client". Достигнутый лимит ставит disabled только невыбранным пунктам, поэтому снять галочку можно всегда. Полоса заполнения — span с шириной в процентах (динамическое значение, класса для него нет). Текст под списком объясняет запрет словами, счётчик объявлен role="status".

Исходник компонента

Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.

"use client"

import { useState } from "react"
import type { ComponentPropsWithoutRef, CSSProperties } from "react"

export type Checkbox012Props = Omit<
  ComponentPropsWithoutRef<"fieldset">,
  "children" | "onChange"
> & {
  legend?: string
  options?: string[]
  limit?: number
  defaultValue?: string[]
  onChange?: (value: string[]) => void
  accent?: string
}

// Идея компонента: группа с потолком выбора. На лимите невыбранные пункты
// выключаются, а счётчик заранее показывает, сколько осталось, — запрет
// объясняется до нажатия, а не после него сообщением об ошибке.
const STYLES = `
:where([data-vibeui-block="checkbox-012"]){
--vibeui-checkbox-012-bg:oklch(1 0 0);
--vibeui-checkbox-012-fg:oklch(0.22 0.014 265);
--vibeui-checkbox-012-muted:oklch(0.56 0.014 265);
--vibeui-checkbox-012-border:oklch(0.9 0.006 265);
--vibeui-checkbox-012-hover:oklch(0.975 0.003 265);
--vibeui-checkbox-012-accent:oklch(0.58 0.16 35);
--vibeui-checkbox-012-track:oklch(0.93 0.006 265);
--vibeui-checkbox-012-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="checkbox-012"]{
display:flex;flex-direction:column;gap:0.125rem;
width:100%;max-width:20rem;box-sizing:border-box;
margin:0;padding:0.875rem;border:1px solid var(--vibeui-checkbox-012-border);border-radius:0.875rem;
background:var(--vibeui-checkbox-012-bg);
font-family:var(--vibeui-checkbox-012-font);color:var(--vibeui-checkbox-012-fg);
}
[data-vibeui-block="checkbox-012"] legend{float:left;width:100%;padding:0;font-size:0.875rem;font-weight:650}
[data-vibeui-block="checkbox-012"] [data-part="meter"]{
clear:both;display:flex;align-items:center;gap:0.5rem;
margin:0.375rem 0 0.5rem;font-size:0.75rem;color:var(--vibeui-checkbox-012-muted);
font-variant-numeric:tabular-nums;
}
/* Полоса заполнения — вторая, невербальная подсказка о лимите: число
   замечают не все, длину — все. */
[data-vibeui-block="checkbox-012"] [data-part="track"]{
flex:1;height:0.25rem;border-radius:9999px;overflow:hidden;
background:var(--vibeui-checkbox-012-track);
}
[data-vibeui-block="checkbox-012"] [data-part="fill"]{
display:block;height:100%;border-radius:9999px;
background:var(--vibeui-checkbox-012-accent);
transition:width .2s ease;
}
[data-vibeui-block="checkbox-012"] label{
display:flex;align-items:center;gap:0.625rem;
min-height:2.125rem;padding:0 0.5rem;margin:0 -0.5rem;border-radius:0.5rem;
font-size:0.875rem;cursor:pointer;
transition:background-color .15s ease;
}
[data-vibeui-block="checkbox-012"] label:hover{background:var(--vibeui-checkbox-012-hover)}
/* Заблокированный лимитом пункт остаётся в списке и просто гаснет: убрать
   его было бы враньём — он доступен, как только снимут другую галку. */
[data-vibeui-block="checkbox-012"] label:has(input:disabled){
cursor:not-allowed;color:var(--vibeui-checkbox-012-muted);
}
[data-vibeui-block="checkbox-012"] label:has(input:disabled):hover{background:transparent}
[data-vibeui-block="checkbox-012"] input{
appearance:none;position:relative;flex:none;cursor:inherit;
width:1.0625rem;height:1.0625rem;margin:0;box-sizing:border-box;
border:1.5px solid var(--vibeui-checkbox-012-border);border-radius:0.3125rem;
background:var(--vibeui-checkbox-012-bg);
transition:background-color .15s ease,border-color .15s ease;
}
[data-vibeui-block="checkbox-012"] input:checked{border-color:transparent;background:var(--vibeui-checkbox-012-accent)}
[data-vibeui-block="checkbox-012"] input:checked::after{
content:"";position:absolute;left:50%;top:50%;
width:0.25rem;height:0.4375rem;margin:-0.3125rem 0 0 -0.125rem;
border-right:2px solid oklch(0.99 0.01 35);border-bottom:2px solid oklch(0.99 0.01 35);
transform:rotate(45deg);
}
[data-vibeui-block="checkbox-012"] input:disabled{background:var(--vibeui-checkbox-012-track);border-color:transparent}
[data-vibeui-block="checkbox-012"] input:focus-visible{outline:2px solid var(--vibeui-checkbox-012-accent);outline-offset:2px}
[data-vibeui-block="checkbox-012"] [data-part="note"]{
margin:0.5rem 0 0;font-size:0.75rem;line-height:1.4;color:var(--vibeui-checkbox-012-muted);
}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="checkbox-012"] *{animation:none!important;transition:none!important}}
`

const DEFAULT_OPTIONS = [
  "Скорость загрузки",
  "Понятность интерфейса",
  "Поддержка",
  "Цена",
  "Надёжность",
  "Внешний вид",
]

/**
 * Группа чекбоксов с потолком выбора: на лимите остальные выключаются,
 * счётчик показывает остаток. Один файл, ноль зависимостей.
 */
export function Checkbox012({
  legend = "Что для вас важнее всего",
  options = DEFAULT_OPTIONS,
  limit = 3,
  defaultValue = ["Цена"],
  onChange,
  accent,
  className,
  style,
  ...props
}: Checkbox012Props) {
  const [value, setValue] = useState<string[]>(defaultValue)

  const palette = {
    ...(accent ? { "--vibeui-checkbox-012-accent": accent } : null),
    ...style,
  } as CSSProperties

  const full = value.length >= limit
  const left = Math.max(0, limit - value.length)

  const toggle = (option: string) => {
    const next = value.includes(option)
      ? value.filter((item) => item !== option)
      : [...value, option]

    setValue(next)
    onChange?.(next)
  }

  return (
    <>
      <style href="vibeui-checkbox-012" precedence="medium">
        {STYLES}
      </style>
      <fieldset
        {...props}
        data-vibeui-block="checkbox-012"
        className={className}
        style={palette}
      >
        <legend>{legend}</legend>
        <p data-part="meter">
          <span data-part="track">
            <span
              data-part="fill"
              style={{ width: `${(value.length / limit) * 100}%` }}
            />
          </span>
          <span role="status">
            {value.length} из {limit}
          </span>
        </p>
        {options.map((option) => {
          const checked = value.includes(option)

          return (
            <label key={option}>
              <input
                type="checkbox"
                checked={checked}
                disabled={!checked && full}
                onChange={() => toggle(option)}
              />
              <span>{option}</span>
            </label>
          )
        })}
        <p data-part="note">
          {full
            ? "Выбрано максимум. Снимите одну галочку, чтобы поставить другую."
            : `Можно отметить ещё ${left}.`}
        </p>
      </fieldset>
    </>
  )
}