Özel maske
Desen sözdizimi, özel token, isteğe bağlı ve sabit bölümler, dinamik maske, sayı ve tarih seçenekleri.
Desen sözdizimi
| Yazım | Anlam |
|---|---|
9 | Rakam |
a | Harf (Türkçe harfler dahil) |
* | Harf ya da rakam |
\ | Sonraki karakter sabittir: \9 ekranda 9 yazar |
[ ] | İsteğe bağlı bölüm; boş kalsa da maske tamamlanmış sayılır |
{ } | Sabit bölüm; ekranda görünür ve form değerinde kalır ({TR}, {+}) |
Diğer karakterler yalnızca ekranda görünür. tokens ile kendi karakterlerini tanımlarsın; transform harfleri büyütür ya da küçültür.
Form değeri: -
Görünen: -
Dinamik maske
Dizi verirsen değeri bütünüyle alan ilk desen seçilir. Fonksiyon değeri ve ctx.from (bağlı alanın değeri) ile desen döner.
useViraMask(form, {
// ilk uyan desen seçilir
code: { mask: ["999-999", "9999-9999"] },
// değere ya da bağlı alana göre desen
card: {
mask: (value) => (/^3[47]/.test(value) ? "9999 999999 99999" : "9999 9999 9999 9999"),
},
// yazılanı desene yerleştirmeden önce düzelt
phone: { mask: "(999) 999 99 99", normalize: (value) => value.replace(/^0+/, "") },
})Sayı, para ve tarih
mask, number, currency ve date birbirini dışlar; ikisini birden vermek derleme hatasıdır.
number:min,max,scale(ondalık basamak),signed,locale(varsayılanen-US; Türkçe ayırıcılar için preset ilecountry: "TR"). Max yazarken, min alan terk edilince uygulanır.signedalanda negatif max da alan terk edilince uygulanır.currency: ISO kodu ya da{ code, locale, min, max, scale }. Ayırıcılar ve sembol Intl'den gelir. Kod yoksa sembolsüz1,234.56; Türk lirası için{ preset: "currency", country: "TR" }.date:format,min,max("today", ISO ya daDate),minAge. Tam tarihlerde form değeri ISO'dur.
Form değeri: -
Görünen: -
definePreset
Ekibinin maskesini tek yerde tanımla. Ad, hata anahtarlarının önekidir (orderNo.incomplete). Hook, sunucu ve testler aynı nesneyi kullanır.
// masks.ts — client ve server paylaşır
import { definePreset } from "@virastack/mask/server"
export const orderNo = definePreset("orderNo", {
mask: "aa-9999",
transform: "uppercase",
validate: (value) => !value.startsWith("XX") || "orderNo.reserved",
})
// form
useViraMask(form, { orderNo, returnNo: { preset: orderNo } })