Toggle

Hinted Toggle

Toggle с подсказкой о текущем состоянии: она привязана через aria-describedby и всплывает и по наведению, и по фокусу, а подпись кнопки не меняется.

  • toggle
  • tooltip
  • aria-describedby
  • hint

Превью

1440pxHost theme

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

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

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

Сейчас уведомления скрыты до утра

Подсказка объясняет состояние, а подпись кнопки не меняется.

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

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

# Установка и размещение «toggle-008» (Hinted Toggle) из VibeUI

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

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

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

## 2. Что это
Toggle с подсказкой о текущем состоянии: она привязана через aria-describedby и всплывает и по наведению, и по фокусу, а подпись кнопки не меняется.

Toggle с подсказкой о текущем состоянии: она в разметке, привязана aria-describedby и всплывает по наведению и по фокусу. Один файл, ноль зависимостей.

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

<Toggle008
  label="Не беспокоить"
  onHint="Сейчас уведомления скрыты до утра"
  offHint="Сейчас уведомления приходят как обычно"
/>

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

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

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

## 5. Сохранить как установлено
- локальную палитру --vibeui-toggle-008-* и не подменять её токенами вашей темы
- aria-describedby на подсказку: без него текст видит только курсор
- показ подсказки и по :hover, и по :focus-visible — клавиатура не должна остаться без неё
- постоянную подпись кнопки: имя элемента не меняется вместе с состоянием
- запас сверху у панели: подсказка всплывает над кнопкой и не должна обрезаться
- собственную светлую подложку панели: тёмный текст обязан нести свой фон

## 6. Можно менять
- подпись кнопки через label
- текст подсказки в нажатом состоянии через onHint
- текст подсказки в отжатом состоянии через offHint
- начальное состояние через defaultPressed

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

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

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

npx shadcn@latest add https://vibeui.ru/r/toggle-008.json
https://vibeui.ru/r/toggle-008.json

Один файл, ноль зависимостей, палитра --vibeui-toggle-008-*. Клиентский: useState и useId для связи aria-describedby. Подсказка — обычный элемент разметки с role="tooltip", спрятанный видимостью и прозрачностью; показывается правилами button:hover + [data-part="tip"] и button:focus-visible + [data-part="tip"], поэтому доступна и мыши, и клавиатуре. Атрибут title тут не подошёл бы: браузер не показывает его по фокусу. Подпись кнопки постоянна, состояние несут aria-pressed и текст подсказки; сверху у панели есть запас на всплывающий слой.

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

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

"use client"

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

export type Toggle008Props = Omit<
  ComponentPropsWithoutRef<"div">,
  "children" | "onChange"
> & {
  label?: string
  onHint?: string
  offHint?: string
  defaultPressed?: boolean
  onChange?: (pressed: boolean) => void
  accent?: string
}

// Идея компонента: toggle с подсказкой о текущем состоянии. Подсказка живёт
// в разметке всегда и привязана через aria-describedby, поэтому её слышит
// скринридер, а не только видит курсор. Всплывает она и по наведению, и по
// фокусу: подсказка, доступная одной мыши, — это подсказка для половины людей.
const STYLES = `
:where([data-vibeui-block="toggle-008"]){
--vibeui-toggle-008-bg:oklch(1 0 0);
--vibeui-toggle-008-fg:oklch(0.22 0.014 265);
--vibeui-toggle-008-muted:oklch(0.55 0.014 265);
--vibeui-toggle-008-border:oklch(0.9 0.006 265);
--vibeui-toggle-008-accent:oklch(0.55 0.16 25);
--vibeui-toggle-008-tip:oklch(0.24 0.02 265);
--vibeui-toggle-008-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="toggle-008"]{
box-sizing:border-box;display:flex;flex-direction:column;gap:0.5rem;align-items:flex-start;
width:100%;max-width:20rem;padding:2.75rem 0.875rem 0.875rem;
border:1px solid var(--vibeui-toggle-008-border);border-radius:0.875rem;
background:var(--vibeui-toggle-008-bg);color:var(--vibeui-toggle-008-fg);
font-family:var(--vibeui-toggle-008-font);
}
[data-vibeui-block="toggle-008"] *{box-sizing:border-box}
[data-vibeui-block="toggle-008"] [data-part="anchor"]{position:relative;display:inline-flex}
[data-vibeui-block="toggle-008"] button{
appearance:none;cursor:pointer;font:inherit;
display:inline-flex;align-items:center;gap:0.5rem;
height:2.25rem;padding:0 0.875rem;
border:1px solid var(--vibeui-toggle-008-border);border-radius:0.625rem;
background:var(--vibeui-toggle-008-bg);color:var(--vibeui-toggle-008-fg);
font-size:0.875rem;font-weight:600;line-height:1;
transition:background-color .16s ease,border-color .16s ease,color .16s ease;
}
[data-vibeui-block="toggle-008"] button:focus-visible{
outline:2px solid var(--vibeui-toggle-008-accent);outline-offset:2px;
}
[data-vibeui-block="toggle-008"] button[aria-pressed="true"]{
background:var(--vibeui-toggle-008-accent);border-color:var(--vibeui-toggle-008-accent);
color:oklch(0.99 0 0);
}
[data-vibeui-block="toggle-008"] [data-part="dot"]{
width:0.5rem;height:0.5rem;border-radius:50%;flex:none;
background:var(--vibeui-toggle-008-muted);
}
[data-vibeui-block="toggle-008"] button[aria-pressed="true"] [data-part="dot"]{background:oklch(0.99 0 0)}
/* Подсказка лежит в потоке разметки и просто прячется: вынести её в title
   значило бы отдать текст браузеру — с клавиатуры он не показывается. */
[data-vibeui-block="toggle-008"] [data-part="tip"]{
position:absolute;bottom:calc(100% + 0.5rem);left:0;
max-width:15rem;padding:0.375rem 0.5rem;border-radius:0.5rem;
background:var(--vibeui-toggle-008-tip);color:oklch(0.98 0 0);
font-size:0.75rem;line-height:1.35;white-space:normal;
opacity:0;visibility:hidden;transform:translateY(0.25rem);
transition:opacity .14s ease,transform .14s ease,visibility .14s;
}
[data-vibeui-block="toggle-008"] [data-part="tip"]::after{
content:"";position:absolute;top:100%;left:0.875rem;
border:0.3125rem solid transparent;border-top-color:var(--vibeui-toggle-008-tip);
}
[data-vibeui-block="toggle-008"] button:hover + [data-part="tip"],
[data-vibeui-block="toggle-008"] button:focus-visible + [data-part="tip"]{
opacity:1;visibility:visible;transform:translateY(0);
}
[data-vibeui-block="toggle-008"] [data-part="note"]{
margin:0;font-size:0.75rem;line-height:1.4;color:var(--vibeui-toggle-008-muted);
}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="toggle-008"] *{animation:none!important;transition:none!important}}
`

/**
 * Toggle с подсказкой о текущем состоянии: она привязана через
 * aria-describedby и всплывает по наведению и по фокусу. Один файл.
 */
export function Toggle008({
  label = "Не беспокоить",
  onHint = "Сейчас уведомления скрыты до утра",
  offHint = "Сейчас уведомления приходят как обычно",
  defaultPressed = true,
  onChange,
  accent,
  className,
  style,
  ...props
}: Toggle008Props) {
  const [pressed, setPressed] = useState(defaultPressed)
  const tipId = useId()

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

  return (
    <>
      <style href="vibeui-toggle-008" precedence="medium">
        {STYLES}
      </style>
      <div
        {...props}
        data-vibeui-block="toggle-008"
        className={className}
        style={palette}
      >
        <span data-part="anchor">
          <button
            type="button"
            aria-pressed={pressed}
            aria-describedby={tipId}
            onClick={() => {
              setPressed(!pressed)
              onChange?.(!pressed)
            }}
          >
            <span data-part="dot" aria-hidden="true" />
            {label}
          </button>
          <span data-part="tip" id={tipId} role="tooltip">
            {pressed ? onHint : offHint}
          </span>
        </span>
        <p data-part="note">
          Подсказка объясняет состояние, а подпись кнопки не меняется.
        </p>
      </div>
    </>
  )
}