آموزش jQuery Mobile - قابل جمع شدن (Collapsible)
قابل جمع شدن (Collapsible):
Collapsible (قابل جمع) به شما اجازه می دهد تا محتوا را با کلیک بر روی آن گسترش یا جمع کنید. این بسیار مفید برای دستگاه های تلفن همراه است که محتوای کوتاهی را ارائه می دهد.
جدول زیر انواع مختلف ویجت قابل جمع (Collapsible) مورد استفاده در jQuery Mobile را نشان می دهد. −
ردیف | نوع و توضیحات قابل جمع (Collapsible) |
---|---|
۱ | قابل جمع (Collapsible)
قابل جمع ها ابزار پایه و آسان برای نمایش محتوای کوتاه هستند. |
۲ | قابل جمع پویا (Dynamic Collapsible)
قابل جمع می تواند به صورت پویا به مجموعهی قابل جمع (Collapsible Set) اضافه شود. |
۳ | مجموعهی قابل جمع (Collapsible Set)
در jQuery Mobile، با قرار دادن چند قابل جمع مجزا در یک مجموعه، یک آکاردیون (Accordion) ایجاد می شود. |
۴ | قابل جمع تو در تو (Nested Collapsible)
قابل جمع ها می توانند داخل محتوای قابل جمع دیگری قرار گیرند. |
collapsible ویجت اولیه و آسان برای نمایش محتوای کوتاه هستند. جدول زیر انواع collapsible مورد استفاده در jQuery Mobile را فهرست می کند.
ردیف | نوع و توضیحات Collapsible |
---|---|
۱ | کلید مرتبط (Basic collapsible)
با اضافه کردن ویژگی data-role = "collapsible" به یک ظرف، میتوان یک بلوک Collapsible ایجاد کرد. |
۲ | تم (Theme)
برای تنظیم یک تم Collapsible، میتوانید از ویژگی data-theme استفاده کنید و ویژگی data-content-theme را با یک حرف از سوئیچ تم مشخص شده اضافه کنید. |
۳ | باز شده (Expanded)
با استفاده از ویژگی data-collapsed و تنظیم آن به false، میتوانید محتوای Collapsible را در هنگام بارگیری صفحه گسترش دهید. |
۴ | اندازه کوچک (Mini sized)
میتوانید هر زمان که نیاز به نسخه کوچکشدهای از Collapsible دارید، از ویژگی data-mini و تنظیم آن به true استفاده کنید. |
۵ | آیکونها (Icons)
میتوان با استفاده از ویژگیهای data-collapsed-icon و data-expanded-icon، آیکونهای پیشفرض سربرگ Collapsible را با آیکونهای دیگر جایگزین کرد. |
۶ | قرارگیری آیکون (Icon positioning)
میتوان با استفاده از ویژگی data-iconpos، قرارگیری پیشفرض آیکون سربرگ Collapsible را جایگزین کرد. |
۷ | عنوان(Legend)
شما میتوانید المانهای فرم را در کالابسیبل (Collapsible) با استفاده از فیلدست (Fieldset) و عنوان (Legend) نمایش دهید. |
۸ | غیر درج شده (Non-inset Collapsible)
برای حذف ظاهر inset و نمایش کالابسیبل به طور کامل بدون سبک کرنر، میتوانید ویژگی data-inset = "false" را اضافه کنید. |
۹ | مجموعهای از collapsibles جداگانه (Set of individual collapsibles)
شما میتوانید یک سری کالابسیبل جداگانه اعمال کنید و اجازه میدهد تا شما بتوانید چندین ردیف را به طور همزمان باز کنید. |
۱۰ | مارکاپ پیشرندر شده (Pre-rendered markup)
برای بهبود زمان بارگیری صفحه، میتوانید مارکاپ پیشرندر شده را برای کالابسیبل فراهم کنید با اضافه کردن ویژگی data-enhanced و تنظیم آن به true. |
1-1-کلید مرتبط (Basic collapsible):
بلوک تاشدنی محتوا را می توان با استفاده از ویژگی data-role = "collapsible" در یک ظرف ایجاد کرد. در داخل ظرف، میتوانید هر عنصر سرصفحه یا افسانهای را اضافه کنید. هدر توسط فریمورک به گونهای طراحی میشود که مانند یک دکمه قابل کلیک ظاهر شود.
در زیر هدر، میتوانید نشانهگذاری HTML مورد نظر خود را اضافه کنید و هر زمان که روی عنوان کلیک شود، نشان داده یا پنهان میشود.
2-1-تم (Theme):
برای تنظیم یک طرح زمینه جمعشونده، میتوانید از ویژگی داده-موضوع استفاده کنید و ویژگی داده-محتوا-موضوع را با یک حرف نمونه تم مشخص شده اضافه کنید. برای جلوگیری از ارث بری پیشفرض محتوای تاشو، میتوانید data-content-theme را روی false تنظیم کنید.
3-1-باز شده (Expanded):
میتوانید محتوای جمعشدنی را در بارگذاری صفحه با تنظیم ویژگی جمعشده داده روی false گسترش دهید.
4-1-اندازه کوچک (Mini sized):
هر زمان که به یک نسخه جمعوجور تاشو نیاز داشتید میتوانید از اندازه کوچک استفاده کنید. این را می توان با استفاده از data-mini و تنظیم آن بر روی true بدست آورد.
5-1-آیکونها (Icons):
ایکون ها ی پیشفرض عنوان جمعشونده را میتوان با استفاده از ویژگیهای data-collapsed-icon و data-expanded-icon لغو کرد.
6-1-قرارگیری آیکون (Icon positioning):
Icon positioning پیش فرض عنوان collapsibe را می توان با استفاده از ویژگی data-iconpos لغو کرد. این ویژگی را می توان با مقدار چپ، راست، بالا یا پایین تنظیم کرد.
7-1-عنوان(Legend):
می توانید با استفاده از مجموعه فیلدها و افسانه عناصر فرم را به صورت جمع شونده نمایش دهید.
8-1-غیر درج شده (Non-inset Collapsible):
برای حذف ظاهر داخلی و نمایش تاشدنی به عرض کامل بدون استایل گوشه، میتوانید ویژگی data-inset = "false" را اضافه کنید.
9-1-مجموعهای از collapsibles جداگانه (Set of individual collapsibles):
شما می توانید یک سری از تاشوها را اعمال کنید و به شما امکان می دهد چندین ردیف را همزمان باز کنید. مرز تاشو را می توان با ارائه CSS سفارشی سفارشی کرد.
10-1-مارکاپ پیشرندر شده (Pre-rendered markup):
برای بهبود زمان بارگذاری صفحه خود، میتوانید با افزودن ویژگی بهبود یافته داده و تنظیم آن روی true، یک نشانهگذاری از پیش رندر شده برای جمعشدگی ارائه دهید.
2-قابل جمع پویا (Dynamic Collapsible):
Collapsible را می توان به صورت پویا به مجموعه Collapsibleاضافه کرد.
مثال زیر استفاده از قابلیت جمعشدگی پویا را در jQuery Mobile نشان میدهد.
3-مجموعهی قابل جمع (Collapsible Set):
در jQuery Mobile، میتوان با قرار دادن یک سری collapsible جداگانه در یک set، یک accordion ایجاد کرد.
در جدول زیر، انواع مختلف collapsible set استفاده شده در jQuery Mobile لیست شده است:
ردیف | نوع و توضیحات مجموعه جمعشونده |
---|---|
۱ | نشانهگذاری (Markup)
میتوان با استفاده از نشانهگذاری ساده مجموعه جمعشونده را ایجاد کرد. اضافه کردن ویژگی data-role = "collapsibleset" باعث میشود آن یک مجموعه جمعشونده باشد. |
۲ | داخلی در برابر عرض کامل
برای ایجاد مجموعه جمعشونده با عرض کامل بدون طراحی گوشه، ویژگی data-inset را اضافه کرده و آن را به false تنظیم کنید. |
۳ | کوچک (Mini)
هر زمان که میخواهید یک نسخه فشرده از مجموعه جمعشونده را داشته باشید، ویژگی data-mini را اضافه کرده و آن را به true تنظیم کنید. |
۴ | نمادها (Icons)
برای جایگزینی نمادهای سربرگ پیشفرض، ویژگیهای data-collapsed-icon و data-expanded-icon را در سطح collapsibleset یا در هر یک از مجموعه جمعشوندههای آن اضافه کنید. |
5 | موقعیت آیکون
برای جایگزینی موقعیت پیشفرض آیکون، از ویژگی data-iconpos در سطح collapsibleset یا در هر یک از collapsibles آن استفاده کنید. |
6 | گوشهها
برای ساخت یک collapsible set inset بدون استفاده از گوشههای گرد، فقط ویژگی data-corners را اضافه کنید و به false تنظیم کنید. |
7 | تم(theme)
رنگ هر هدر collapsible را میتوان با اضافه کردن ویژگی data-theme به collapsible set تنظیم کرد. |
3-1-نشانهگذاری (Markup):
مجموعه تاشوها را میتوان با همان نشانهگذاری تاشوهای اولیه ایجاد کرد. افزودن ویژگی data-role="collapsibleset" آن را به مجموعه ای تاشو تبدیل می کند و مانند آکاردئون رفتار می کند.
مثال
3-2-داخلی در برابر عرض کامل:
برای ایجاد یک تاشو با عرض کامل بدون استایل دادن به گوشه ها، ویژگی data-inset را اضافه کنید و روی false تنظیم کنید. این قسمت جمعشدهها را بهعنوان نمای فهرستی قابل گسترش نمایش میدهد.
3-3-کوچک (Mini):
هر زمان که میخواهید یک نسخه فشرده از مجموعهای از تاشوها داشته باشید، ویژگی data-mini را اضافه کنید و آن را روی true تنظیم کنید.
مثال:
4-3-نمادها (Icons):
برای لغو نمادهای عنوان پیشفرض، ویژگیهای data-collapsed-icon و data-expanded-icon را در سطح collapsibdata-expanded-iconleset یا در هر کدام از موارد جمعشدنی آن اضافه کنید.
مثال :
5-3-موقعیت آیکون:
برای نادیده گرفتن موقعیت نماد پیشفرض، از ویژگی data-iconpos در سطح مجموعه جمعشدنی یا در هر کدام از موارد جمعشدنی آن استفاده کنید.
6-3-گوشهها:
برای به دست آوردن یک مجموعه تاشو درونی بدون استایل گوشه گرد، فقط ویژگی گوشه های داده را اضافه کنید و روی false تنظیم کنید.
7-3-تم(theme):
رنگ هر هدر تاشو را می توان با افزودن یک ویژگی تم داده به مجموعه جمع شونده تنظیم کرد.
برای تعیین رنگ محتوا، می توانید ویژگی داده-محتوا-موضوع را اضافه کنید. میتوانید با افزودن ویژگیهای data-theme و data-content-theme به بخشهای منفرد در یک گروه، استایل متفاوتی به تاشوهای خاص بدهید.
4-قابل جمع تو در تو (Nested Collapsible):
تاشو را می توان در داخل محتوای تاشو دیگر قرار داد.