criteriaMode — Bitta maydon uchun bir nechta xatolar ro'yxatini chiqarish
criteriaMode konfiguratsiyasi, firstError va all farqlari, errors.field.types obyekti va parol talablari checklistini qurish amaliyoti.
57-dars
criteriaMode — Bir field uchun bir nechta validation error
criteriaMode — bu useForm({ criteriaMode: ... }) konfiguratsiyasida belgilanadigan sozlama bo'lib, bitta maydon uchun bir vaqtning o'zida bir nechta validatsiya qoidasi buzilganda faqat bitta (birinchi) xatoni qaytarish yoki barcha buzilgan qoidalarning xabarlarini to'plab qaytarishni boshqaradi.
Sukut bo'yicha (default) criteriaMode qiymati "firstError" bo'ladi — ya'ni maydonda 3-4 ta qoida buzilgan taqdirda ham, errors[name].message ichida faqat eng birinchi xato ko'rsatiladi.
Agar criteriaMode: "all" berilsa, React Hook Form barcha buzilgan qoidalarni yig'adi va ularni errors[name].types obyektiga (Record<string, string | string[]>) joylaydi. Bu ayniqsa foydalanuvchiga barcha talablar ro'yxatini (Password Policy Checklist) bir vaqtda ko'rsatishda juda qo'l keladi.
1. criteriaMode qiymatlari taqqoslamasi
| Qiymat | Xatolar qanday qaytariladi? | Qaysi holatlarda foydali? |
|---|---|---|
"firstError" (default) |
Faqat birinchi buzilgan qoidaning xatosi (errors.field.message va errors.field.type). |
Standart formalarda ixchamlikni saqlash va bitta aniq xato xabarini ko'rsatish uchun. |
"all" |
Buzilgan barcha qoidalarning xabarlari errors.field.types obyektida to'planadi. |
Parol talablari nazorat ro'yxati (checklist), murakkab PIN-kod yoki ko'p shartli tekshiruvlarda. |
2. Real misol: Parol talablari ro'yxatini (Checklist) ko'rsatish
Quyidagi misolda criteriaMode: "all" yordamida parolda yetishmayotgan barcha shartlar (uzunlik, katta harf, raqam, maxsus belgi) ro'yxat ko'rinishida chiqariladi:
import { useForm, type SubmitHandler } from "react-hook-form";
type PasswordPolicyFormValues = {
password: string;
};
export function CriteriaModeAllForm() {
const {
register,
handleSubmit,
formState: { errors, isSubmitting },
} = useForm<PasswordPolicyFormValues>({
mode: "onChange",
criteriaMode: "all", // Barcha buzilgan qoidalarni to'playdi
defaultValues: {
password: "",
},
});
const onSubmit: SubmitHandler<PasswordPolicyFormValues> = async (data) => {
await new Promise((resolve) => setTimeout(resolve, 300));
console.log("Xavfsiz parol qabul qilindi:", data.password);
};
// criteriaMode: "all" bo'lganda types mavjud bo'ladi
const passwordErrorTypes = errors.password?.types;
return (
<form onSubmit={handleSubmit(onSubmit)} noValidate>
<div>
<label htmlFor="cmPassword">Xavfsiz parol yarating</label>
<input
id="cmPassword"
type="password"
placeholder="Kamida 8 belgi, katta harf, raqam va belgi"
{...register("password", {
required: "Parol kiritish majburiy",
minLength: {
value: 8,
message: "Kamida 8 ta belgidan iborat bo'lsin",
},
validate: {
hasUppercase: (value) =>
/[A-Z]/.test(value) || "Kamida bitta katta harf (A-Z) ishtirok etsin",
hasNumber: (value) =>
/\d/.test(value) || "Kamida bitta raqam (0-9) ishtirok etsin",
hasSpecialChar: (value) =>
/[!@#$%^&*]/.test(value) ||
"Kamida bitta maxsus belgi (!@#$%^&*) ishtirok etsin",
},
})}
/>
{/* Barcha buzilgan talablarni ro'yxat tarzida ko'rsatish */}
{passwordErrorTypes && (
<ul
role="alert"
style={{
marginTop: "8px",
paddingLeft: "20px",
color: "#dc2626",
fontSize: "0.9rem",
}}
>
{Object.entries(passwordErrorTypes).map(([ruleKey, message]) => {
const displayMsg = Array.isArray(message)
? message.join(", ")
: message;
return <li key={ruleKey}>{displayMsg}</li>;
})}
</ul>
)}
</div>
<button
type="submit"
disabled={isSubmitting}
style={{ marginTop: "1.25rem" }}
>
Saqlash
</button>
</form>
);
}
3. Muhim amaliy tavsiyalar
1. errors.field.types qachon mavjud bo'ladi?
Standart "firstError" rejimida errors.field.types qiymati har doim undefined bo'ladi. U faqat va faqat useForm({ criteriaMode: "all" }) konfiguratsiyasi o'rnatilgandagina to'ldiriladi. Undagi kalitlar (ruleKey) esa qoidaning nomi (masalan: required, minLength yoki validate dagi hasUppercase) bo'ladi.
2. UI'ni to'ldirib yubormaslik (UX qoidasi)
Oddiy matnli maydonlarda (ism, familiya, shahar) bir vaqtning o'zida bir nechta xato chiqarish foydalanuvchini chalg'itishi va formani ko'rimsiz qilishi mumkin. Shu sababli criteriaMode: "all" asosan parol xavfsizligi siyosati, murakkab moliyaviy hisob raqamlari yoki foydalanuvchiga barcha talablarni ko'rsatuvchi interaktiv ro'yxatlarda tavsiya etiladi.