Custom mask

Sözdizimi

Maske dizgisindeki özel token’lar:

const form = useForm({ defaultValues: { code: "" } })
 
const { code } = useViraMask({
  form,
  schema: {
    code: {
      mask: "aaa-999",
      transform: "uppercase",
    },
  },
})
 
const { rawValue, ...inputProps } = code
 
<input {...inputProps} placeholder="ABC-123" />

MaskOptions

Sık kullanılan alanlar:

• mask: pattern dizgisi
• transform: uppercase | lowercase
• allowedChars / forbiddenChars
• displayPrefix: gösterilir, ham değere yazılmaz (IBAN’daki TR)
• currency, dateFormat, alphaFormat, usernameFormat
• type, inputMode, autoComplete
• preset: hazır maske üzerine override

resolveMask

Dinamik maske için resolveMask(value, allValues, schema) yeni bir maske dizgisi (veya undefined) döner. Kart (Amex) ve CVV hazır maskeleri bunu kullanır: kardeş alanlara bakarak maskeyi günceller.

{
  mask: "9999 9999 9999 9999",
  resolveMask: (value) => {
    const digits = value.replace(/\D/g, "")
    if (digits.startsWith("34") || digits.startsWith("37")) {
      return "9999 999999 99999" // Amex
    }
    return undefined
  },
}