Seriya: React Hook Form Dars 39

getValues() — Form qiymatlarini re-rendersiz on-demand o'qish

getValues() metodi, chaqirish usullari, watch() va useWatch() dan farqi, qoralama saqlash va qiymat nusxalash amaliyoti.

39-dars

getValues() — Form qiymatlarini olish

getValues() — bu useForm() (yoki useFormContext()) qaytaradigan funksiya bo'lib, formadagi joriy qiymatlarni talab bo'lganda (on-demand) bir martalik o'qish (snapshot) imkonini beradi.

watch() va useWatch() dan tub farqi shundaki: getValues() hech qanday obuna (subscription) yaratmaydi va qiymat o'zgarganda komponentni qayta render (re-render) qilmaydi.

U asosan tugma bosilganda (masalan, "Qoralama saqlash", "Qiymatni boshqa maydonga nusxalash"), hodisa ishlovchilarida (event handlers) yoki maxsus validatsiya mantiqlarida qiymatni tezkor o'qish uchun ishlatiladi.


1. getValues() ni chaqirish usullari

Chaqirish usuli Nimani qaytaradi? Qachon ishlatiladi?
getValues() (argumentsiz) Butun formaning barcha joriy qiymatlari (T). Qoralamani (draft) saqlash, tashqi API'ga oraliq ma'lumot yuborish yoki barcha ma'lumotlarni o'qishda.
getValues("fieldName") Shu bitta maydonning qiymati (T["fieldName"]). Tugma bosilganda yoki hodisa ichida aniq bitta maydon qiymatini olishda.
getValues(["a", "b"]) [valueA, valueB] ko'rinishidagi massiv. Bir vaqtning o'zida bir nechta aniq maydonlarni birgalikda o'qishda.

2. getValues() vs watch() vs useWatch()

Xususiyat getValues() watch() useWatch()
Re-render chaqiradimi? Yo'q (0 ta render) Ha (butun ota komponent) Ha (faqat bola komponent)
Ma'lumot turi Bir martalik lahzalik holat (Snapshot) Jonli oqim (Live Subscription) Jonli oqim (Live Subscription)
Asosiy maqsadi Tugma/hodisa orqali qiymat olish UI'da jonli o'zgarishlarni aks ettirish Kichik komponentda izolyatsiya qilingan UI o'zgarishi
Qayerda ishlatiladi? onClick, useEffect, validate To'g'ridan-to'g'ri JSX/render ichida Alohida bola komponent ichida

3. Real misol: Manzilni nusxalash va qoralama saqlash

Quyidagi misolda yetkazib berish manzilini to'lov (billing) manziliga nusxalash va formani qoralama sifatida saqlash funksiyalarida getValues() dan foydalanamiz:

import { useForm, type SubmitHandler } from "react-hook-form";

type AddressFormValues = {
  shippingAddress: string;
  billingAddress: string;
};

export function GetValuesForm() {
  const {
    register,
    getValues,
    setValue,
    handleSubmit,
    formState: { errors },
  } = useForm<AddressFormValues>({
    defaultValues: {
      shippingAddress: "",
      billingAddress: "",
    },
  });

  // 1. Bitta maydonni re-rendersiz o'qib, boshqa maydonga yozish
  const handleCopyAddress = () => {
    const currentShipping = getValues("shippingAddress");

    setValue("billingAddress", currentShipping, {
      shouldDirty: true,
      shouldValidate: true,
    });
  };

  // 2. Barcha qiymatlarning lahzalik holatini (snapshot) saqlash
  const handleSaveDraft = () => {
    const draftValues = getValues();
    console.log("Qoralama saqlandi:", draftValues);
    alert("Forma qoralama sifatida saqlandi!");
  };

  const onSubmit: SubmitHandler<AddressFormValues> = (data) => {
    console.log("Buyurtma tasdiqlandi:", data);
  };

  return (
    <form onSubmit={handleSubmit(onSubmit)} noValidate>
      <div>
        <label htmlFor="shippingAddress">Yetkazib berish manzili</label>
        <input
          id="shippingAddress"
          placeholder="Toshkent sh., Amir Temur ko'chasi, 15"
          {...register("shippingAddress", {
            required: "Yetkazib berish manzili majburiy",
          })}
        />
        {errors.shippingAddress && (
          <p style={{ color: "red" }}>{errors.shippingAddress.message}</p>
        )}
      </div>

      <div style={{ marginTop: "1rem" }}>
        <label htmlFor="billingAddress">To'lov (billing) manzili</label>
        <input
          id="billingAddress"
          placeholder="Hisob-faktura manzili"
          {...register("billingAddress", {
            required: "To'lov manzili majburiy",
          })}
        />
        {errors.billingAddress && (
          <p style={{ color: "red" }}>{errors.billingAddress.message}</p>
        )}
      </div>

      <div style={{ marginTop: "1.25rem", display: "flex", gap: "0.5rem" }}>
        <button type="button" onClick={handleCopyAddress}>
          Yetkazib berish manzilini nusxalash
        </button>

        <button type="button" onClick={handleSaveDraft}>
          Qoralama saqlash
        </button>

        <button type="submit">
          Yuborish
        </button>
      </div>
    </form>
  );
}

4. Muhim eslatmalar

1. Render paytida UI'ni yangilash uchun ishlatmang

Agar JSX ichida biror matn yoki shartli blok foydalanuvchi yozishi bilan avtomatik o'zgarishi kerak bo'lsa, getValues() yordam bermaydi, chunki u komponentni qayta chizmaydi. Bunday vazifalar uchun watch() yoki useWatch() dan foydalanish shart.

2. Validatsiya o'tkazmaydi

getValues() chaqirilganda hech qanday validatsiya qoidalari ishga tushmaydi va formState.errors yangilanmaydi. U shunchaki formaning ichki holatidagi qiymatlarning xom nusxasini qaytaradi.