minLength va maxLength — Matn uzunligini to'g'ri boshqarish va cheklovlar
minLength va maxLength qoidalari bilan matn uzunligini tekshirish, ixtiyoriy maydonlarda minLength xatti-harakati va min/max dan farqlari.
15-dars
minLength va maxLength — Matn uzunligini boshqarish
minLength va maxLength — bu matnli (string) inputlar va <textarea> elementlaridagi belgilar (characters) sonini tekshirish uchun mo'ljallangan standart validatsiya qoidalaridir.
Ular foydalanuvchi kiritgan so'z yoki matnning juda qisqa (masalan, parol yoki login) yoki haddan tashqari uzun (masalan, qisqa bio yoki sharh) bo'lib ketmasligini ta'minlaydi.
1. Qanday ishlaydi?
minLength: Matn uzunligi belgilangan minimal belgilar sonidan kam bo'lsa, xatolik qaytaradi (type: "minLength").maxLength: Matn uzunligi belgilangan maksimal belgilar sonidan oshib ketsa, xatolik qaytaradi (type: "maxLength").{ value, message }formati: Xato xabarlarini boshqarishda{ value: number, message: string }ko'rinishida yozish tavsiya etiladi. Shundaerrors.field.messageorqali to'g'ridan-to'g'ri tushunarli xabarni ko'rsatish mumkin.
2. Real misol: Username va Bio uchun uzunlik chegaralari
Quyidagi misolda 3 dan 20 belgigacha bo'lgan majburiy username va ko'pi bilan 160 belgidan iborat ixtiyoriy bio maydonlarini tekshiramiz:
import { useForm, type SubmitHandler } from "react-hook-form";
type ProfileTextForm = {
username: string;
bio: string;
};
export function MinMaxLengthForm() {
const {
register,
handleSubmit,
formState: { errors },
} = useForm<ProfileTextForm>({
defaultValues: {
username: "",
bio: "",
},
});
const onSubmit: SubmitHandler<ProfileTextForm> = (data) => {
console.log("Profil ma'lumotlari saqlandi:", data);
};
return (
<form onSubmit={handleSubmit(onSubmit)} noValidate>
{/* 1. Username: majburiy, 3 dan 20 belgigacha */}
<div>
<label htmlFor="username">Username</label>
<input
id="username"
{...register("username", {
required: "Username kiritish majburiy",
minLength: {
value: 3,
message: "Username kamida 3 ta belgidan iborat bo'lishi kerak",
},
maxLength: {
value: 20,
message: "Username 20 ta belgidan oshmasligi kerak",
},
})}
placeholder="muhammadjon_dev"
/>
{errors.username && (
<p style={{ color: "red" }}>{errors.username.message}</p>
)}
</div>
{/* 2. Bio: ixtiyoriy maydon, lekin maksimum 160 belgi */}
<div style={{ marginTop: "1rem" }}>
<label htmlFor="bio">Qisqacha ma'lumot (Bio)</label>
<textarea
id="bio"
{...register("bio", {
maxLength: {
value: 160,
message: "Bio 160 ta belgidan oshmasligi lozim",
},
})}
placeholder="O'zingiz haqingizda qisqacha yozing..."
/>
{errors.bio && <p style={{ color: "red" }}>{errors.bio.message}</p>}
</div>
<button type="submit" style={{ marginTop: "1.5rem" }}>
Saqlash
</button>
</form>
);
}
3. Muhim amaliy jihatlar
1. Ixtiyoriy maydonda minLength ishlatish
Agar maydon majburiy bo'lmasa (required berilmagan bo'lsa), lekin foydalanuvchi biror narsa yozsa kamida 5 ta belgi bo'lishi talab qilinsa nima bo'ladi?
- Standart holatda foydalanuvchi maydonni bo'sh qoldirsa ham,
minLengthbo'sh satrni ("", uzunligi 0) tekshirib xato berishi mumkin. - Buni bartaraf qilish uchun
validatefunksiyasi yokisetValueAsorqali bo'sh satrni tekshirish qulay:{...register("optionalCode", { validate: (val) => !val || val.length >= 5 || "Agar to'ldirilsa, kamida 5 ta belgi bo'lishi shart", })}
2. minLength vs min farqi
minLengthvamaxLength: Faqat satr (string) belgilar sonini tekshiradi (masalan,"salom".length === 5).minvamax: Faqat sonlar (number) yoki sanalarning (Date) matematik miqdorini tekshiradi (masalan,yosh >= 18).