کد ملی

فیلد کد ملی با اعتبارسنجی رقم کنترل؛ ارقام فارسی و انگلیسی را می‌پذیرد.

import { NationalIdInput } from "@kashi-ui/react";

نمونه

یک کد ملی آزمایشی معتبر: 0013542419. یک رقم آخر را عوض کنید تا خطا را ببینید.

کد ملی

۱۰ رقم؛ ارقام فارسی و انگلیسی هر دو پذیرفته می‌شوند.

0 از ۱۰ رقم

<NationalIdInput
label="کد ملی"
name="nationalId"
onValueChange={(value, valid) => console.log(value, valid)}
/>

ارقام: کاربر می‌تواند با صفحه‌کلید فارسی یا انگلیسی تایپ کند. نمایش با ارقام فارسی است (digits="latin" برای انگلیسی)، ولی مقدار همیشه با ارقام انگلیسی به شما داده می‌شود.
محدودیت: هر نویسهٔ غیر رقمی حذف می‌شود و بیش از ۱۰ رقم پذیرفته نمی‌شود. در گوشی، صفحه‌کلید عددی باز می‌شود.
اعتبارسنجی: رقم دهم با الگوریتم رسمی رقم کنترل بررسی می‌شود. پیام خطا فقط پس از خروج از فیلد یا کامل شدن ۱۰ رقم نمایش داده می‌شود، نه هنگام تایپ.
فرم: با name، مقدار با ارقام انگلیسی در یک فیلد مخفی ارسال می‌شود.

اعتبارسنجی رقم کنترل فقط درستی ساختار کد را نشان می‌دهد، نه وجود آن را. برای احراز هویت، کد را با سرویس رسمی استعلام کنید.

نام	نوع	پیش‌فرض	توضیح
`value`	`string`	—	مقدار کنترل‌شده با ارقام انگلیسی
`defaultValue`	`string`	`""`	مقدار اولیه
`onValueChange`	`(value: string, valid: boolean) => void`	—	با هر تغییر
`digits`	`"fa" \| "latin"`	`"fa"`	خط ارقام نمایشی
`invalidMessage`	`ReactNode`	`"کد ملی معتبر نیست."`	پیام خطا
`name`	`string`	—	نام فیلد مخفی فرم

همهٔ ویژگی‌های Input مثل label، hint، error و required هم پشتیبانی می‌شوند.

import { isValidNationalId } from "@kashi-ui/persian";

isValidNationalId("۰۰۱۳۵۴۲۴۱۹"); // true
isValidNationalId("1111111111"); // false