تم تاریک
لیست ریسورس Resource List
این پترن به صورت اختصاصی برای مدیریت منابع در پنل طراحی شده است و از اصول کلی پترن لیست پیروی میکند. رعایت پیشنیازهای پترن لیست برای پیادهسازی این بخش الزامی است.
آناتومی و اجزای تشکیلدهنده
لیست منابع از سه ناحیه اصلی تشکیل شده است که هر کدام با کامپوننتهای استاندارد سیستم طراحی (سرخآب) مطابقت دارند:
۱. ناحیه کنترل
این بخش در بالای لیست قرار گرفته و مسئولیت مدیریت ورودیها و اقدامات کلی را بر عهده دارد.
| جزء | کامپوننت متناظر | عملکرد و ملاحظات |
|---|---|---|
| جستوجو | SearchInput | جستوجوی کلیدواژه در نام منابع و ستونهای اصلی. |
| اقدام اولیه | Primary Button | ایجاد منبع جدید (مانند Create VM). در سمت چپِ subheader قرار میگیرد. |
| فیلترها | Filter | محدودسازی بر اساس Status یا Region. نمایش تعداد فیلترهای فعال الزامی است. |
۲. نمای دادهها
نمایش پیشفرض برای تمام لیستهای منابع، Table View است.
| جزء | کامپوننت متناظر | عملکرد و ملاحظات |
|---|---|---|
| هدر جدول | TableHeader | شامل نام ستونها با قابلیت مرتبسازی (Sorting). |
| انتخابگر | Checkbox | جهت فعالسازی اقدامات چندگانه (Bulk Actions). |
| نام منبع | Link Button | باید لینک باشد و به صفحه Details Page هدایت کند. |
| وضعیت | Badge | نمایش وضعیت عملیاتی (Status) با رنگهای استاندارد سیستم. |
| اقدامات | IconButton | دسترسی سریع به Edit یا Delete برای هر ردیف. |
نمای پیشفرض و سازگاری
جدول (Table) به دلیل توانایی بالا در مقایسه دادههای فنی، نمایش استاندارد محصولات ابری است.
- نمای کارتی (Card View): تنها به عنوان نمای ثانویه و برای منابعی که نیاز به تاکید بصری (تصویر یا نمودار) دارند، ارایه میشود.
- سوییچ نما: در صورت وجود هر دو نما، کنترلر تغییر نما باید در ناحیه Control Area قرار گیرد.
- حفظ حالت (Persistence): سیستم باید آخرین نمای انتخاب شده توسط کاربر را برای هر محصول به خاطر بسپارد.
وضعیتهای لیست
حالتهای داده
مدیریت صحیح وضعیتهای مختلف لیست برای جلوگیری از سردرگمی کاربر حیاتی است:
- بارگذاری (Loading): همیشه از Skeleton States استفاده کنید. نمایش اسپینر یا صفحه خالی مجاز نیست.
- خالی (Empty State): وقتی منبعی وجود ندارد؛ شامل پیام راهنما و دکمه CTA برای «ایجاد اولین منبع».
- بدون نتیجه (No Results): وقتی فیلترها موردی پیدا نمیکنند؛ شامل دکمه «حذف فیلترها». در این حالت CTA ساخت منبع نمایش داده نشود.
- خطا (Error): نمایش پیام خطا به همراه دکمه Retry.
مدیریت اقدامات انبوه
برای مدیریت همزمان چندین منبع، از نوار ابزار هوشمند استفاده میشود:
- نوار ابزار چسبان (Sticky Toolbar): به محض انتخاب اولین چکباکس، این نوار ظاهر میشود.
- هماهنگی وضعیت: اگر اقدامی برای برخی منابع انتخابی غیرمجاز است (مثلاً Delete برای منبعی که در حال ساخت است)، آن دکمه در نوار ابزار باید Disabled شود.
کنترلهای پایین صفحه
برای مدیریت حجم بالای دادهها، از کامپوننت صفحهبندی در انتهای لیست استفاده میشود.
| جزء | عملکرد |
|---|---|
| صفحهبندی | امکان جابجایی بین صفحات و تغییر تعداد آیتمها (۲۰، ۵۰، ۱۰۰ مورد). |