Inputs
Labelled Stops
Диапазон по подписанным делениям: «студия» и «5 и больше» — не числа, но лежат на одной шкале, и промежуточных значений на ней нет.
- range
- steps
- ticks
- filter
Превью
Использовать с AI
- 1. Скопируйте ссылку.
- 2. Напишите агенту своими словами и вставьте её в предложение.
- 3. Агент откроет ссылку и поставит компонент из registry.
размести это в шапке: https://vibeui.ru/c/range-005
Комнат в квартире1 — 3
Показать полную инструкцию
То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.
# Установка и размещение «range-005» (Labelled Stops) из VibeUI
## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/range-005.json
Registry item: https://vibeui.ru/r/range-005.json
Ставится в: components/vibeui/range-005.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.
Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.
## 2. Что это
Диапазон по подписанным делениям: «студия» и «5 и больше» — не числа, но лежат на одной шкале, и промежуточных значений на ней нет.
Диапазон по дискретным подписанным делениям: ползунок ходит по номерам остановок, подписи стоят под дорожкой. Ноль зависимостей, один файл.
## 3. Как использовать
import { Range005 } from "@/components/vibeui/range-005"
<Range005 label="Комнат в квартире" stops={["Студия", "1", "2", "3", "4", "5 и больше"]} defaultFrom={1} defaultTo={3} />
Полный список пропсов — в установленном файле.
## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.
Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)
## 5. Сохранить как установлено
- локальную палитру --vibeui-range-005-* и не подменять её токенами вашей темы
- собственную светлую подложку: фильтр показывают поверх любого фона
- шаг в одно деление: между «двумя» и «тремя» комнатами значения не существует
- подписи прямо под дорожкой: числа на ползунке без подписей ничего не сообщают о шкале
- отступы в половину деления: без них крайние подписи уезжают за края дорожки
- aria-valuetext со словом: скринридер иначе читает «единица» вместо «студия»
- подсветку делений внутри отрезка: выбранное множество должно читаться целиком
## 6. Можно менять
- label — подпись фильтра
- stops — сами деления и их подписи
- defaultFrom и defaultTo — стартовые номера остановок
- длину подписей: короткие читаются лучше
- акцент через проп accent
## 7. Правила
- Границы могут совпасть: тогда выбрана одна остановка, и подпись показывает её одну.
- Больше восьми делений на узком экране не помещаются — подписи начинают наезжать друг на друга.
- Наружу отдавайте значения остановок, а не их номера: индексы поедут при правке списка.
- Не выносите CSS-переменные в globals.css: компонент обязан остаться одним файлом.
## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.Для разработчика
npx shadcn@latest add https://vibeui.ru/r/range-005.jsonhttps://vibeui.ru/r/range-005.jsonКомпонент самодостаточен: один файл, ноль зависимостей, палитра в локальных переменных --vibeui-range-005-*. Клиентский: в состоянии лежат номера остановок, а подписи берутся из массива по индексу. Шаг равен единице, поэтому попасть между делениями нельзя ни мышью, ни стрелками. Подписи выровнены по центрам делений: у области ползунка отступы в половину деления через переменную --vibeui-range-005-gutter, иначе крайние подписи уезжают за края дорожки. Каждому ползунку задан aria-valuetext, поэтому скринридер читает слово, а не номер.
Исходник компонента
Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.
"use client"
import { useState } from "react"
import type { ComponentPropsWithoutRef, CSSProperties } from "react"
export type Range005Props = Omit<
ComponentPropsWithoutRef<"div">,
"children" | "defaultValue" | "onChange"
> & {
label?: string
stops?: string[]
defaultFrom?: number
defaultTo?: number
accent?: string
}
// Идея компонента: диапазон по подписанным делениям, а не по числам. «Студия»
// и «5 и больше» — не числа, но лежат на одной шкале, и ползунок ходит по их
// номерам. Деления подписаны прямо под дорожкой, поэтому промежуточных
// значений не существует: попасть между «двумя» и «тремя» комнатами нельзя ни
// мышью, ни стрелками. Подписи выровнены по центрам делений через долю ширины,
// а не расставлены поровну: иначе крайние подписи уезжают за края дорожки.
const STYLES = `
:where([data-vibeui-block="range-005"]){
--vibeui-range-005-surface:oklch(1 0 0);
--vibeui-range-005-shell:oklch(0.9 0.006 265);
--vibeui-range-005-fg:oklch(0.23 0.014 265);
--vibeui-range-005-muted:oklch(0.55 0.014 265);
--vibeui-range-005-track:oklch(0.93 0.006 265);
--vibeui-range-005-accent:oklch(0.5 0.17 320);
--vibeui-range-005-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
--vibeui-range-005-from:0%;
--vibeui-range-005-to:100%;
--vibeui-range-005-gutter:8%;
}
/* Своя светлая подложка: фильтр показывают поверх любого фона. */
[data-vibeui-block="range-005"]{
display:flex;flex-direction:column;gap:0.5rem;
width:100%;max-width:22rem;box-sizing:border-box;padding:0.875rem;
background:var(--vibeui-range-005-surface);
border:1px solid var(--vibeui-range-005-shell);border-radius:0.875rem;
font-family:var(--vibeui-range-005-font);color:var(--vibeui-range-005-fg);
}
[data-vibeui-block="range-005"] [data-part="head"]{
display:flex;align-items:baseline;justify-content:space-between;gap:0.75rem;margin:0;
font-size:0.8125rem;
}
[data-vibeui-block="range-005"] [data-part="value"]{font-weight:700;color:var(--vibeui-range-005-accent)}
/* Отступы по половине деления: крайние подписи иначе уезжают за дорожку. */
[data-vibeui-block="range-005"] [data-part="area"]{
position:relative;padding:0 var(--vibeui-range-005-gutter);
}
[data-vibeui-block="range-005"] [data-part="rail"]{position:relative;height:1.25rem}
[data-vibeui-block="range-005"] [data-part="rail"]::before{
content:"";position:absolute;left:0;right:0;top:0.4375rem;height:0.375rem;border-radius:9999px;
background:linear-gradient(to right,
var(--vibeui-range-005-track) var(--vibeui-range-005-from),
var(--vibeui-range-005-accent) var(--vibeui-range-005-from),
var(--vibeui-range-005-accent) var(--vibeui-range-005-to),
var(--vibeui-range-005-track) var(--vibeui-range-005-to));
}
[data-vibeui-block="range-005"] input{
position:absolute;left:0;top:0;width:100%;height:1.25rem;margin:0;
appearance:none;background:none;pointer-events:none;
}
[data-vibeui-block="range-005"] input::-webkit-slider-runnable-track{background:none;height:0.375rem}
[data-vibeui-block="range-005"] input::-moz-range-track{background:none;height:0.375rem}
/* Дорожка событий не ловит, ручки ловят: иначе верхний ползунок съедает клики. */
[data-vibeui-block="range-005"] input::-webkit-slider-thumb{
appearance:none;pointer-events:auto;cursor:pointer;margin-top:-0.3125rem;
width:1rem;height:1rem;border-radius:9999px;
background:var(--vibeui-range-005-surface);border:2px solid var(--vibeui-range-005-accent);
box-shadow:0 1px 3px oklch(0.2 0.02 265 / 25%);
}
[data-vibeui-block="range-005"] input::-moz-range-thumb{
pointer-events:auto;cursor:pointer;box-sizing:border-box;
width:1rem;height:1rem;border-radius:9999px;
background:var(--vibeui-range-005-surface);border:2px solid var(--vibeui-range-005-accent);
}
[data-vibeui-block="range-005"] input:focus-visible{outline:2px solid var(--vibeui-range-005-accent);outline-offset:4px;border-radius:0.5rem}
/* Подписи делений: промежуточных значений на такой шкале не существует. */
[data-vibeui-block="range-005"] [data-part="ticks"]{display:flex;margin:0.25rem 0 0}
[data-vibeui-block="range-005"] [data-part="tick"]{
flex:1 1 0;display:flex;flex-direction:column;align-items:center;gap:0.1875rem;
font-size:0.6875rem;color:var(--vibeui-range-005-muted);
}
[data-vibeui-block="range-005"] [data-part="tick"]::before{
content:"";width:1px;height:0.3125rem;background:var(--vibeui-range-005-track);
}
[data-vibeui-block="range-005"] [data-part="tick"][data-in="true"]{color:var(--vibeui-range-005-fg);font-weight:650}
[data-vibeui-block="range-005"] [data-part="tick"][data-in="true"]::before{background:var(--vibeui-range-005-accent)}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="range-005"] *{animation:none!important;transition:none!important}}
`
const DEFAULT_STOPS = ["Студия", "1", "2", "3", "4", "5 и больше"]
/**
* Диапазон по подписанным делениям: ползунок ходит по номерам остановок.
* Один файл, ноль зависимостей, собственная палитра.
*/
export function Range005({
label = "Комнат в квартире",
stops = DEFAULT_STOPS,
defaultFrom = 1,
defaultTo = 3,
accent,
className,
style,
...props
}: Range005Props) {
const [from, setFrom] = useState(defaultFrom)
const [to, setTo] = useState(defaultTo)
const last = stops.length - 1
const percent = (value: number) => `${(value / last) * 100}%`
const palette = {
"--vibeui-range-005-from": percent(from),
"--vibeui-range-005-to": percent(to),
"--vibeui-range-005-gutter": `${50 / stops.length}%`,
...(accent ? { "--vibeui-range-005-accent": accent } : null),
...style,
} as CSSProperties
return (
<>
<style href="vibeui-range-005" precedence="medium">
{STYLES}
</style>
<div
{...props}
data-vibeui-block="range-005"
className={className}
style={palette}
>
<p data-part="head">
{label}
<span data-part="value" aria-live="polite">
{from === to ? stops[from] : `${stops[from]} — ${stops[to]}`}
</span>
</p>
<div data-part="area">
<div data-part="rail">
<input
type="range"
min={0}
max={last}
step={1}
value={from}
aria-label={`${label}: от`}
aria-valuetext={stops[from]}
onChange={(event) =>
setFrom(Math.min(Number(event.target.value), to))
}
/>
<input
type="range"
min={0}
max={last}
step={1}
value={to}
aria-label={`${label}: до`}
aria-valuetext={stops[to]}
onChange={(event) =>
setTo(Math.max(Number(event.target.value), from))
}
/>
</div>
</div>
<p data-part="ticks" aria-hidden="true">
{stops.map((stop, index) => (
<span
key={stop}
data-part="tick"
data-in={index >= from && index <= to}
>
{stop}
</span>
))}
</p>
</div>
</>
)
}