دکمه
وضعیت: در حال بازبینی
انجام بدهیک دکمهٔ اصلی و یک دکمهٔ بیزمینه برای اقدام جایگزین. انجام ندهدو دکمهٔ اصلی کنار هم؛ کاربر نمیداند کدام مهمتر است.
<button class="hq-button" type="button">ثبت درخواست</button><button class="hq-button hq-button--secondary" type="button">مشاهدهٔ نمونهکارها</button><button class="hq-button hq-button--ghost" type="button">انصراف</button><button class="hq-button hq-button--danger" type="button">حذف پروژه</button>چه وقت استفاده کنیم
Section titled “چه وقت استفاده کنیم”- برای اجرای یک اقدام: ثبت، ذخیره، ارسال، حذف.
- برای قدم اصلی بعدی در یک مسیر، مثل «شروع ارزیابی» یا «برای تحول آمادهاید؟».
چه وقت استفاده نکنیم
Section titled “چه وقت استفاده نکنیم”- برای رفتن به صفحهٔ دیگر در میان متن؛ آنجا از لینک استفاده کنید.
- برای انتخاب یک گزینه یا فیلتر؛ اینها در موج اول کامپوننت جداگانه دارند.
گونهها
Section titled “گونهها”| گونه | کلاس | کاربرد |
|---|---|---|
| اصلی | hq-button |
مهمترین اقدام صفحه یا بخش؛ حداکثر یکی در هر بخش |
| ثانویه | hq-button--secondary |
اقدام مهم دیگر کنار دکمهٔ اصلی |
| بیزمینه | hq-button--ghost |
اقدام کماهمیت: انصراف، بازگشت، اقدامهای جدول |
| خطرناک | hq-button--danger |
اقدام برگشتناپذیر مثل حذف؛ همیشه با تایید |
اندازهها
Section titled “اندازهها”<button class="hq-button" type="button">بزرگ (پیشفرض)</button><button class="hq-button hq-button--md" type="button">متوسط</button><button class="hq-button hq-button--sm" type="button">کوچک</button>بزرگ پیشفرض است. متوسط برای فرمهای فشرده، و کوچک فقط برای جدول و نوارابزار.
با آیکن
Section titled “با آیکن”آیکن بعد از متن میآید، یعنی در چیدمان راستبهچپ سمت چپ آن. پیکان رو به چپ است، چون مسیر خواندن فارسی به چپ پیش میرود.
<a class="hq-button" href="#"> شروع ارزیابی <svg class="hq-button__icon" viewBox="0 0 32 32" aria-hidden="true"><path d="M14 26l1.41-1.41L7.83 17H28v-2H7.83l7.58-7.59L14 6 4 16l10 10z"/></svg></a>ترتیب دکمهها
Section titled “ترتیب دکمهها”در گروه دکمهها، دکمهٔ اصلی اول میآید، یعنی سمت راست.
<button class="hq-button" type="button">ذخیره و ادامه</button><button class="hq-button hq-button--ghost" type="button">انصراف</button>- فعل و کوتاه، حداکثر سه واژه: «ثبت درخواست»، نه «درخواست خود را ثبت کنید».
- مشخص: «حذف پروژه»، نه «تایید».
- بدون نقطه و بدون علامت تعجب. پرسش فقط برای جملهٔ امضای «برای تحول آمادهاید؟».
آناتومی
Section titled “آناتومی”- ظرف: ارتفاع از
size-control-*، فاصلهٔ داخلی افقیspace-3(کوچک:space-2)، گوشهٔradius-sm. - برچسب: راوی SemiBold با اندازهٔ
type-body(کوچک:type-body-compact). - آیکن (اختیاری): ۲۰ پیکسل (کوچک: ۱۶)، با فاصلهٔ
space-1از برچسب.
توکنها
Section titled “توکنها”| حالت | اصلی | ثانویه | بیزمینه | خطرناک |
|---|---|---|---|---|
| عادی | زمینهٔ accent، متن on-accent |
خط و متن accent |
متن accent |
زمینهٔ negative، متن on-negative |
| روی نشانگر | accent-hover |
زمینهٔ accent-subtle |
زمینهٔ accent-subtle |
negative-hover |
| فشرده | accent-active |
متن accent-active |
متن accent-active |
negative-hover |
| فوکوس | حلقهٔ ۲ پیکسلی focus با فاصلهٔ ۲ پیکسل |
← | ← | ← |
| غیرفعال | زمینهٔ disabled، متن on-disabled |
خط disabled، متن on-disabled |
متن on-disabled |
مثل اصلی |
غیرفعال
Section titled “غیرفعال”<button class="hq-button" type="button" disabled>ثبت درخواست</button><button class="hq-button hq-button--secondary" type="button" disabled>مشاهدهٔ نمونهکارها</button><button class="hq-button hq-button--ghost" type="button" disabled>انصراف</button>حالت تیره
Section titled “حالت تیره”<button class="hq-button" type="button">ثبت درخواست</button><button class="hq-button hq-button--secondary" type="button">مشاهدهٔ نمونهکارها</button><button class="hq-button hq-button--ghost" type="button">انصراف</button><button class="hq-button hq-button--danger" type="button">حذف پروژه</button>گوشهها
Section titled “گوشهها”دکمه گوشهٔ radius-sm دارد: با سبک تخت و آرام برند جور است، و دکمه با برچسبها (pill) که گوشهٔ کامل دارند اشتباه گرفته نمیشود.
برای اقدام از <button> و برای رفتن به صفحهٔ دیگر از <a> با همین کلاسها استفاده کنید.
<button class="hq-button" type="button">ثبت درخواست</button><a class="hq-button hq-button--secondary" href="/cases">مشاهدهٔ نمونهکارها</a>| کلاس | توضیح |
|---|---|
hq-button |
دکمهٔ اصلی، اندازهٔ بزرگ |
hq-button--secondary، --ghost، --danger |
گونه |
hq-button--md، --sm |
اندازه |
hq-button--block |
تمامعرض، برای موبایل و فرمهای باریک |
hq-button--icon-only |
دکمهٔ فقط آیکن؛ مربعی |
hq-button__icon |
آیکن SVG داخل دکمه |
- از
<button>واقعی استفاده کنید تا صفحهکلید (Enter و Space) و صفحهخوان بدون کد اضافه کار کنند.<div>قابل کلیک ممنوع است. type="button"را برای دکمههای خارج از فرم بگذارید تا فرم ناخواسته ارسال نشود.- حلقهٔ فوکوس هرگز حذف نمیشود.
- دکمهٔ فقطآیکن حتماً
aria-labelدارد، مثلاًaria-label="بستن"؛ آیکن داخل دکمهaria-hidden="true"میگیرد. - برای لینکی که شکل دکمه دارد، به جای
disabledازaria-disabled="true"استفاده کنید وhrefرا بردارید. - کمینهٔ ناحیهٔ لمس ۴۸ پیکسل است؛ اندازهٔ کوچک فقط برای رابطهای دسکتاپ.
- کنتراست متن در گونههای فعال، در هر دو حالت روشن و تیره، بالای ۴٫۵:۱ است. کنتراست کم حالت غیرفعال عمدی است.