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.