TaavUI Lab
Primitive

TaavFieldHint

بلوک راهنما، اطلاعات، موفقیت، هشدار یا خطا کنار فیلدهای فرم.

import { TaavFieldHint } from '@repo/ui';

فقط از props رسمی TaavUI استفاده کنید. unsafeClassName و escape hatchهای مشابه فقط برای موارد نادر هستند و نباید در مثال‌های عادی دیده شوند.

استفاده پایه

RTL Preview
راهنماشماره موبایل باید با 09 شروع شود.
<TaavFieldHint tone="info" title="راهنما" icon={<Info />}>...</TaavFieldHint>

Tones

پیش‌نمایش
neutralپیام نمونه برای tone=neutral
infoپیام نمونه برای tone=info
successپیام نمونه برای tone=success
warningپیام نمونه برای tone=warning
dangerپیام نمونه برای tone=danger

Props

Propنوعپیش‌فرضتوضیح
tone'neutral' | 'info' | 'success' | 'warning' | 'danger'neutralنوع پیام
size'sm' | 'md'mdتراکم متن
iconReactNodeآیکون راهنما
titlestringعنوان کوتاه
childrenReactNodeمتن راهنما یا خطا

Design Specs

Gapvar(--taav-field-hint-gap)
Padding mdvar(--taav-field-hint-padding-md)
Radiusvar(--taav-field-hint-radius)
Font mdvar(--taav-text-sm)
helper only

دسترس‌پذیری

راهنمای استفاده در DastRanj / VahedYek

  • از role=note برای پیام‌های تکمیلی استفاده می‌شود.
  • برای خطا، title کوتاه و children توضیحی باشد.
  • در VahedYek زیر فیلدهای حساس مالی از tone=warning استفاده کنید.

Do / Don't

انجام دهید

  • tone را مطابق نوع پیام انتخاب کنید

انجام ندهید

  • این کامپوننت را جایگزین validation logic نکنید