الگوی فیلد کسبوکاری استاندارد DastRanj و VahedYek — label بالای کنترل، متن راهنمای ثابت زیر فیلد، و اولویت بصری روشن برای خطا و وضعیت.
import { TaavFieldBlock, TaavInput, TaavChoiceChipGroup } from "@repo/ui/taav/forms";فقط از props رسمی TaavUI استفاده کنید. unsafeClassName و escape hatchهای مشابه فقط برای موارد نادر هستند و نباید در مثالهای عادی دیده شوند.
در TaavUI، tooltip برای متن راهنمای همیشهنمایان زیر فیلد استفاده میشود؛ نه tooltip شناور، نه آیکن راهنما، و نه hover interaction.
برای انتخابهای محدود و قابل مشاهده، از Choice Chip استفاده میشود؛ نه Dropdown. این باعث میشود گزینهها سریعتر دیده و انتخاب شوند. از TaavSelect فقط برای لیستهای بلند، پویا، یا گزینههایی که جا نمیشوند استفاده کنید.
چیدمان مرجع برای فرمهای دو ستونه کسبوکار در VahedYek و DastRanj
نام رسمی ثبت شده در اداره ثبت شرکت ها
نام تجاری جهت نمایش در سامانه
شناسه ملی اشخاص حقوقی برای تمامی شرکت ها اجباری است
شماره اختصاصی ثبت در اداره ثبت شرکت ها
<TaavFieldBlock label="نام قانونی شرکت / کسب و کار" required tooltip="نام رسمی ثبت شده در اداره ثبت شرکت ها" > <TaavInput size="lg" radius="xl" /> </TaavFieldBlock>
این متن همیشه زیر فیلد دیده میشود و tooltip شناور نیست.
در URL عمومی یا گزارشهای فشرده استفاده میشود.
نوع ساختار حقوقی کسبوکار را انتخاب کنید.
بهتر است نوع شخصیت را با اسناد ثبتی تطبیق دهید.
این متن در پروفایل کسبوکار نمایش داده میشود.
متن شرح فعالیت آماده انتشار است.
نام و نام خانوادگی نماینده پاسخگو را وارد کنید.
نوع ساختار حقوقی کسبوکار را انتخاب کنید.
اگر جزئیات بیشتری لازم است، این بخش بهترین محل برای درج آن است.
توضیح تکمیلی باید حداقل ۲۰ کاراکتر باشد.
<TaavFieldBlock
label="نوع کسبوکار"
tooltip="نوع ساختار حقوقی کسبوکار را انتخاب کنید."
>
<TaavChoiceChipGroup
ariaLabel="نوع کسبوکار"
options={companyTypeOptions}
value={businessType}
onValueChange={setBusinessType}
size="md"
tone="brand"
/>
</TaavFieldBlock>نام رسمی ثبت شده در اداره ثبت شرکت ها
نام تجاری جهت نمایش در سامانه
شناسه ملی اشخاص حقوقی برای تمامی شرکت ها اجباری است
شماره اختصاصی ثبت در اداره ثبت شرکت ها
نام رسمی ثبت شده در اداره ثبت شرکت ها
نام تجاری جهت نمایش در سامانه
شناسه ملی اشخاص حقوقی برای تمامی شرکت ها اجباری است
شماره اختصاصی ثبت در اداره ثبت شرکت ها
| Prop | نوع | پیشفرض | توضیح |
|---|---|---|---|
label* | ReactNode | — | عنوان فیلد بالای کنترل |
required / optional | boolean | — | نمایش ستاره الزامی یا برچسب اختیاری |
tooltip / hint / supportText | ReactNode | — | متن راهنمای ثابت زیر فیلد؛ نه hover tooltip |
description | ReactNode | — | fallback برای support text وقتی tooltip/hint/supportText داده نشده باشد |
error / warning / success | ReactNode | — | پیام وضعیت زیر support text؛ error اولویت بالاتر دارد |
htmlFor | string | — | اتصال label به کنترل |
size | 'sm' | 'md' | 'lg' | md | spacing و تایپوگرافی الگو |
align | 'start' | 'center' | 'end' | 'stretch' | stretch | تراز container کلی |
labelAlign / tooltipAlign | 'start' | 'center' | 'end' | start | تراز label و متن راهنما |
invalid / disabled | boolean | — | state بصری wrapper |
children* | ReactNode | — | TaavInput / TaavSelect / TaavTextarea یا کنترل سفارشی |