Series: React Hook Form Lesson 15

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. Shunda errors.field.message orqali 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, minLength bo'sh satrni ("", uzunligi 0) tekshirib xato berishi mumkin.
  • Buni bartaraf qilish uchun validate funksiyasi yoki setValueAs orqali 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

  • minLength va maxLength: Faqat satr (string) belgilar sonini tekshiradi (masalan, "salom".length === 5).
  • min va max: Faqat sonlar (number) yoki sanalarning (Date) matematik miqdorini tekshiradi (masalan, yosh >= 18).