Toggle
Hinted Toggle
Toggle с подсказкой о текущем состоянии: она привязана через aria-describedby и всплывает и по наведению, и по фокусу, а подпись кнопки не меняется.
- toggle
- tooltip
- aria-describedby
- hint
Превью
Использовать с AI
- 1. Скопируйте ссылку.
- 2. Напишите агенту своими словами и вставьте её в предложение.
- 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.jsonhttps://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>
</>
)
}