الگو:Clickable button

توضیحات الگو[نمایش] [ویرایش] [تاریخچه] [پاکسازی]

این الگو پیوندی را به‌شکل یک دکمه قالب‌بندی می‌کند و از ماژول منسوخ‌شدهٔ mediawiki.ui.button استفاده می‌کند. این کار، ناحیهٔ قابل‌کلیک و ناحیهٔ قابل‌لمس پیوند را گسترش می‌دهد.

کاربرد

All parameters

{{Clickable button|پیوند ویکی|نمایش|color=رنگ|url=نشانی|class=رده|link=}}

پیوند ویکی

نخستین پارامتر بی‌نام؛ عنوان صفحه‌ای که به آن پیوند داده می‌شود. نیازی به براکت‌ها نیست.

نمایش (اختیاری)

پارامتر دوم بی‌نام اختیاری؛ متنی که نمایش داده می‌شود. اگر متن نمایش همان پیوند ویکی باشد، نیازی به آن نیست.

|color= یا |class=

رنگی که نمایش داده می‌شود. |color= مقادیر blue و red را می‌پذیرد و |class= مقادیر mw-ui-progressive و mw-ui-destructive را می‌پذیرد.

|url=

نشانی‌ای که دکمه به آن پیوند داده می‌شود. اگر هیچ پیوند ویکی یا متن نمایشی ارائه نشود، نشانی نمایش داده می‌شود؛ در غیر این صورت، همان پیوند ویکی یا متن نمایشی نمایش داده خواهد شد.

|link=no

از این پارامتر با مقدار «no» برای نمایش یک دکمه بدون هیچ پیوندی استفاده کنید.

مثال‌ها

پیوندهای ویکی

{{Clickable button|Main Page}} → Main Page

{{Clickable button|Main Page|Click here to visit the main page}} → Click here to visit the main page

{{Clickable button|Click here|link=no}} → Click here

رنگ‌ها

{{Clickable button|Main Page}} → Main Page – در صورت تعیین‌نشدن |color= و |class=، دکمهٔ پیش‌فرض سفید است.

{{Clickable button|Main Page|color=blue}} → Main Page

{{Clickable button|Main Page|color=red}} → Main Page

{{Clickable button|Main Page|class=mw-ui-progressive}} → Main Page

{{Clickable button|Main Page|class=mw-ui-destructive}} → Main Page

نشانی‌های اینترنتی

{{Clickable button|url=https://example.com}} → https://example.com

{{Clickable button|Example|url=https://example.com}} → Example

{{Clickable button|2=Example|url=https://example.com}} → Example

افزودن یک نماد

افزودن نماد به دکمه بهتر است انجام نشود. فراموش نکنید که نماد را از DOM دسترس‌پذیری پنهان کنید؛ با پیچیدن آن در یک برچسب span که ویژگی aria-hidden="true" دارد تا خوانندهٔ صفحه آن را با صدای بلند نخواند.

<span class="mw-ui-button mw-ui-progressive"><span aria-hidden="true">[[File:OOjs UI icon logo-wikimediaCommons-invert.svg|15px|link=|alt=]]</span>&nbsp;More details</span>

More details

داده‌های الگو

یک پیوند را مانند دکمه قالب‌بندی می‌کند، با استفاده از ماژول mediawiki.ui.button

پارامترهای الگو[ویرایش داده‌های الگو]

استفاده از قالب‌بندی درون‌خطی برای پارامترهای این الگو ارجح است.

پارامتر		توضیحات	نوع	وضعیت
پیوند/برچسب	1	صفحه‌ای را که باید به آن پیوند داده شود تعریف می‌کند و عنوان آن صفحه را به‌عنوان متن دکمه استفاده می‌کند. مثال Foobar	نام صفحه	ضروری
برچسب	2	متنی را که روی دکمه نمایش داده می‌شود تعریف می‌کند. پیش‌فرض صفحه‌ای که به آن پیوند داده شده است	ناشناخته	پیشنهادشده
نشانی اینترنتی	url	نشانی وبی را تعریف می‌کند که دکمه باید به آن پیوند دهد. مثال https://www.example.com	نشانی اینترنتی	اختیاری
class	class	نوع ظاهری دکمه را تعریف می‌کند. مقدارهای پیشنهادی mw-ui-progressive mw-ui-destructive	رشته	اختیاری
سبک‌دهی سفارشی CSS	style	امکان اعمال سبک‌دهی سفارشی CSS به دکمه را فراهم می‌کند. پیش‌فرض هیچ‌کدام مثال border: 2px solid red;	رشته	اختیاری
دسته‌بندی	category	مشخص می‌کند که آیا دسته‌ها فعال باشند یا نه. پیش‌فرض yes مثال no مقدار خودکار 0	بولی	اختیاری
color	color	نوع ظاهری دکمه را تعریف می‌کند. مقدارهای پیشنهادی blue red	رشته	اختیاری

جستارهای وابسته

• commons:Template:Clickable button، دکمهٔ قابل‌کلیک متناظر در ویکی‌انبار.
• راهنمای سبک طراحی ویکی‌مدیا دربارهٔ دکمه‌ها
• phab:T146923، که پشتیبانی از mw-ui-constructive، ردهٔ CSS برای دکمه‌های سبز را حذف کرد.

توضیحات بالا تراگنجانده‌شده از الگو:Clickable button/توضیحات است. (ویرایش | تاریخچه)
ویرایشگران می‌توانند در صفحات تمرین (ویرایش | تفاوت) و آزمایشی (ایجاد) این الگو را آزمایش کنند.
لطفاً رده‌ها را به زیرصفحهٔ /توضیحات بیفزایید. زیرصفحه‌های این الگو.