Inputs
Queue Limit
Лимит-очередь вместо запертого поля: на пределе новый тег вытесняет самый старый, и кандидат на вылет подсвечен заранее.
- tags
- limit
- queue
- form
Превью
Использовать с AI
- 1. Скопируйте ссылку.
- 2. Напишите агенту своими словами и вставьте её в предложение.
- 3. Агент откроет ссылку и поставит компонент из registry.
размести это в шапке: https://vibeui.ru/c/tags-003
3 / 5
Можно добавить ещё 2. На пределе новый тег вытеснит самый старый.
Показать полную инструкцию
То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.
# Установка и размещение «tags-003» (Queue Limit) из VibeUI
## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/tags-003.json
Registry item: https://vibeui.ru/r/tags-003.json
Ставится в: components/vibeui/tags-003.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.
Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.
## 2. Что это
Лимит-очередь вместо запертого поля: на пределе новый тег вытесняет самый старый, и кандидат на вылет подсвечен заранее.
Теги с лимитом, который работает как очередь: новый вытесняет самый старый, а не блокирует ввод. Ноль зависимостей, один файл.
## 3. Как использовать
import { Tags003 } from "@/components/vibeui/tags-003"
<Tags003 label="Интересы в ленте" max={5} defaultValue={["дизайн", "интерфейсы"]} />
Полный список пропсов — в установленном файле.
## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.
Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)
## 5. Сохранить как установлено
- локальную палитру --vibeui-tags-003-* и не подменять её токенами вашей темы
- собственную светлую подложку: поле показывают поверх любого фона
- очередь вместо блокировки: заблокированное поле требует сначала догадаться, что удалить
- подсветку кандидата на вылет: вытеснение без предупреждения выглядит как потеря данных
- полосу и счётчик: заполненность лимита не должна пересчитываться глазами
- приведение тегов к нижнему регистру: иначе лимит съедят дубликаты в разных написаниях
- aria-live на подсказке: текст меняется в момент достижения лимита
## 6. Можно менять
- label — подпись поля
- max — сам лимит
- defaultValue — стартовый набор тегов
- формулировки подсказки под полем
- акцент через проп accent
## 7. Правила
- Очередь подходит не всем сценариям: там, где теги дорогие, лучше запретить добавление явным сообщением.
- Вытесняется первый в списке, а не самый редкий: приоритеты компонент не знает.
- Лимит меньше трёх делает полосу бессмысленной — оставьте один счётчик.
- Не выносите CSS-переменные в globals.css: компонент обязан остаться одним файлом.
## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.Для разработчика
npx shadcn@latest add https://vibeui.ru/r/tags-003.jsonhttps://vibeui.ru/r/tags-003.jsonКомпонент самодостаточен: один файл, ноль зависимостей, палитра в локальных переменных --vibeui-tags-003-*. Клиентский: список тегов и черновик в состоянии. На пределе поле не блокируется: новый тег добавляется, а список обрезается с конца методом slice(-max), то есть первый уходит. Пока в черновике есть текст, первый чип помечается data-doomed и перечёркивается — вытеснение обязано быть предсказуемым. Полоса заполненности и счётчик показывают лимит без пересчёта чипов глазами.
Исходник компонента
Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.
"use client"
import { useId, useState } from "react"
import type {
ComponentPropsWithoutRef,
CSSProperties,
KeyboardEvent,
} from "react"
export type Tags003Props = Omit<
ComponentPropsWithoutRef<"div">,
"children" | "defaultValue"
> & {
label?: string
max?: number
defaultValue?: string[]
accent?: string
}
// Идея компонента: лимит, который не запирает поле, а вытесняет самый старый
// тег. Заблокированный ввод на пределе — тупик: чтобы добавить нужный тег,
// приходится сначала догадаться удалить лишний. Здесь очередь: новый тег
// выталкивает первый, и тот заранее подсвечен как кандидат на вылет, поэтому
// вытеснение не становится сюрпризом. Полоса лимита показывает заполненность
// без счёта чипов глазами.
const STYLES = `
:where([data-vibeui-block="tags-003"]){
--vibeui-tags-003-surface:oklch(1 0 0);
--vibeui-tags-003-field:oklch(1 0 0);
--vibeui-tags-003-shell:oklch(0.9 0.006 265);
--vibeui-tags-003-fg:oklch(0.23 0.014 265);
--vibeui-tags-003-muted:oklch(0.55 0.014 265);
--vibeui-tags-003-border:oklch(0.88 0.008 265);
--vibeui-tags-003-chip:oklch(0.96 0.004 265);
--vibeui-tags-003-track:oklch(0.93 0.006 265);
--vibeui-tags-003-accent:oklch(0.55 0.16 300);
--vibeui-tags-003-warn:oklch(0.62 0.16 60);
--vibeui-tags-003-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
--vibeui-tags-003-fill:0%;
}
/* Своя светлая подложка: поле показывают поверх любого фона. */
[data-vibeui-block="tags-003"]{
display:flex;flex-direction:column;gap:0.5rem;
width:100%;max-width:22rem;box-sizing:border-box;padding:0.875rem;
background:var(--vibeui-tags-003-surface);
border:1px solid var(--vibeui-tags-003-shell);border-radius:0.875rem;
font-family:var(--vibeui-tags-003-font);color:var(--vibeui-tags-003-fg);
}
[data-vibeui-block="tags-003"] [data-part="head"]{
display:flex;align-items:baseline;justify-content:space-between;gap:0.75rem;margin:0;
}
[data-vibeui-block="tags-003"] label{font-size:0.8125rem;font-weight:650}
[data-vibeui-block="tags-003"] [data-part="counter"]{
font-size:0.75rem;font-weight:650;color:var(--vibeui-tags-003-muted);font-variant-numeric:tabular-nums;
}
[data-vibeui-block="tags-003"][data-full="true"] [data-part="counter"]{color:var(--vibeui-tags-003-warn)}
[data-vibeui-block="tags-003"] [data-part="field"]{
display:flex;flex-wrap:wrap;align-items:center;gap:0.375rem;
min-height:2.75rem;padding:0.3125rem 0.5rem;box-sizing:border-box;
background:var(--vibeui-tags-003-field);
border:1px solid var(--vibeui-tags-003-border);border-radius:0.625rem;
}
[data-vibeui-block="tags-003"] [data-part="field"]:focus-within{
border-color:var(--vibeui-tags-003-accent);
box-shadow:0 0 0 2px oklch(0.55 0.16 300 / 18%);
}
[data-vibeui-block="tags-003"] [data-part="chip"]{
display:inline-flex;align-items:center;gap:0.25rem;
height:1.75rem;padding:0 0.25rem 0 0.5rem;border-radius:0.4375rem;
background:var(--vibeui-tags-003-chip);
font-size:0.8125rem;
transition:background-color .14s ease,color .14s ease;
}
/* Кандидат на вылет подсвечен заранее: вытеснение не должно быть сюрпризом. */
[data-vibeui-block="tags-003"] [data-part="chip"][data-doomed="true"]{
background:oklch(0.62 0.16 60 / 16%);color:var(--vibeui-tags-003-warn);
text-decoration:line-through;
}
[data-vibeui-block="tags-003"] [data-part="chip"] button{
appearance:none;border:0;background:none;cursor:pointer;
width:1.125rem;height:1.125rem;border-radius:0.3125rem;
color:var(--vibeui-tags-003-muted);font:inherit;font-size:0.875rem;line-height:1;
}
[data-vibeui-block="tags-003"] [data-part="chip"] button:focus-visible{outline:2px solid var(--vibeui-tags-003-accent);outline-offset:1px}
[data-vibeui-block="tags-003"] input{
flex:1 1 6rem;min-width:6rem;
appearance:none;border:0;background:none;outline:none;
height:1.75rem;color:inherit;font:inherit;font-size:0.875rem;
}
/* Полоса лимита: заполненность видна без пересчёта чипов глазами. */
[data-vibeui-block="tags-003"] [data-part="bar"]{
height:0.25rem;border-radius:9999px;background:var(--vibeui-tags-003-track);overflow:hidden;
}
[data-vibeui-block="tags-003"] [data-part="fill"]{
display:block;height:100%;width:var(--vibeui-tags-003-fill);
background:var(--vibeui-tags-003-accent);
transition:width .18s ease,background-color .18s ease;
}
[data-vibeui-block="tags-003"][data-full="true"] [data-part="fill"]{background:var(--vibeui-tags-003-warn)}
[data-vibeui-block="tags-003"] [data-part="hint"]{margin:0;font-size:0.75rem;line-height:1.4;color:var(--vibeui-tags-003-muted)}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="tags-003"] *{animation:none!important;transition:none!important}}
`
/**
* Теги с лимитом-очередью: на пределе новый тег вытесняет самый старый.
* Один файл, ноль зависимостей, собственная палитра.
*/
export function Tags003({
label = "Интересы в ленте",
max = 5,
defaultValue = ["дизайн", "типографика", "интерфейсы"],
accent,
className,
style,
...props
}: Tags003Props) {
const id = useId()
const [tags, setTags] = useState(defaultValue)
const [draft, setDraft] = useState("")
const full = tags.length >= max
const add = (value: string) => {
const tag = value.trim().toLowerCase()
if (!tag || tags.includes(tag)) return setDraft("")
// Очередь вместо блокировки: первый тег уходит, новый встаёт в конец.
setTags([...tags, tag].slice(-max))
setDraft("")
}
const onKeyDown = (event: KeyboardEvent<HTMLInputElement>) => {
if (event.key !== "Enter") return
event.preventDefault()
add(draft)
}
const palette = {
"--vibeui-tags-003-fill": `${Math.min(100, (tags.length / max) * 100)}%`,
...(accent ? { "--vibeui-tags-003-accent": accent } : null),
...style,
} as CSSProperties
return (
<>
<style href="vibeui-tags-003" precedence="medium">
{STYLES}
</style>
<div
{...props}
data-vibeui-block="tags-003"
data-full={full}
className={className}
style={palette}
>
<p data-part="head">
<label htmlFor={id}>{label}</label>
<span data-part="counter">
{tags.length} / {max}
</span>
</p>
<div data-part="field">
{tags.map((tag, index) => (
<span
key={tag}
data-part="chip"
data-doomed={full && index === 0 && draft.trim() !== ""}
>
{tag}
<button
type="button"
aria-label={`Убрать ${tag}`}
onClick={() => setTags(tags.filter((item) => item !== tag))}
>
×
</button>
</span>
))}
<input
id={id}
type="text"
value={draft}
placeholder="Добавить интерес…"
aria-describedby={`${id}-hint`}
onChange={(event) => setDraft(event.target.value)}
onKeyDown={onKeyDown}
/>
</div>
<div data-part="bar" aria-hidden="true">
<span data-part="fill" />
</div>
<p id={`${id}-hint`} data-part="hint" aria-live="polite">
{full
? `Лимит ${max}: следующий тег вытеснит «${tags[0]}».`
: `Можно добавить ещё ${max - tags.length}. На пределе новый тег вытеснит самый старый.`}
</p>
</div>
</>
)
}