پرش به مطلب اصلی

Tab Panel

کامپوننت‌های x-tab-panel و x-tab-panel-item برای ساخت تب‌بندی (Tab Panel) در صفحات Blade استفاده می‌شوند. این کامپوننت‌ها امکان نمایش تب‌های افقی یا عمودی با قابلیت شخصی‌سازی کامل را فراهم می‌کنند و برای نمایش محتوای دسته‌بندی‌شده یا فرم‌های چندبخشی بسیار مناسب هستند.


ویژگی‌ها

  • پشتیبانی از نمایش تب‌ها به صورت افقی (horizontal) یا عمودی (vertical)
  • امکان تعیین شناسه یکتا (id) و کلاس سفارشی برای ظرف اصلی، ناوبری تب‌ها و محتوای تب‌ها
  • قابلیت تعیین عنوان کلی برای پنل تب‌ها
  • امکان تعیین تعداد تب‌های اسکلتی (در حالت لودینگ)
  • پشتیبانی از تعیین عنوان، فعال بودن، بج (badge) و کلاس سفارشی برای هر تب
  • کاملاً واکنش‌گرا و قابل استفاده در هر جای قالب Blade

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

x-tab-panel

نام پراپنوع دادهمقدار پیش‌فرضتوضیحات
idstringnullشناسه یکتا برای TabPanel (در صورت عدم تعیین، تصادفی ساخته می‌شود)
orientationstring'vertical'جهت نمایش تب‌ها (vertical یا horizontal)
containerClassstringnullکلاس CSS اضافی برای ظرف اصلی TabPanel
navClassstringnullکلاس CSS اضافی برای بخش ناوبری تب‌ها
contentClassstringnullکلاس CSS اضافی برای بخش محتوای تب‌ها
titlestringnullعنوان کلی برای TabPanel (اختیاری)
countint3تعداد تب‌های اسکلتی (در حالت لودینگ یا Skeleton)

x-tab-panel-item

نام پراپنوع دادهمقدار پیش‌فرضتوضیحات
idstringتصادفیشناسه یکتا برای هر تب (در صورت عدم تعیین، تصادفی ساخته می‌شود)
activeboolfalseفعال بودن تب (برای نمایش تب به صورت فعال)
titlestringnullعنوان تب (اختیاری)
classstringnullکلاس CSS اضافی برای تب
badgestringnullمقدار بج (مثلاً تعداد یا وضعیت)

نکات مهم
  • مقدار orientation فقط باید یکی از مقادیر vertical یا horizontal باشد. در صورت مقدار نامعتبر، خطا رخ می‌دهد.
  • مقدار id در هر دو کامپوننت در صورت عدم تعیین، به صورت تصادفی ساخته می‌شود تا از تداخل جلوگیری شود.
  • برای نمایش تب فعال، پراپ active را روی true قرار دهید.
  • برای نمایش بج کنار عنوان تب، پراپ badge را مقداردهی کنید.

مثال‌ها

نمونه پایه

<x-tab-panel title="منوی کاربر">

<x-tab-item id="tab-1" title="ویرایش کاربر">
<div>لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت</div>
</x-tab-item>

<x-tab-item id="tab-2" active="true" title="تاریخچه ورود">
<div>لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت</div>
</x-tab-item>

<x-tab-item id="tab-3" title="تاریخچه عملیات" badge="990">
<div>لورم ایپسوم متن ساختگی با تولید سادگی نامفهوم از صنعت</div>
</x-tab-item>

</x-tab-panel>