Xử lý form trong React Native ở một tầm cao mới
Nâng cấp cách xử lý form trong React Native với Zod và React Hook Form
Xử lý form là phần cơ bản của mọi ứng dụng cần người dùng nhập liệu, và với đúng công cụ, đúng thư viện, việc này có thể đơn giản và trơn tru. Bài viết này sẽ hướng dẫn bạn cách xử lý form trong một app react-native bằng react-hook-form và zod. Kết hợp hai thư viện này, chúng ta sẽ có một cơ chế xử lý form hiệu quả. Hãy cùng tạo một form đăng ký đơn giản để minh họa.
Toàn bộ source code sẽ có ở cuối bài viết.
Khai báo schema với Zod
Đầu tiên, chúng ta khai báo schema bằng zod. Schema này mô tả hình dạng dữ liệu mà form cần có và thiết lập validation cho từng field. Zod cung cấp rất nhiều hàm validation mạnh mẽ để định nghĩa các quy tắc này.
Đây là toàn bộ schema zod:
Bài viết này giả định rằng bạn đã biết những kiến thức cơ bản về zod.
import z from "zod";
const phoneNumberRegexp = new RegExp(
/^[\+]?([0-9][\s]?|[0-9]?)([(][0-9]{3}[)][\s]?|[0-9]{3}[-\s\.]?)[0-9]{3}[-\s\.]?[0-9]{4,6}$/im
);
const FIELD_REQUIRED_STR = "This field is required";
export const GENDER_OPTIONS = ["Male", "Female", "Other"] as const;
export const signUpFormSchema = z.object({
name: z
.string({
invalid_type_error: "Name must be a string",
required_error: FIELD_REQUIRED_STR,
})
.min(3, "Minimum 3 characters")
.max(20, "Maximum 20 characters")
.trim(),
surname: z
.string({
invalid_type_error: "Surname must be a string",
required_error: FIELD_REQUIRED_STR,
})
.min(3, "Minimum 3 characters")
.max(20, "Maximum 20 characters")
.trim(),
phoneNumber: z
.string({
invalid_type_error: "Phone number must be a number",
required_error: FIELD_REQUIRED_STR,
})
.regex(phoneNumberRegexp, "Invalid phone number"),
email: z
.string({
invalid_type_error: "Email must be a string",
required_error: FIELD_REQUIRED_STR,
})
.email("Email is invalid"),
gender: z.enum(GENDER_OPTIONS, {
required_error: FIELD_REQUIRED_STR,
invalid_type_error: `Invalid gender, must be one of the followings: ${GENDER_OPTIONS.join(
", "
)}`,
}),
birthDate: z
.date({
invalid_type_error: "Birth date must be a date",
required_error: FIELD_REQUIRED_STR,
})
.min(new Date("1900-01-01"), "Invalid date time, too old")
.max(new Date("2023-01-01"), "Invalid date time, too young")
.default(new Date()),
});
export type SignUpFormSchema = z.infer<typeof signUpFormSchema>;
Trong schema này, chúng ta dùng zod để quy định mỗi field phải chứa gì. Ví dụ, field name và surname phải là chuỗi dài từ 3 đến 20 ký tự, còn field phoneNumber phải là số.
Một số field có quy tắc phức tạp hơn. Chẳng hạn, field email phải là chuỗi và chỉ chấp nhận địa chỉ email hợp lệ. Field gender phải là một trong các lựa chọn giới tính định sẵn ('Male', 'Female' hoặc 'Other').
Cuối cùng, field birthDate có kiểu date và phải là một ngày hợp lệ trong khoảng từ 1900-01-01 đến 2023-01-01. Mặc định, nó lấy ngày hiện tại nếu không có giá trị nào được truyền vào.
Với zod, chúng ta có thể tạo các quy tắc validation phức tạp một cách dễ dàng. Nhờ vậy, dữ liệu nhận được từ form chắc chắn sẽ khớp với những gì chúng ta mong đợi.
Bước tiếp theo là suy ra kiểu của schema. Zod có phương thức infer, giúp suy ra kiểu TypeScript từ một schema zod.
export type SignUpFormSchema = z.infer<typeof signUpFormSchema>;
Kiểu được suy ra này sau đó được dùng trong useForm để đảm bảo dữ liệu form khớp với schema.
Thiết lập form với React Hook Form
Tiếp theo, chúng ta thiết lập form bằng hook useForm từ 'react-hook-form'. Hook này nhận schema zod (thông qua zodResolver) làm tham số để xử lý validation cho form.
const methods = useForm<SignUpFormSchema>({
resolver: zodResolver(signUpFormSchema),
defaultValues: {
birthDate: new Date(),
},
mode: "onBlur",
});
resolver là nơi chúng ta truyền schema vào. Thuộc tính defaultValues cho phép đặt giá trị mặc định cho các field. Ở đây, chúng ta đặt giá trị mặc định của birthDate là ngày hiện tại. Thuộc tính mode quyết định khi nào validation diễn ra. Trong trường hợp này, validation sẽ chạy khi onBlur, tức là khi người dùng rời khỏi một field.
Render field và validation
Chúng ta dùng component Controller của react-hook-form để quản lý từng field trong form. Nó cung cấp các props field và fieldState, được dùng để quản lý giá trị, trạng thái lỗi và validation của field.
Ví dụ, đây là cách thiết lập field name:
<Controller
control={methods.control}
name="name"
render={({ field: { onChange, onBlur, value }, fieldState: { error } }) => {
return (
<TextInput
label="Name"
onBlur={onBlur}
value={value}
onChangeText={onChange}
errorMessage={error?.message}
/>
);
}}
/>
Đây là vai trò của từng prop:
-
control: Đây là nơi bạn truyền prop control từ hook useForm. Controller cần nó để tương tác với state của form.
-
name: Đây là key để truy cập giá trị của input trong form. Khi bạn lấy hoặc đặt giá trị form, key này sẽ được dùng. Nó phải là duy nhất trong tất cả các field của form.
-
render: Đây là một hàm trả về element input của bạn. Hàm này cung cấp các props field và fieldState.
-
field: Chứa các props onChange, onBlur và value. Chúng nên được nối trực tiếp với controlled component của bạn. Ở đây, onChange được nối với onChangeText của TextInput, để bắt dữ liệu người dùng nhập và lưu vào state của form.
-
fieldState: Chứa prop error, cho biết thông tin về lỗi validation của field này.
Bên trong prop render, TextInput được tùy biến. onBlur và onChangeText được gắn với các phương thức tương ứng từ field, còn prop value được nối với giá trị hiện tại của input này trong form. Prop errorMessage được nối với thông báo lỗi khi validation thất bại.
Vì vậy, khi submit form hoặc khi validation chạy theo thời gian thực, nếu field ‘name’ không thỏa mãn các yêu cầu validation đã định nghĩa trong schema Zod, thông báo lỗi sẽ hiện ra trong TextInput này.
Tự kích hoạt validation với React Hook Form
Một tình huống đặc biệt xảy ra với field birthDate, vốn dùng một component chọn ngày (ở đây là RNDateTimePicker). Trong trường hợp này, quá trình validation cần được xử lý riêng, vì cách người dùng tương tác với date picker khác với các text input thông thường.
<Controller
control={methods.control}
name="birthDate"
render={({ field: { onChange, onBlur, value }, fieldState: { error } }) => {
return (
<View>
<Text>Birth date</Text>
<RNDateTimePicker
value={value}
mode="date"
onChange={(e) => {
if (e.type === "set" && e.nativeEvent.timestamp) {
onChange(new Date(e.nativeEvent.timestamp));
methods.trigger("birthDate");
}
}}
/>
{!!error?.message && <Text>{error.message}</Text>}
</View>
);
}}
/>
Khi người dùng chọn một ngày, sự kiện onChange được kích hoạt. Trong handler này, trước tiên chúng ta kiểm tra xem kiểu sự kiện có phải 'set' hay không, tức là người dùng đã chọn ngày. Tiếp theo, chúng ta kiểm tra xem có timestamp hay không, để chắc chắn rằng một ngày đã được chọn.
Khi các điều kiện này thỏa mãn, chúng ta chuyển timestamp thành một object Date của JavaScript bằng new Date(e.nativeEvent.timestamp). Sau đó, giá trị mới này được truyền vào onChange, giúp cập nhật giá trị của field birthDate trong form.
Tuy nhiên, khác với text input thông thường vốn tự kích hoạt validation khi thay đổi, date picker không kích hoạt validation theo cách đó. Vì vậy, chúng ta cần tự kích hoạt validation sau khi giá trị được cập nhật, bằng cách gọi methods.trigger('birthDate').
Phương thức trigger mà react-hook-form cung cấp sẽ chạy validation cho một field cụ thể. Ở đây, nó kích hoạt validation cho field birthDate ngay khi ngày được chọn, đảm bảo các quy tắc validation được áp dụng ngay lập tức.
Cuối cùng, nếu có lỗi validation, chúng sẽ được hiển thị qua {!!error?.message &&
Submit form với React Hook Form
Package react-hook-form cung cấp các phương thức hiệu quả để xử lý việc submit form và xử lý lỗi.
const onSubmit: SubmitHandler<SignUpFormSchema> = (data) => {
console.log(JSON.stringify(data));
};
const onError: SubmitErrorHandler<SignUpFormSchema> = (errors, e) => {
console.log(JSON.stringify(errors));
};
<Button
onPress={methods.handleSubmit(onSubmit, onError)}
title="Submit Form"
color={"#007BFF"}
/>;
Hãy cùng phân tích quá trình này:
Handler onSubmit nhận dữ liệu form làm tham số. Trong ví dụ này, chúng ta chỉ log dữ liệu ra, nhưng trong ứng dụng thực tế, dữ liệu có thể được gửi lên server hoặc xử lý thêm tùy theo nhu cầu của ứng dụng.
Còn hàm onError được gọi khi có lỗi validation lúc submit form. Object errors chứa thông tin chi tiết về tất cả các field không vượt qua validation. Trong ví dụ này, chúng ta chỉ log các lỗi đó ra.
Nếu field nào cũng có lỗi, object error sẽ trông như sau:
{
"name": {
"message": "This field is required",
"type": "invalid_type",
"ref": {
"name": "name"
}
},
"surname": {
"message": "This field is required",
"type": "invalid_type",
"ref": {
"name": "surname"
}
},
"phoneNumber": {
"message": "This field is required",
"type": "invalid_type",
"ref": {
"name": "phoneNumber"
}
},
"email": {
"message": "This field is required",
"type": "invalid_type",
"ref": {
"name": "email"
}
},
"gender": {
"message": "This field is required",
"type": "invalid_type",
"ref": {
"name": "gender"
}
},
"birthDate": {
"message": "Invalid date time, too young",
"type": "too_big",
"ref": {
"name": "birthDate"
}
}
}
Validation trước với Zod
Đoạn code dưới đây trình bày cách tự validate trước dữ liệu form bằng phương thức safeParse của Zod, trước khi sự kiện submit form diễn ra. Dù validation của form đã được phương thức handleSubmit của React Hook Form đảm nhận, việc validate trước có thể cho lập trình viên nhiều quyền kiểm soát hơn đối với quá trình validation.
<Button
title="Submit Form"
onPress={() => {
// get current form values
const currFormValues = methods.getValues();
// Prevalidate using zod's safeParse
const result = signUpFormSchema.safeParse(currFormValues);
// If prevalidation is failed, display the error
if (!result.success) {
Alert.alert(JSON.stringify(result.error));
} else {
// If prevalidation is successful, notify the user
Alert.alert("Validation is successful with zod");
}
}}
/>
Hãy cùng phân tích đoạn code trên:
-
Sự kiện onPress của Button được dùng để chạy một hàm thực hiện validation trước khi submit form.
-
Phương thức getValues từ methods (do React Hook Form cung cấp) được dùng để lấy các giá trị hiện tại của form.
-
Các giá trị này sau đó được truyền vào phương thức safeParse của signUpFormSchema (schema zod mà chúng ta tạo ở đầu bài). Đây là bước validation trước bằng zod. Khác với phương thức parse của zod, safeParse không throw lỗi khi validation thất bại. Thay vào đó, nó trả về một object chứa giá trị boolean success và, nếu validation thất bại, một object error.
-
Một câu lệnh điều kiện kiểm tra xem result.success có phải false hay không (nghĩa là validation thất bại). Nếu là false, nó hiện một alert hiển thị lỗi validation.
-
Nếu result.success là true (nghĩa là validation thành công), nó hiện một alert báo rằng validation với zod đã thành công.
Dù cách này có vẻ thừa, vì handleSubmit của React Hook Form đã validate form bằng schema được cung cấp qua zod, nó vẫn có ích trong một số trường hợp cụ thể. Ví dụ, bạn có thể muốn thực hiện một số hành động chỉ sau khi validate thủ công, hoặc muốn validate input của form theo thời gian thực khi người dùng đang điền form. Trong những trường hợp đó, validation trước bằng phương thức safeParse của zod khá hữu ích.
Và đây là object lỗi của zod sẽ trông như thế nào:
{
"issues": [
{
"code": "invalid_type",
"expected": "string",
"received": "undefined",
"path": [
"name"
],
"message": "This field is required"
},
{
"code": "invalid_type",
"expected": "string",
"received": "undefined",
"path": [
"surname"
],
"message": "This field is required"
},
{
"code": "invalid_type",
"expected": "string",
"received": "undefined",
"path": [
"phoneNumber"
],
"message": "This field is required"
},
{
"code": "invalid_type",
"expected": "string",
"received": "undefined",
"path": [
"email"
],
"message": "This field is required"
},
{
"expected": "'Male' | 'Female' | 'Other'",
"received": "undefined",
"code": "invalid_type",
"path": [
"gender"
],
"message": "This field is required"
},
{
"code": "too_big",
"message": "Invalid date time, too young",
"inclusive": true,
"exact": false,
"maximum": 1672531200000,
"type": "date",
"path": [
"birthDate"
]
}
],
"name": "ZodError"
}
Đây thực sự là một object lớn, và có thể có cả những field không cần thiết cho trường hợp của chúng ta. May mắn là zod có sẵn một phương thức để định dạng lỗi.
Chúng ta chỉ cần dùng result.error.format() và phần còn lại sẽ được zod xử lý bên trong.
if (!result.success) {
// Format errors using result.error.format()
const formattedError = result.error.format();
Alert.alert(JSON.stringify(formattedError));
} else {
Alert.alert("Validation is successful with zod");
}
Object lỗi sau khi định dạng sẽ trông như sau:
{
"name": {
"_errors": [
"This field is required"
]
},
"surname": {
"_errors": [
"This field is required"
]
},
"phoneNumber": {
"_errors": [
"This field is required"
]
},
"email": {
"_errors": [
"This field is required"
]
},
"gender": {
"_errors": [
"This field is required"
]
},
"birthDate": {
"_errors": [
"Invalid date time, too young"
]
}
}
Code mới nhất
Dưới đây là phiên bản code mới nhất (không bao gồm import và style). Nếu bạn muốn xem toàn bộ source code, hãy xem ở cuối bài viết.
// imports...
export const SignupForm: React.FC = () => {
const [shouldValidateWithZod, setShouldValidateWithZod] =
React.useState<boolean>(false);
const [isCalendarOpenForAndroid, setIsCalendarOpenForAndroid] =
React.useState<boolean>(false);
const methods = useForm<SignUpFormSchema>({
resolver: zodResolver(signUpFormSchema),
defaultValues: {
birthDate: new Date(),
},
mode: "onBlur",
});
const onSubmit: SubmitHandler<SignUpFormSchema> = (data) => {
console.log(JSON.stringify(data));
};
const onError: SubmitErrorHandler<SignUpFormSchema> = (errors, e) => {
console.log(JSON.stringify(errors));
Alert.alert("Warning", getReadableValidationErrorMessage(errors));
};
return (
<SafeAreaView edges={["top", "bottom"]} style={styles.safeArea}>
<ScrollView>
<Text style={styles.title}>Sign Up Form</Text>
<View style={styles.root}>
<FormProvider {...methods}>
<Controller
control={methods.control}
name="name"
render={({
field: { onChange, onBlur, value },
fieldState: { error },
}) => {
return (
<TextInput
label="Name"
onBlur={onBlur}
value={value}
onChangeText={onChange}
errorMessage={error?.message}
/>
);
}}
/>
<View style={styles.spacing} />
<Controller
control={methods.control}
name="surname"
render={({
field: { onChange, onBlur, value },
fieldState: { error },
}) => {
return (
<TextInput
label="Surname"
onBlur={onBlur}
value={value}
onChangeText={onChange}
errorMessage={error?.message}
/>
);
}}
/>
<View style={styles.spacing} />
<Controller
control={methods.control}
name="email"
render={({
field: { onChange, onBlur, value },
fieldState: { error },
}) => {
return (
<TextInput
label="Email"
onBlur={onBlur}
value={value}
onChangeText={onChange}
errorMessage={error?.message}
/>
);
}}
/>
<View style={styles.spacing} />
<Controller
control={methods.control}
name="phoneNumber"
render={({
field: { onChange, onBlur, value },
fieldState: { error },
}) => {
return (
<TextInput
label="Phone number"
onBlur={onBlur}
keyboardType="decimal-pad"
value={value}
onChangeText={(val) => onChange(val.toString())}
errorMessage={error?.message}
/>
);
}}
/>
<View style={styles.spacing} />
<Controller
control={methods.control}
name="birthDate"
render={({
field: { onChange, value },
fieldState: { error },
}) => {
return (
<View style={styles.dateWrapper}>
<Text style={styles.label}>Birth date</Text>
{Platform.OS === "android" && (
<Button
onPress={() => {
setIsCalendarOpenForAndroid(true);
}}
title={value.toString()}
/>
)}
{(isCalendarOpenForAndroid ||
Platform.OS !== "android") && (
<RNDateTimePicker
value={value}
style={styles.dateTimePicker}
mode={"date"}
onChange={(e) => {
if (Platform.OS === "android") {
setIsCalendarOpenForAndroid(false);
}
if (e.type === "set" && e.nativeEvent.timestamp) {
onChange(new Date(e.nativeEvent.timestamp));
methods.trigger("birthDate");
}
}}
/>
)}
{!!error?.message && (
<Text style={styles.errorMessageText}>
{error.message}
</Text>
)}
</View>
);
}}
/>
<View style={styles.spacing} />
<Controller
control={methods.control}
name="gender"
render={({
field: { onChange, onBlur, value, ref },
fieldState: { error },
}) => {
return (
<View style={styles.genderWrapper}>
<Text style={styles.label}>Gender</Text>
<View style={styles.genderOptionsWrapper}>
{GENDER_OPTIONS.map((genderOption) => (
<Pressable
key={genderOption}
style={[
styles.genderOptionPressable,
{
backgroundColor:
value === genderOption ? "#007BFF" : "#F2F2F2",
},
]}
onPress={() => onChange(genderOption)}
>
<Text
style={[
styles.genderOptionText,
{
color: value === genderOption ? "#fff" : "#000",
},
]}
>
{genderOption}
</Text>
</Pressable>
))}
</View>
{!!error?.message && (
<Text style={styles.errorMessageText}>
{error.message}
</Text>
)}
</View>
);
}}
/>
<View style={styles.spacing} />
<Text style={styles.label}>Should validate with zod</Text>
<Switch
value={shouldValidateWithZod}
onChange={(e) => setShouldValidateWithZod(e.nativeEvent.value)}
/>
<View style={styles.spacing} />
<Button
onPress={
shouldValidateWithZod
? () => {
/** we could also prevalidate using zod like below */
// get current form values
const currFormValues = methods.getValues();
// https://zod.dev/?id=safeparse
const result = signUpFormSchema.safeParse(currFormValues);
if (!result.success) {
const formattedError = result.error.format();
Alert.alert(JSON.stringify(formattedError));
} else {
Alert.alert("Validation is successful with zod");
}
}
: methods.handleSubmit(onSubmit, onError)
}
title="Submit Form"
color={"#007BFF"}
/>
</FormProvider>
</View>
</ScrollView>
</SafeAreaView>
);
};
// styles...
App mẫu này được viết bằng expo go. Nghĩa là bạn có thể dễ dàng thử nó bằng mã QR bên dưới! (nếu mã QR không hoạt động, hãy xem link source code ở cuối bài viết.)

Kết luận
Trong bài viết này, chúng ta đã tìm hiểu cách tận dụng hiệu quả sự kết hợp giữa React Hook Form, Zod và TypeScript để tạo validation form chắc chắn trong ứng dụng React Native. Chúng ta đã thấy sự linh hoạt và sức mạnh của các thư viện này giúp viết code gọn gàng, type-safe và có thể xử lý những yêu cầu validation phức tạp.
Sự phối hợp giữa React Hook Form và Zod cho phép chúng ta tận dụng ưu điểm của cả hai. React Hook Form đơn giản hóa việc xử lý form, tối ưu re-render và có các tính năng như quản lý state của form và xử lý lỗi. Mặt khác, Zod bổ sung thêm một lớp an toàn, cho phép chúng ta quy định loại dữ liệu nào được phép cho từng field của form và bắt buộc tuân theo các quy tắc đó.
Hãy nhớ rằng, dù các kỹ thuật ở đây được dùng trong bối cảnh một form SignUp đơn giản, chúng áp dụng được cho mọi dạng nhập liệu qua form trong các ứng dụng React Native của bạn. Áp dụng những chiến lược này, bạn có thể đảm bảo form của mình thân thiện với người dùng, chắc chắn và dễ bảo trì, từ đó mang lại trải nghiệm người dùng tốt hơn và ứng dụng ổn định hơn.