Files
gh-jezweb-claude-skills-ski…/templates/advanced-form.tsx
2025-11-30 08:25:27 +08:00

428 lines
13 KiB
TypeScript

/**
* Advanced Form Example - User Profile with Nested Objects and Arrays
*
* Demonstrates:
* - Nested object validation (address)
* - Array field validation (skills)
* - Conditional field validation
* - Complex Zod schemas with refinements
* - Type-safe nested error handling
*/
import { useForm } from 'react-hook-form'
import { zodResolver } from '@hookform/resolvers/zod'
import { z } from 'zod'
// Define nested schemas
const addressSchema = z.object({
street: z.string().min(1, 'Street is required'),
city: z.string().min(1, 'City is required'),
state: z.string().min(2, 'State must be at least 2 characters'),
zipCode: z.string().regex(/^\d{5}(-\d{4})?$/, 'Invalid ZIP code format'),
country: z.string().min(1, 'Country is required'),
})
// Complex schema with nested objects and arrays
const profileSchema = z.object({
// Basic fields
firstName: z.string().min(2, 'First name must be at least 2 characters'),
lastName: z.string().min(2, 'Last name must be at least 2 characters'),
email: z.string().email('Invalid email address'),
phone: z.string().regex(/^\+?[1-9]\d{1,14}$/, 'Invalid phone number').optional(),
// Nested object
address: addressSchema,
// Array of strings
skills: z.array(z.string().min(1, 'Skill cannot be empty'))
.min(1, 'At least one skill is required')
.max(10, 'Maximum 10 skills allowed'),
// Conditional fields
isStudent: z.boolean(),
school: z.string().optional(),
graduationYear: z.number().int().min(1900).max(2100).optional(),
// Enum
experience: z.enum(['junior', 'mid', 'senior', 'lead'], {
errorMap: () => ({ message: 'Please select experience level' }),
}),
// Number with constraints
yearsOfExperience: z.number()
.int('Must be a whole number')
.min(0, 'Cannot be negative')
.max(50, 'Must be 50 or less'),
// Date
availableFrom: z.date().optional(),
// Boolean
agreedToTerms: z.boolean().refine((val) => val === true, {
message: 'You must agree to the terms and conditions',
}),
})
.refine((data) => {
// Conditional validation: if isStudent is true, school is required
if (data.isStudent && !data.school) {
return false
}
return true
}, {
message: 'School is required for students',
path: ['school'],
})
.refine((data) => {
// Experience level should match years of experience
if (data.experience === 'senior' && data.yearsOfExperience < 5) {
return false
}
return true
}, {
message: 'Senior level requires at least 5 years of experience',
path: ['yearsOfExperience'],
})
type ProfileFormData = z.infer<typeof profileSchema>
export function AdvancedProfileForm() {
const {
register,
handleSubmit,
watch,
formState: { errors, isSubmitting },
setValue,
} = useForm<ProfileFormData>({
resolver: zodResolver(profileSchema),
defaultValues: {
firstName: '',
lastName: '',
email: '',
phone: '',
address: {
street: '',
city: '',
state: '',
zipCode: '',
country: 'USA',
},
skills: [''], // Start with one empty skill
isStudent: false,
school: '',
experience: 'junior',
yearsOfExperience: 0,
agreedToTerms: false,
},
})
// Watch isStudent to conditionally show school field
const isStudent = watch('isStudent')
const onSubmit = async (data: ProfileFormData) => {
console.log('Profile data:', data)
// API call
}
return (
<form onSubmit={handleSubmit(onSubmit)} className="space-y-6 max-w-2xl mx-auto">
<h2 className="text-3xl font-bold">User Profile</h2>
{/* Basic Information */}
<section className="space-y-4">
<h3 className="text-xl font-semibold">Basic Information</h3>
<div className="grid grid-cols-2 gap-4">
<div>
<label htmlFor="firstName" className="block text-sm font-medium mb-1">
First Name *
</label>
<input
id="firstName"
{...register('firstName')}
className="w-full px-3 py-2 border rounded-md"
/>
{errors.firstName && (
<span role="alert" className="text-sm text-red-600 mt-1 block">
{errors.firstName.message}
</span>
)}
</div>
<div>
<label htmlFor="lastName" className="block text-sm font-medium mb-1">
Last Name *
</label>
<input
id="lastName"
{...register('lastName')}
className="w-full px-3 py-2 border rounded-md"
/>
{errors.lastName && (
<span role="alert" className="text-sm text-red-600 mt-1 block">
{errors.lastName.message}
</span>
)}
</div>
</div>
<div>
<label htmlFor="email" className="block text-sm font-medium mb-1">
Email *
</label>
<input
id="email"
type="email"
{...register('email')}
className="w-full px-3 py-2 border rounded-md"
/>
{errors.email && (
<span role="alert" className="text-sm text-red-600 mt-1 block">
{errors.email.message}
</span>
)}
</div>
<div>
<label htmlFor="phone" className="block text-sm font-medium mb-1">
Phone (Optional)
</label>
<input
id="phone"
type="tel"
{...register('phone')}
placeholder="+1234567890"
className="w-full px-3 py-2 border rounded-md"
/>
{errors.phone && (
<span role="alert" className="text-sm text-red-600 mt-1 block">
{errors.phone.message}
</span>
)}
</div>
</section>
{/* Address (Nested Object) */}
<section className="space-y-4">
<h3 className="text-xl font-semibold">Address</h3>
<div>
<label htmlFor="street" className="block text-sm font-medium mb-1">
Street *
</label>
<input
id="street"
{...register('address.street')}
className="w-full px-3 py-2 border rounded-md"
/>
{errors.address?.street && (
<span role="alert" className="text-sm text-red-600 mt-1 block">
{errors.address.street.message}
</span>
)}
</div>
<div className="grid grid-cols-2 gap-4">
<div>
<label htmlFor="city" className="block text-sm font-medium mb-1">
City *
</label>
<input
id="city"
{...register('address.city')}
className="w-full px-3 py-2 border rounded-md"
/>
{errors.address?.city && (
<span role="alert" className="text-sm text-red-600 mt-1 block">
{errors.address.city.message}
</span>
)}
</div>
<div>
<label htmlFor="state" className="block text-sm font-medium mb-1">
State *
</label>
<input
id="state"
{...register('address.state')}
className="w-full px-3 py-2 border rounded-md"
/>
{errors.address?.state && (
<span role="alert" className="text-sm text-red-600 mt-1 block">
{errors.address.state.message}
</span>
)}
</div>
</div>
<div className="grid grid-cols-2 gap-4">
<div>
<label htmlFor="zipCode" className="block text-sm font-medium mb-1">
ZIP Code *
</label>
<input
id="zipCode"
{...register('address.zipCode')}
placeholder="12345 or 12345-6789"
className="w-full px-3 py-2 border rounded-md"
/>
{errors.address?.zipCode && (
<span role="alert" className="text-sm text-red-600 mt-1 block">
{errors.address.zipCode.message}
</span>
)}
</div>
<div>
<label htmlFor="country" className="block text-sm font-medium mb-1">
Country *
</label>
<input
id="country"
{...register('address.country')}
className="w-full px-3 py-2 border rounded-md"
/>
{errors.address?.country && (
<span role="alert" className="text-sm text-red-600 mt-1 block">
{errors.address.country.message}
</span>
)}
</div>
</div>
</section>
{/* Skills (Array - simplified for advanced-form, see dynamic-fields.tsx for full array handling) */}
<section className="space-y-4">
<h3 className="text-xl font-semibold">Skills</h3>
<p className="text-sm text-gray-600">
Enter skills separated by commas (handled as string for simplicity in this example)
</p>
<div>
<label htmlFor="skills" className="block text-sm font-medium mb-1">
Skills (comma-separated) *
</label>
<input
id="skills"
{...register('skills.0')} // Simplified - see dynamic-fields.tsx for proper array handling
placeholder="React, TypeScript, Node.js"
className="w-full px-3 py-2 border rounded-md"
/>
{errors.skills && (
<span role="alert" className="text-sm text-red-600 mt-1 block">
{errors.skills.message || errors.skills[0]?.message}
</span>
)}
</div>
</section>
{/* Experience */}
<section className="space-y-4">
<h3 className="text-xl font-semibold">Experience</h3>
<div>
<label htmlFor="experience" className="block text-sm font-medium mb-1">
Experience Level *
</label>
<select
id="experience"
{...register('experience')}
className="w-full px-3 py-2 border rounded-md"
>
<option value="junior">Junior</option>
<option value="mid">Mid-Level</option>
<option value="senior">Senior</option>
<option value="lead">Lead</option>
</select>
{errors.experience && (
<span role="alert" className="text-sm text-red-600 mt-1 block">
{errors.experience.message}
</span>
)}
</div>
<div>
<label htmlFor="yearsOfExperience" className="block text-sm font-medium mb-1">
Years of Experience *
</label>
<input
id="yearsOfExperience"
type="number"
{...register('yearsOfExperience', { valueAsNumber: true })}
className="w-full px-3 py-2 border rounded-md"
/>
{errors.yearsOfExperience && (
<span role="alert" className="text-sm text-red-600 mt-1 block">
{errors.yearsOfExperience.message}
</span>
)}
</div>
</section>
{/* Conditional Fields */}
<section className="space-y-4">
<h3 className="text-xl font-semibold">Education</h3>
<div className="flex items-center">
<input
id="isStudent"
type="checkbox"
{...register('isStudent')}
className="h-4 w-4 rounded"
/>
<label htmlFor="isStudent" className="ml-2 text-sm">
I am currently a student
</label>
</div>
{/* Conditional field - only show if isStudent is true */}
{isStudent && (
<div>
<label htmlFor="school" className="block text-sm font-medium mb-1">
School Name *
</label>
<input
id="school"
{...register('school')}
className="w-full px-3 py-2 border rounded-md"
/>
{errors.school && (
<span role="alert" className="text-sm text-red-600 mt-1 block">
{errors.school.message}
</span>
)}
</div>
)}
</section>
{/* Terms and Conditions */}
<section className="space-y-4">
<div className="flex items-start">
<input
id="agreedToTerms"
type="checkbox"
{...register('agreedToTerms')}
className="h-4 w-4 rounded mt-1"
/>
<label htmlFor="agreedToTerms" className="ml-2 text-sm">
I agree to the terms and conditions *
</label>
</div>
{errors.agreedToTerms && (
<span role="alert" className="text-sm text-red-600 block">
{errors.agreedToTerms.message}
</span>
)}
</section>
{/* Submit Button */}
<button
type="submit"
disabled={isSubmitting}
className="w-full px-4 py-2 bg-blue-600 text-white rounded-md hover:bg-blue-700 disabled:bg-gray-400"
>
{isSubmitting ? 'Saving...' : 'Save Profile'}
</button>
</form>
)
}