- ViraStack Mask
v2.4.0Minor
`getMaskPlaceholder()` ve ayrıntılı IBAN hata anahtarları
Maskeden placeholder metni üret; IBAN'ın neden geçersiz olduğunu öğren: ülke, uzunluk ya da kontrol hanesi.
Ne değişti
getMaskPlaceholder(spec): Maskeden placeholder metni döndürür:{ preset: "phone", country: "TR" }için(___) ___ __ __, Türkiye IBAN'ı içinTR__ ____ ____ ____ ____ ____ __.createMaskile aynı argümanı alır;useViraMask'a verdiğin şema girdisini doğrudan verebilirsin. Kök ve/servergirişlerinde.- Ne çizer: Yazılacak her karakter
_olur. Ayraçlar ve{sabit}parçalar olduğu gibi kalır, isteğe bağlı[...]parçalar yazılmaz. Desenini çalışma anında seçen maskeler (card,cvv,plate) boş alandaki haliyle okunur. - Nerede
undefineddöner: Sayı, para ve tarih maskeleri (expirydahil), bilinmeyen preset vefullNamegibi en fazla bir zorunlu karakteri olan maskeler. - IBAN hata anahtarları:
ibanpreset'i artık nedeni söyler.iban.country: değer iki A–Z harfiyle başlamıyor.iban.length: uzunluk ülkesine uymuyor (TR 26, DE 22).iban.checksum: mod-97 kontrolü tutmuyor.{ preset: "iban", country: "TR" }ülkeyi ve uzunluğu sabitlediği için yeni anahtarlardan yalnızcaiban.checksumdöner. iban.invalidyedek anahtar: IBAN'da olamayacak bir karakterde (A–Z dışı harf) vefalsedönen kendivalidatefonksiyonunda gelmeye devam eder.isValidIBANeskisiyle aynı sonuçları verir.- Boyut: Kök giriş 9,95 kB'tan 10,07 kB'a çıktı (min+brotli).
Neden
- Placeholder: Elle yazılan placeholder maskeden kopar: deseni değiştirirsin, altındaki ipucu eski kalır. Yardımcı, alanın kullandığı maskenin aynısını okur.
- IBAN anahtarları: Tek bir "geçersiz IBAN" mesajı kullanıcıya neyi düzelteceğini söylemez. Eksik hane ile yanlış yazılmış hane ayrı mesaj ister.
- Sınırlar: IBAN kayıt listesinde olmayan ülke kodu reddedilmez; 15–34 karakter ve mod-97 ile kontrol edilir. Ülkeye özgü hesap kuralları (BBAN) kontrol edilmez. Hook placeholder'ı kendisi atamaz. Testleri Chromium, Firefox ve WebKit'te ve bir Next.js uygulamasında çalıştırdık; başka framework denemedik.
Commit'ler
Geçiş
Mesaj haritanda iban.invalid varsa üç yeni anahtarı ekle. Hatalı kontrol hanesi eskiden iban.invalid dönüyordu, artık iban.checksum dönüyor; mesajı yoksa kullanıcı ham anahtarı görür. iban.country, iban.length ve iban.checksum anahtarlarını ekle ya da iban. ile başlayan diğer anahtarlarda iban.invalid mesajına düş. presets.iban.options'ı yayarak kurduğun kendi preset'in de <ad>.invalid yerine iban.* anahtarlarını alır. Başka bir şey değişmez.