Checkbox

Locked Settings

Настройки, часть которых только для чтения: у заблокированной строки замок, приглушённый фон и причина прямо под подписью.

checkbox
readonly
policy
settings

Превью

1440pxHost theme

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

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

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

Безопасность аккаунтаДвухфакторный входВключено политикой организацииВыходить после 30 минут без действийРазрешить выгрузку данныхОтключено администратором пространстваОтчёт о входах раз в неделю

Строки с замком заданы политикой организации — их меняет администратор.

Название группы

Сноска

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

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

# Установка и размещение «checkbox-022» (Locked Settings) из VibeUI

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

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

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

## 2. Что это
Настройки, часть которых только для чтения: у заблокированной строки замок, приглушённый фон и причина прямо под подписью.

Список настроек, где часть строк только для чтения: замок справа, приглушённая подложка и объяснение под подписью, а внизу общая сноска про политику организации. Ноль зависимостей, один файл.

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

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

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

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

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

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

## 7. Правила
- readOnly не мешает отправке формы: значение заблокированного поля уйдёт на сервер, и его надо проверять там.
- Причина обязана быть конкретной: «недоступно» не объясняет, к кому идти.
- Если менять настройку нельзя никому и никогда, её лучше не показывать вовсе.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.

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

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

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

https://vibeui.ru/r/checkbox-022.json

Компонент самодостаточен: один файл, без зависимостей, собственная палитра в локальных переменных --vibeui-checkbox-022-*. Клиентский: "use client". Заблокированная строка помечена readOnly и aria-disabled, а не disabled: она остаётся в порядке табуляции и доступна скринридеру. Причина связана с полем через aria-describedby с идентификатором из useId. Замок нарисован корпусом и дужкой из ::before, поэтому иконочная библиотека не нужна.

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

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

"use client"

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

export type Checkbox022Option = {
  id: string
  label: string
  locked?: boolean
  reason?: string
}

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

// Идея компонента: настройки только для чтения. Заблокированная строка не
// выключается через disabled, а помечается readOnly и aria-disabled: она
// остаётся в порядке табуляции, её видит скринридер, а причина написана
// прямо под подписью — «нельзя» без объяснения читается как поломка.
const STYLES = `
:where([data-vibeui-block="checkbox-022"]){
--vibeui-checkbox-022-bg:oklch(1 0 0);
--vibeui-checkbox-022-fg:oklch(0.22 0.014 265);
--vibeui-checkbox-022-muted:oklch(0.55 0.014 265);
--vibeui-checkbox-022-border:oklch(0.9 0.006 265);
--vibeui-checkbox-022-locked:oklch(0.955 0.004 265);
--vibeui-checkbox-022-accent:oklch(0.5 0.14 265);
--vibeui-checkbox-022-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="checkbox-022"]{
display:flex;flex-direction:column;gap:0.25rem;
width:100%;max-width:23rem;box-sizing:border-box;
margin:0;padding:0.875rem;border:1px solid var(--vibeui-checkbox-022-border);border-radius:0.875rem;
background:var(--vibeui-checkbox-022-bg);
font-family:var(--vibeui-checkbox-022-font);color:var(--vibeui-checkbox-022-fg);
}
[data-vibeui-block="checkbox-022"] legend{float:left;width:100%;padding:0 0 0.375rem;font-size:0.875rem;font-weight:650}
[data-vibeui-block="checkbox-022"] [data-part="row"]{
clear:both;display:grid;grid-template-columns:auto 1fr auto;column-gap:0.625rem;row-gap:0.125rem;
padding:0.5rem;margin:0 -0.5rem;border-radius:0.625rem;
font-size:0.875rem;cursor:pointer;
}
[data-vibeui-block="checkbox-022"] [data-part="row"][data-locked="true"]{
background:var(--vibeui-checkbox-022-locked);cursor:default;
}
[data-vibeui-block="checkbox-022"] input{
appearance:none;position:relative;flex:none;cursor:pointer;margin:0.09375rem 0 0;
width:1.0625rem;height:1.0625rem;box-sizing:border-box;
border:1.5px solid var(--vibeui-checkbox-022-border);border-radius:0.3125rem;
background:var(--vibeui-checkbox-022-bg);
transition:background-color .15s ease,border-color .15s ease;
}
[data-vibeui-block="checkbox-022"] input:checked{border-color:transparent;background:var(--vibeui-checkbox-022-accent)}
[data-vibeui-block="checkbox-022"] 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 265);border-bottom:2px solid oklch(0.99 0.01 265);
transform:rotate(45deg);
}
/* Только для чтения — не то же самое, что выключено: отметка остаётся
   различимой, но приглушена, а курсор не обещает нажатие. */
[data-vibeui-block="checkbox-022"] [data-locked="true"] input{
cursor:default;opacity:.55;
}
[data-vibeui-block="checkbox-022"] input:focus-visible{outline:2px solid var(--vibeui-checkbox-022-accent);outline-offset:2px}
[data-vibeui-block="checkbox-022"] [data-part="name"]{line-height:1.35}
[data-vibeui-block="checkbox-022"] [data-locked="true"] [data-part="name"]{color:var(--vibeui-checkbox-022-muted)}
[data-vibeui-block="checkbox-022"] [data-part="why"]{
grid-column:2 / -1;font-size:0.75rem;line-height:1.4;color:var(--vibeui-checkbox-022-muted);
}
/* Замок нарисован дужкой и корпусом: без иконочной библиотеки и без
   картинки, которая не подхватит цвет темы. */
[data-vibeui-block="checkbox-022"] [data-part="lock"]{
position:relative;align-self:start;justify-self:end;
width:0.625rem;height:0.5rem;margin-top:0.3125rem;border-radius:0.125rem;
background:var(--vibeui-checkbox-022-muted);
}
[data-vibeui-block="checkbox-022"] [data-part="lock"]::before{
content:"";position:absolute;left:50%;bottom:0.4375rem;
width:0.375rem;height:0.3125rem;margin-left:-0.1875rem;box-sizing:border-box;
border:1.5px solid var(--vibeui-checkbox-022-muted);border-bottom:0;
border-radius:0.25rem 0.25rem 0 0;
}
[data-vibeui-block="checkbox-022"] [data-part="foot"]{
margin:0.5rem 0 0;padding-top:0.5rem;
border-top:1px solid var(--vibeui-checkbox-022-border);
font-size:0.75rem;line-height:1.4;color:var(--vibeui-checkbox-022-muted);
}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="checkbox-022"] *{animation:none!important;transition:none!important}}
`

const DEFAULT_OPTIONS: Checkbox022Option[] = [
  {
    id: "2fa",
    label: "Двухфакторный вход",
    locked: true,
    reason: "Включено политикой организации",
  },
  { id: "session", label: "Выходить после 30 минут без действий" },
  {
    id: "export",
    label: "Разрешить выгрузку данных",
    locked: true,
    reason: "Отключено администратором пространства",
  },
  { id: "digest", label: "Отчёт о входах раз в неделю" },
]

/**
 * Настройки, часть которых только для чтения: замок, приглушённая строка
 * и причина под подписью. Один файл, ноль зависимостей, своя палитра.
 */
export function Checkbox022({
  legend = "Безопасность аккаунта",
  options = DEFAULT_OPTIONS,
  defaultValue = ["2fa", "session"],
  footnote = "Строки с замком заданы политикой организации — их меняет администратор.",
  onChange,
  accent,
  className,
  style,
  ...props
}: Checkbox022Props) {
  const [value, setValue] = useState<string[]>(defaultValue)
  const prefix = useId()

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

  const toggle = (option: Checkbox022Option) => {
    if (option.locked) {
      return
    }

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

    setValue(next)
    onChange?.(next)
  }

  return (
    <>
      <style href="vibeui-checkbox-022" precedence="medium">
        {STYLES}
      </style>
      <fieldset
        {...props}
        data-vibeui-block="checkbox-022"
        className={className}
        style={palette}
      >
        <legend>{legend}</legend>
        {options.map((option) => {
          const reasonId = `${prefix}-${option.id}`

          return (
            <label
              key={option.id}
              data-part="row"
              data-locked={option.locked ? "true" : undefined}
            >
              <input
                type="checkbox"
                checked={value.includes(option.id)}
                readOnly={option.locked}
                aria-disabled={option.locked || undefined}
                aria-describedby={option.reason ? reasonId : undefined}
                onChange={() => toggle(option)}
              />
              <span data-part="name">{option.label}</span>
              {option.locked ? (
                <span data-part="lock" aria-hidden="true" />
              ) : null}
              {option.reason ? (
                <span data-part="why" id={reasonId}>
                  {option.reason}
                </span>
              ) : null}
            </label>
          )
        })}
        <p data-part="foot">{footnote}</p>
      </fieldset>
    </>
  )
}