TaavUI Lab
Business Components

TaavBusinessSectionToolbarCard

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

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

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

این کامپوننت برای سربرگ‌های مدیریتیِ بخش‌های داخلی استفاده می‌شود. در این الگو، محتوای اصلی کارت نمایشی است و اکشن کمکی، جستجو و فلش ناوبری برای دسترسی سریع به مسیر بعدی یا عملیات مرتبط در نظر گرفته شده‌اند.

نمونه‌های مدیریتی

با اکشن · search + action

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

ثبت و مدیریت اطلاعات نماینده قانونی، صاحب امضا و دسترسی‌های رسمی این بخش

لیست کارمندان / اعضا

ثبت و مدیریت کارمندها و اعضای مرتبط با همین بخش، با دسترسی سریع به جستجو

فهرست واحدها

نمایش و مدیریت واحدهای زیرمجموعه با امکان جستجو و ثبت سریع واحد جدید

تم روشن

همان الگوی مدیریتی در تم روشن هم باید قابل مشاهده باشد تا تضاد رنگی و مرزها در هر دو تم بررسی شوند.

light theme

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

ثبت و مدیریت اطلاعات نماینده قانونی، صاحب امضا و دسترسی‌های رسمی این بخش

بدون اکشن

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

non-interactive toolbar card

لیست کارمندان / اعضا

ثبت و مدیریت کارمندها و اعضای مرتبط با همین بخش، با دسترسی سریع به جستجو

بارگذاری

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

loading skeleton

اکشن غیرفعال

وقتی عملیات برای کاربر در دسترس نیست، دکمه اکشن باید hidden یا disabled شود و خود کارت همچنان قابل مشاهده باقی بماند.

disabled · action hidden

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

ثبت و مدیریت اطلاعات نماینده قانونی، صاحب امضا و دسترسی‌های رسمی این بخش

لیست کارمندان / اعضا

ثبت و مدیریت کارمندها و اعضای مرتبط با همین بخش، با دسترسی سریع به جستجو

فهرست واحدها

نمایش و مدیریت واحدهای زیرمجموعه با امکان جستجو و ثبت سریع واحد جدید

Props

Propنوعپیش‌فرضتوضیح
title*stringعنوان اصلی سربرگ مدیریتی
descriptionstringتوضیح کوتاه زیر عنوان
iconReactNodeآیکن بخش در باکس روشن
showArrowbooleantrueنمایش فلش ناوبری
onArrowClick() => voidرفتار کلیک روی فلش
hrefstringلینک دسترسی برای فلش
search{ value?: string; placeholder?: string; onChange?: (value: string) => void; }بخش جستجو درون کارت
action{ label: string; icon?: ReactNode; onClick?: () => void; disabled?: boolean; }اکشن کمکی کارت
classNamestringافزودن class به shell کارت

Design specs

LayoutRTL افقی — آیکن بخش در راست، عنوان/توضیح در میانه، فلش ناوبری در چپ
Widthfull در مستندات · مشابه کارت‌های مدیریتی 696 تا 720px در نمونه‌های واقعی
Icon container56×56 با پس‌زمینه teal بسیار ملایم و radius نزدیک 17px
Title18px / 600 / راست‌چین / color نزدیک #3f3f46
Description12.5px / 400 / line-height 22px / color نزدیک #52657a
Border / radiusborder نرم و radius حدود 15 تا 16px

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

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

  • فلش ناوبری فقط برای رفتن به مسیر بعدی استفاده شود و اکشن کمکی داخل همان کارت مستقل بماند.
  • اگر action داده نشده باشد، کارت همچنان readable و کامل بماند.
  • در حالت loading، layout نباید تغییر کند و فقط محتوا skeleton شود.
  • متن‌ها در RTL راست‌چین باقی بمانند و spacing بین icon, title, description و action ثابت بماند.

Do / Don't

انجام دهید

  • برای سربرگ‌های مدیریتی بخش، از همین کارت استفاده کنید.
  • action را برای عملیات مهم مثل افزودن یا مدیریت سریع بگذارید.
  • اگر کارت فقط نمایشی است، دکمه اکشن را حذف کنید تا شلوغ نشود.

انجام ندهید

  • این کارت را برای ناوبری عمومی کل محصول استفاده نکنید.
  • در متن‌ها و آیکن‌ها، RTL و هم‌راستایی را به‌هم نزنید.
  • برای این الگو از clone محلی یا صفحه اختصاصی خارج از taav-ui استفاده نکنید.