Inputs
Card Mask
Номер карты с маской по четвёркам, определением платёжной системы по первым цифрам и проверкой Луна перед отправкой.
- input
- card
- payment
- mask
Превью
Использовать с AI
- 1. Скопируйте ссылку.
- 2. Напишите агенту своими словами и вставьте её в предложение.
- 3. Агент откроет ссылку и поставит компонент из registry.
размести это в шапке: https://vibeui.ru/c/input-008
Номер не сходится — проверьте цифры.
Показать полную инструкцию
То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.
# Установка и размещение «input-008» (Card Mask) из VibeUI
## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/input-008.json
Registry item: https://vibeui.ru/r/input-008.json
Ставится в: components/vibeui/input-008.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.
Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.
## 2. Что это
Номер карты с маской по четвёркам, определением платёжной системы по первым цифрам и проверкой Луна перед отправкой.
Поле карты: маска по четвёркам поверх чистых цифр, платёжная система словом, проверка Луна и поля срока и кода рядом. Ноль зависимостей, один файл, своя палитра.
## 3. Как использовать
import { Input008 } from "@/components/vibeui/input-008"
<Input008
label="Номер карты"
onChange={(digits) => setCard(digits)}
/>
Полный список пропсов — в установленном файле.
## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.
Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)
## 5. Сохранить как установлено
- локальную палитру --vibeui-input-008-* и не подменять её токенами вашей темы
- хранение только цифр: пробелы — это отображение, а не значение
- проверку Луна на полном номере — она ловит опечатку в одной цифре до похода на сервер
- название платёжной системы словом, а не логотипом: чужие логотипы нельзя раздавать вместе с кодом
- autoComplete cc-number, cc-exp и cc-csc: без них браузер не подставит сохранённую карту
- табличные цифры и разрядку: номер сверяют глазами с пластиком
## 6. Можно менять
- текст label и стартовое значение defaultValue
- набор определяемых платёжных систем
- подписи полей срока и кода
- акцент через проп accent
## 7. Правила
- Компонент ничего не хранит и никуда не отправляет: данные карты должен забирать платёжный шлюз.
- Не логируйте значение onChange — это номер карты.
- Маска рассчитана на шестнадцать цифр: у Amex их пятнадцать и группы другие.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.
## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.Для разработчика
npx shadcn@latest add https://vibeui.ru/r/input-008.jsonhttps://vibeui.ru/r/input-008.jsonКомпонент самодостаточен: один файл, без зависимостей, собственная палитра в локальных переменных --vibeui-input-008-*. Клиентский: "use client". В состоянии живут только цифры, пробелы дорисовываются функцией группировки — вставка в любом формате даёт один результат. Платёжная система определяется по префиксу и подписывается словом, а не логотипом: логотипы нельзя раздавать в registry. Луна считается только на полных шестнадцати цифрах. Рядом стоят срок и код: карту без них не принимают.
Исходник компонента
Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.
"use client"
import { useId, useState } from "react"
import type { ComponentPropsWithoutRef, CSSProperties } from "react"
export type Input008Props = Omit<
ComponentPropsWithoutRef<"div">,
"children" | "defaultValue" | "onChange"
> & {
label?: string
defaultValue?: string
onChange?: (digits: string) => void
accent?: string
}
// Идея компонента: номер карты набирают глазами с пластика, поэтому маска
// разбивает его ровно на те же четвёрки. В состоянии живут только цифры,
// пробелы дорисовываются — вставка «4276 3800 0000 0000» и «4276380000000000»
// дают один результат. Платёжная система определяется по первым цифрам и
// подписывается словом: значок без подписи ничего не объясняет.
const STYLES = `
:where([data-vibeui-block="input-008"]){
--vibeui-input-008-surface:oklch(1 0 0);
--vibeui-input-008-shell:oklch(0.91 0.006 265);
--vibeui-input-008-fg:oklch(0.22 0.014 265);
--vibeui-input-008-muted:oklch(0.55 0.014 265);
--vibeui-input-008-field:oklch(0.985 0.002 265);
--vibeui-input-008-border:oklch(0.88 0.008 265);
--vibeui-input-008-accent:oklch(0.52 0.18 285);
--vibeui-input-008-bad:oklch(0.55 0.2 25);
--vibeui-input-008-ok:oklch(0.5 0.13 155);
--vibeui-input-008-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="input-008"]{
display:flex;flex-direction:column;gap:0.4375rem;
width:100%;max-width:21rem;box-sizing:border-box;padding:0.875rem;
background:var(--vibeui-input-008-surface);
border:1px solid var(--vibeui-input-008-shell);border-radius:0.875rem;
font-family:var(--vibeui-input-008-font);color:var(--vibeui-input-008-fg);
}
[data-vibeui-block="input-008"] *{box-sizing:border-box}
[data-vibeui-block="input-008"] [data-part="head"]{
display:flex;align-items:baseline;justify-content:space-between;gap:0.5rem;
}
[data-vibeui-block="input-008"] label{font-size:0.8125rem;font-weight:600}
/* Подпись системы — текст, а не логотип: логотипы нельзя раздавать
в registry, а слово читается и вслух, и на маленьком экране. */
[data-vibeui-block="input-008"] [data-part="brand"]{
flex:none;padding:0.125rem 0.4375rem;border-radius:999px;
font-size:0.6875rem;font-weight:650;letter-spacing:0.04em;text-transform:uppercase;
background:color-mix(in oklab,var(--vibeui-input-008-accent) 12%,transparent);
color:var(--vibeui-input-008-accent);
}
[data-vibeui-block="input-008"] [data-part="frame"]{
display:flex;align-items:center;gap:0.5rem;
height:2.75rem;padding:0 0.75rem;
background:var(--vibeui-input-008-field);
border:1px solid var(--vibeui-input-008-border);border-radius:0.75rem;
transition:border-color .16s ease,box-shadow .16s ease;
}
[data-vibeui-block="input-008"] [data-part="frame"]:focus-within{
border-color:var(--vibeui-input-008-accent);
box-shadow:0 0 0 3px color-mix(in oklab,var(--vibeui-input-008-accent) 18%,transparent);
}
[data-vibeui-block="input-008"] input{
flex:1;min-width:0;height:100%;border:0;background:none;color:inherit;
font:inherit;font-size:1rem;letter-spacing:0.06em;
font-variant-numeric:tabular-nums;
}
[data-vibeui-block="input-008"] input:focus{outline:none}
[data-vibeui-block="input-008"] [data-part="row"]{
display:flex;align-items:center;gap:0.5rem;
}
[data-vibeui-block="input-008"] [data-part="row"] [data-part="cell"]{flex:1;min-width:0}
[data-vibeui-block="input-008"] [data-part="cell"] > span{
display:block;margin-bottom:0.25rem;
font-size:0.6875rem;font-weight:600;color:var(--vibeui-input-008-muted);
}
[data-vibeui-block="input-008"] [data-part="cell"] [data-part="frame"]{height:2.25rem}
[data-vibeui-block="input-008"] [data-part="cell"] input{font-size:0.875rem;letter-spacing:0.04em}
[data-vibeui-block="input-008"] [data-part="note"]{
margin:0;font-size:0.75rem;line-height:1.4;color:var(--vibeui-input-008-muted);
}
[data-vibeui-block="input-008"] [data-part="note"][data-tone="bad"]{color:var(--vibeui-input-008-bad)}
[data-vibeui-block="input-008"] [data-part="note"][data-tone="ok"]{color:var(--vibeui-input-008-ok)}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="input-008"] *{animation:none!important;transition:none!important}}
`
function brandOf(digits: string) {
if (/^4/.test(digits)) return "Visa"
if (/^(5[1-5]|2[2-7])/.test(digits)) return "Mastercard"
if (/^220[0-4]/.test(digits)) return "Мир"
if (/^3[47]/.test(digits)) return "Amex"
return null
}
function group(digits: string) {
return digits.replace(/(.{4})/g, "$1 ").trim()
}
// Алгоритм Луна ловит опечатку в одной цифре ещё до похода на сервер —
// это единственная проверка номера, которую честно делать на клиенте.
function luhn(digits: string) {
let sum = 0
for (let index = 0; index < digits.length; index += 1) {
let value = Number(digits[digits.length - 1 - index])
if (index % 2 === 1) {
value *= 2
if (value > 9) value -= 9
}
sum += value
}
return sum % 10 === 0
}
/**
* Поле номера карты: маска по четвёркам, система по первым цифрам, проверка Луна.
* Один файл, ноль зависимостей, собственная палитра.
*/
export function Input008({
label = "Номер карты",
defaultValue = "4276380000000000",
onChange,
accent,
className,
style,
...props
}: Input008Props) {
const id = useId()
const [digits, setDigits] = useState(
defaultValue.replace(/\D/g, "").slice(0, 16),
)
const [expiry, setExpiry] = useState("0729")
const [code, setCode] = useState("")
const palette = {
...(accent ? { "--vibeui-input-008-accent": accent } : null),
...style,
} as CSSProperties
const brand = brandOf(digits)
const full = digits.length === 16
const valid = full && luhn(digits)
return (
<>
<style href="vibeui-input-008" precedence="medium">
{STYLES}
</style>
<div
{...props}
data-vibeui-block="input-008"
className={className}
style={palette}
>
<div data-part="head">
<label htmlFor={id}>{label}</label>
{brand ? <span data-part="brand">{brand}</span> : null}
</div>
<div data-part="frame">
<input
id={id}
type="text"
inputMode="numeric"
autoComplete="cc-number"
placeholder="0000 0000 0000 0000"
value={group(digits)}
aria-invalid={full && !valid}
aria-describedby={`${id}-note`}
onChange={(event) => {
const next = event.target.value.replace(/\D/g, "").slice(0, 16)
setDigits(next)
onChange?.(next)
}}
/>
</div>
<div data-part="row">
<div data-part="cell">
<span id={`${id}-exp`}>Срок</span>
<div data-part="frame">
<input
type="text"
inputMode="numeric"
autoComplete="cc-exp"
placeholder="ММ / ГГ"
aria-labelledby={`${id}-exp`}
value={
expiry.length > 2
? `${expiry.slice(0, 2)} / ${expiry.slice(2)}`
: expiry
}
onChange={(event) =>
setExpiry(event.target.value.replace(/\D/g, "").slice(0, 4))
}
/>
</div>
</div>
<div data-part="cell">
<span id={`${id}-cvc`}>Код</span>
<div data-part="frame">
<input
type="text"
inputMode="numeric"
autoComplete="cc-csc"
placeholder="000"
aria-labelledby={`${id}-cvc`}
value={code}
onChange={(event) =>
setCode(event.target.value.replace(/\D/g, "").slice(0, 4))
}
/>
</div>
</div>
</div>
<p
data-part="note"
id={`${id}-note`}
aria-live="polite"
data-tone={full ? (valid ? "ok" : "bad") : "calm"}
>
{full
? valid
? "Номер прошёл контрольную проверку."
: "Номер не сходится — проверьте цифры."
: "Данные карты не сохраняются, поле только собирает их для платёжного шлюза."}
</p>
</div>
</>
)
}