VibeUI

Combobox

Narrow Column

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

  • combobox
  • narrow
  • truncation
  • sidebar

Превью

1440pxHost theme

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

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

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

release/2026.0…x-invoices

release/2026.04.1-hotfix-invoices

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

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

# Установка и размещение «combobox-020» (Narrow Column) из VibeUI

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

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

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

## 2. Что это
Выбор в узкой колонке, где список режется многоточием справа, а выбранное значение — по середине, чтобы сохранить и начало, и хвост.

Выбор для узкого места: сайдбар, ячейка таблицы, боковая панель. Длинные значения обрезаются двумя способами — список режется справа, потому что его читают с начала, а выбранное значение по середине, потому что у ветки, пути или имени файла важен хвост. Полный текст доступен в title, в aria-label и строкой снизу. Ноль зависимостей, один файл, своя палитра.

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

<Combobox020 headChars={14} tailChars={10} />

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

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

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

## 5. Сохранить как установлено
- локальную палитру --vibeui-combobox-020-* и не подменять её токенами вашей темы (bg-muted, text-muted-foreground и подобными)
- разные способы обрезки для списка и для значения: это и есть решение варианта, а не украшение
- функцию shorten с многоточием посередине — обычный ellipsis съедает хвост, а именно он различает похожие значения
- aria-label с полным текстом у варианта: скринридер не должен читать обрезанную строку
- полный текст снизу с overflow-wrap: anywhere — единственное место, где значение видно целиком без наведения
- title у строк списка: мышью проверить полное имя должно быть можно без выбора
- моноширинный шрифт только для значений: одинаковые префиксы выстраиваются в столбец и различаются быстрее

## 6. Можно менять
- label — подпись поля; placeholder — подсказка в поле фильтра
- options — список значений
- defaultValue — значение, выбранное при первом рендере
- headChars — сколько символов сохранить в начале при обрезке по середине
- tailChars — сколько символов сохранить в хвосте
- onSelect — обработчик выбора; accent — цвет выбранной строки

## 7. Правила
- Не увеличивайте max-width, чтобы «влезло целиком»: смысл варианта в том, что места мало и его не будет больше.
- title не показывается на тач-устройствах: полная строка снизу — не дублирование, а единственный способ прочитать значение на телефоне.
- Обрезка считает символы, а не пиксели: в широком шрифте головы в 14 символов может не хватить, подбирайте под свой шрифт.
- Не режьте по середине строки списка: там важна не уникальность хвоста, а быстрое сканирование начал.

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

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

npx shadcn@latest add https://vibeui.ru/r/combobox-020.json
https://vibeui.ru/r/combobox-020.json

Компонент самодостаточен: один файл, ноль зависимостей, собственная палитра в локальных переменных --vibeui-combobox-020-*. Клиентский: запрос и значение живут в useState. Ширина ограничена 15rem — это ячейка таблицы, колонка сайдбара или боковая панель. Обрезка сделана двумя разными способами осознанно: строки списка режутся средствами CSS (white-space: nowrap + text-overflow: ellipsis), потому что список читают с начала; выбранное значение режется функцией shorten по середине, потому что у пути, ветки или файла значим хвост. Полный текст никуда не теряется: он лежит в title каждой строки, в aria-label варианта и целиком выводится внизу с overflow-wrap: anywhere. Моноширинный шрифт включён только для значений — так одинаковые префиксы визуально выстраиваются в столбец.

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

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

"use client"

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

export type Combobox020Props = Omit<
  ComponentPropsWithoutRef<"div">,
  "children" | "onSelect"
> & {
  label?: string
  placeholder?: string
  options?: string[]
  defaultValue?: string
  headChars?: number
  tailChars?: number
  onSelect?: (value: string) => void
  accent?: string
}

// Идея компонента: в узкой колонке — сайдбар, ячейка таблицы, боковая
// панель — длинные значения обрезаются, и обрезать их надо по-разному.
// В списке читают с начала, поэтому строки гаснут многоточием справа.
// А у выбранного значения важен хвост: имя файла, окончание пути, номер
// версии, — поэтому оно режется по середине и сохраняет оба конца.
const STYLES = `
:where([data-vibeui-block="combobox-020"]){
--vibeui-combobox-020-bg:oklch(1 0 0);
--vibeui-combobox-020-fg:oklch(0.22 0.014 175);
--vibeui-combobox-020-muted:oklch(0.55 0.014 175);
--vibeui-combobox-020-border:oklch(0.9 0.008 175);
--vibeui-combobox-020-field:oklch(0.985 0.004 175);
--vibeui-combobox-020-soft:oklch(0.96 0.008 175);
--vibeui-combobox-020-accent:oklch(0.47 0.1 175);
--vibeui-combobox-020-accentsoft:oklch(0.93 0.045 175);
--vibeui-combobox-020-radius:0.55rem;
--vibeui-combobox-020-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
--vibeui-combobox-020-mono:ui-monospace,SFMono-Regular,"SF Mono",Menlo,Consolas,monospace;
}
[data-vibeui-block="combobox-020"]{
display:flex;flex-direction:column;gap:0.35rem;
width:100%;max-width:15rem;box-sizing:border-box;padding:0.75rem;
background:var(--vibeui-combobox-020-bg);
border:1px solid var(--vibeui-combobox-020-border);
border-radius:calc(var(--vibeui-combobox-020-radius) + 0.25rem);
color:var(--vibeui-combobox-020-fg);
font-family:var(--vibeui-combobox-020-font);
}
[data-vibeui-block="combobox-020"] label{font-size:0.75rem;font-weight:600}
[data-vibeui-block="combobox-020"] input{
box-sizing:border-box;width:100%;height:2.2rem;padding:0 0.5rem;
border:1px solid var(--vibeui-combobox-020-border);
border-radius:var(--vibeui-combobox-020-radius);
background:var(--vibeui-combobox-020-field);
color:inherit;font:inherit;font-size:0.8125rem;
text-overflow:ellipsis;
}
[data-vibeui-block="combobox-020"] input::placeholder{color:var(--vibeui-combobox-020-muted)}
[data-vibeui-block="combobox-020"] input:focus-visible{
outline:2px solid var(--vibeui-combobox-020-accent);outline-offset:1px;border-color:transparent;
}
[data-vibeui-block="combobox-020"] [data-part="value"]{
display:flex;align-items:center;gap:0.3rem;
box-sizing:border-box;width:100%;min-height:2rem;padding:0.3rem 0.5rem;
border-radius:var(--vibeui-combobox-020-radius);
background:var(--vibeui-combobox-020-accentsoft);
font-family:var(--vibeui-combobox-020-mono);font-size:0.75rem;
}
[data-vibeui-block="combobox-020"] [data-part="short"]{
min-width:0;white-space:nowrap;overflow:hidden;
}
[data-vibeui-block="combobox-020"] [data-part="list"]{
margin:0;padding:0.15rem;list-style:none;display:flex;flex-direction:column;gap:0.1rem;
max-height:11rem;overflow-y:auto;overflow-x:hidden;
border:1px solid var(--vibeui-combobox-020-border);
border-radius:var(--vibeui-combobox-020-radius);
}
[data-vibeui-block="combobox-020"] [data-part="option"]{
appearance:none;cursor:pointer;font:inherit;width:100%;
display:block;box-sizing:border-box;padding:0.35rem 0.45rem;
border:0;border-radius:0.4rem;background:transparent;color:inherit;text-align:left;
font-family:var(--vibeui-combobox-020-mono);font-size:0.75rem;
white-space:nowrap;overflow:hidden;text-overflow:ellipsis;
transition:background-color .16s ease;
}
[data-vibeui-block="combobox-020"] [data-part="option"]:hover{background:var(--vibeui-combobox-020-soft)}
[data-vibeui-block="combobox-020"] [data-part="option"]:focus-visible{
outline:2px solid var(--vibeui-combobox-020-accent);outline-offset:-2px;
}
[data-vibeui-block="combobox-020"] [data-part="option"][aria-selected="true"]{
background:var(--vibeui-combobox-020-accent);color:var(--vibeui-combobox-020-bg);
}
[data-vibeui-block="combobox-020"] [data-part="full"]{
margin:0;font-size:0.68rem;line-height:1.35;color:var(--vibeui-combobox-020-muted);
overflow-wrap:anywhere;
}
[data-vibeui-block="combobox-020"] [data-part="empty"]{
margin:0;padding:0.5rem 0.45rem;font-size:0.75rem;color:var(--vibeui-combobox-020-muted);
}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="combobox-020"] *{animation:none!important;transition:none!important}}
`

const BRANCHES = [
  "feature/checkout-address-validation",
  "feature/payment-provider-migration",
  "release/2026.04.1-hotfix-invoices",
  "bugfix/cart-total-rounding-error",
  "chore/update-typescript-and-eslint",
  "experiment/new-onboarding-funnel-v3",
]

/** Обрезка по середине: сохраняет начало и хвост, а не только начало. */
function shorten(text: string, head: number, tail: number) {
  if (text.length <= head + tail + 1) return text

  return `${text.slice(0, head)}…${tail > 0 ? text.slice(-tail) : ""}`
}

/**
 * Выбор в узкой колонке: список режется справа, значение — по середине.
 * Один файл, ноль зависимостей, собственная палитра.
 */
export function Combobox020({
  label = "Ветка",
  placeholder = "Фильтр",
  options = BRANCHES,
  defaultValue = "release/2026.04.1-hotfix-invoices",
  headChars = 14,
  tailChars = 10,
  onSelect,
  accent,
  className,
  style,
  ...props
}: Combobox020Props) {
  const id = useId()
  const [query, setQuery] = useState("")
  const [value, setValue] = useState(defaultValue)

  const matches = useMemo(() => {
    const needle = query.trim().toLowerCase()

    return options.filter((option) => option.toLowerCase().includes(needle))
  }, [query, options])

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

  return (
    <>
      <style href="vibeui-combobox-020" precedence="medium">
        {STYLES}
      </style>
      <div
        {...props}
        data-vibeui-block="combobox-020"
        className={className}
        style={palette}
      >
        <label htmlFor={`${id}-input`}>{label}</label>
        <p data-part="value">
          <span data-part="short" title={value}>
            {value ? shorten(value, headChars, tailChars) : "не выбрана"}
          </span>
        </p>
        <input
          id={`${id}-input`}
          type="text"
          role="combobox"
          autoComplete="off"
          placeholder={placeholder}
          aria-expanded="true"
          aria-controls={`${id}-list`}
          aria-autocomplete="list"
          value={query}
          onChange={(event) => setQuery(event.target.value)}
        />
        <ul
          id={`${id}-list`}
          role="listbox"
          aria-label={label}
          data-part="list"
        >
          {matches.length === 0 ? (
            <li role="none">
              <p data-part="empty">Нет совпадений</p>
            </li>
          ) : (
            matches.map((option) => (
              <li key={option} role="none">
                <button
                  type="button"
                  role="option"
                  data-part="option"
                  aria-selected={option === value}
                  aria-label={option}
                  title={option}
                  onClick={() => {
                    setValue(option)
                    onSelect?.(option)
                  }}
                >
                  {option}
                </button>
              </li>
            ))
          )}
        </ul>
        <p data-part="full" aria-live="polite">
          {value || "Ветка не выбрана"}
        </p>
      </div>
    </>
  )
}