TaavUI Lab
Business Components

TaavBusinessHeaderCard

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

import { TaavBusinessHeaderCard } from "@repo/ui/taav/business";

کامپوننت اصلی

آیا این تنظیمات بعنوان پیشنهاد در زمان ثبت قرارداد نمایش داده شود؟

با فعال کردن این گزینه، هنگام ثبت قرارداد در صورت عدم رعایت پیش‌پرداخت به کاربر هشدار داده می‌شود.

راهنمای استفاده

این کامپوننت برای بخش‌هایی مثل نماینده قانونی، فهرست کارمندان، فهرست واحدها و حالت‌های تنظیماتی مشابه ساخته شده است. بسته به variant، سوییچ، دکمه اکشن، لینک جزئیات یا جستجو نمایش داده می‌شود.

توکن سوییچ

هزینه‌های جانبی

هزینه‌های ثابت یا درصدی مانند کارمزد اداری، هزینه تشکیل پرونده و هزینه خدمات را در این بخش تعریف کنید.

توکن افزودن

راه‌های ارتباطی

در این بخش می‌توانید آدرس‌ها و شماره‌های تماس با سازمان خود را ثبت نمایید

توکن افزودن و جستجو

نماینده قانونی / صاحب امضا

فردی که اختیار امضای قراردادها و اسناد رسمی را دارد.

توکن فقط اکشن بازگشت

پروفایل کسب و کار

در پروفایل کسب‌وکار اطلاعات هویتی، حقوقی، مالی و تماس شرکت ثبت می‌شود تا مبنای قراردادها، پروژه‌ها و ارتباطات رسمی در سیستم باشد.

code sample

<TaavBusinessHeaderCard
  title="هزینه‌های جانبی"
  description="هزینه‌های ثابت یا درصدی مانند کارمزد اداری، هزینه تشکیل پرونده و هزینه خدمات را در این بخش تعریف کنید."
  icon={<BadgePercent />}
  variant="toggleWithLink"
  enabled={enabled}
  onToggle={setEnabled}
/>

Props

Propنوعپیش‌فرضتوضیح
title*ReactNodeعنوان اصلی سربرگ بیزینسی
descriptionReactNodeتوضیح کوتاه زیر عنوان
iconReactNodeآیکن داخل باکس teal در سمت راست
variant"toggleWithLink" | "toggle" | "action" | "actionWithSearch" | "navigation"نوع چیدمان سربرگ و کنترل‌های داخلی
showArrowbooleanنمایش/عدم نمایش فلش سمت راست
href / onNavigate / onClickstring / fn / fnرفتار فلش یا ناوبری
enabled / defaultEnabled / onToggleboolean / boolean / fnکنترل سوییچ فعال/غیرفعال
toggleLabels{ enabled?: ReactNode; disabled?: ReactNode }برچسب‌های سوییچ
action{ label; icon?; onClick?; disabled? }دکمه اکشن سمت چپ
detailLink{ label; href?; onClick?; disabled? }لینک جزئیات زیر توضیح
search{ value?; placeholder?; onChange?; disabled? }نوار جستجو در variant اکشن
loading / disabledboolean / booleanحالت بارگذاری و غیرفعال
themeMode"auto" | "light" | "dark"هماهنگی با تم روشن یا تیره
className / wrapperClassNamestringسفارشی‌سازی ظاهر کارت

Design specs

Card radiusvar(--taav-business-header-card-radius) / compact
LayoutRTL افقی — فلش راست، آیکن راست، متن میانی، کنترل چپ
Icon box56×56 · var(--taav-business-header-card-icon-radius)
Titlevar(--taav-business-header-card-title-size) / 600 / #30343b
Descriptionvar(--taav-business-header-card-desc-size) / #5f6f80
Action button36px · var(--taav-business-header-card-action-radius/size)

راهنمای رفتاری

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

  • فلش فقط مسیر ناوبری را نشان می‌دهد و کل کارت نباید بی‌دلیل clickable شود.
  • سوییچ فقط در variantهای toggle استفاده شود و حالت فعال/غیرفعال را واضح نگه دارد.
  • دکمه اکشن باید مستقل از فلش باشد و روی دسترسی سریع تمرکز کند.
  • در حالت actionWithSearch، جستجو باید در خط دوم و هم‌راستا با سمت راست کارت قرار بگیرد.

Do / Don't

انجام دهید

  • برای سربرگ‌های مدیریتی از این کارت به‌عنوان الگوی اصلی استفاده کنید.
  • Title و description را کوتاه و راست‌چین نگه دارید.
  • Variant مناسب را بر اساس نیاز واقعی انتخاب کنید.

انجام ندهید

  • برای صفحه‌های عمومی و غیرمدیریتی از این کارت استفاده نکنید.
  • فلش، سوییچ و دکمه اکشن را هم‌زمان بدون نیاز نمایش ندهید.
  • منطق business را داخل کامپوننت سخت‌کد نکنید.