CSS: checkbox ​

.instui-checkbox — یک چک‌باکس بومی و برچسب آن، یا یک سوییچ از طریق -variant-toggle.

برای نمایش حالت نامشخص خط وسط، el.indeterminate = true را در JavaScript تنظیم کنید؛ علامت تیکِ انتخاب‌شده به‌طور خودکار با رنگ پس‌زمینه کنتراست می‌سازد — سفید روی پس‌زمینه تیره، نزدیک به سیاه روی پس‌زمینه روشن. همچنین فاصلهٔ gap خودش را بین کنترل و برچسب تنظیم می‌کند؛ زنجیره‌سازی یک مودیفایر فاصلهٔ -gap-* مقدار درونی را بازنویسی می‌کند.

Source: checkbox.css

دسترس‌پذیری ​

یک <input type="checkbox"> بومی، :checked، :indeterminate و :disabled را کنترل می‌کند؛ el.indeterminate = true را در JavaScript برای حالت نامشخص تنظیم کنید، و توجه داشته باشید که -readonly صرفاً مربوط به استایل است چون چک‌باکس‌ها صفت readonly بومی ندارند.

نحوه استفاده ​

css
@import "@pantoken/components/components.css";
@import "@pantoken/components/checkbox.css";

نمونه‌ها ​

html
<label class="instui-checkbox --display-block --mb-sm">
  <input type="checkbox" checked>Checkbox
</label>
<label class="instui-checkbox -variant-toggle">
  <input type="checkbox">Toggle
</label>

تعدیل‌کننده‌ها ​

تعدیل‌کنندهتوضیحات
.-invalidحالت نامعتبر (خطا).
.-label-placement-endقرار دادن برچسب بعد از کنترل.
.-label-placement-startقرار دادن برچسب قبل از کنترل.
.-label-placement-topقرار دادن برچسب بالای کنترل.
.-readonlyحالت فقط‌خواندنی.
.-requiredنمایش ستارهٔ فیلد اجباری در کنار برچسب.
.-size-largeبزرگ. نام طولانی‌ترِ -size-lg.
.-size-lgبزرگ.
.-size-smکوچک.
.-size-smallکوچک. نام طولانی‌ترِ -size-sm.
.-variant-toggleبه‌جای جعبه به‌صورت سوییچ رندر شود.

قسمت‌ها ​

قسمتتوضیحات
.asteriskستارهٔ فیلد اجباری.

نیمه‌عناصر (Pseudo-elements) ​

نیمه‌عنصرتوضیحات
::afterروی -variant-toggle، نماد حالت روی دسته: یک × وقتی خاموش است، یک تیک وقتی روشن است.
::beforeنماد تیک یا خطِ ماسک‌شده که در مرکز جعبه قرار می‌گیرد؛ روی -variant-toggle به‌جای آن تبدیل به دستهٔ کشویی می‌شود.

حالت‌ها ​

وضعیتتوضیحات
:checked—
:disabled—
:indeterminate—

خواص سفارشی ​

خاصیتنوعپیش‌فرضتوضیحات
--pantoken-cb-glyph<url>—نماد ماسکِ جعبه: وقتی انتخاب‌شده تیک، وقتی نامشخص خط.
--pantoken-toggle-bw<length>—ضخامت حاشیهٔ سوییچ.
--pantoken-toggle-h<length>—ارتفاع سوییچ toggle.
--pantoken-toggle-handle<length>—قطر محاسبه‌شدهٔ دسته.
--pantoken-toggle-inset<length>—فاصلهٔ دسته از هر لبهٔ مسیر.
--pantoken-toggle-w<length>—عرض مسیر سوییچ.

توکن‌های مصرف‌شده ​

Tokenنوعمقدار
--instui-border-width-sm<length>0.0625rem
--instui-color-background-muted<color>LightDarklight-dark(#F2F4F5, #273540)
--instui-color-stroke-base<color>LightDarklight-dark(#8D959F, #6A7883)
--instui-color-text-muted<color>LightDarklight-dark(#576773, #AAB0B5)
--instui-component-checkbox-asterisk-color<color>LightDarklight-dark(#CF1F24, #FA917F)
--instui-component-checkbox-background-checked-color<color>LightDarklight-dark(#273540, #ffffff)
--instui-component-checkbox-background-color<color>LightDarklight-dark(#ffffff, #171B21)
--instui-component-checkbox-background-disabled-color<color>LightDarklight-dark(#E8EAEC, #334450)
--instui-component-checkbox-background-hover-color<color>LightDarklight-dark(#ffffff, #171B21)
--instui-component-checkbox-background-readonly-color<color>LightDarklight-dark(#C7CACD, #6A7883)
--instui-component-checkbox-border-checked-color<color>LightDarklight-dark(#273540, #ffffff)
--instui-component-checkbox-border-color<color>LightDarklight-dark(#7E8792, #5F6E7A)
--instui-component-checkbox-border-disabled-color<color>LightDarklight-dark(#C7CACD, #4A5B68)
--instui-component-checkbox-border-hover-color<color>LightDarklight-dark(#334450, #7E8792)
--instui-component-checkbox-border-radius<length>0.25rem
--instui-component-checkbox-border-readonly-color<color>#8D959F
--instui-component-checkbox-border-width<length>0.0625rem
--instui-component-checkbox-control-size-lg<length>1.5rem
--instui-component-checkbox-control-size-md<length>1.5rem
--instui-component-checkbox-control-size-sm<length>1.5rem
--instui-component-checkbox-control-vertical-margin<length>0rem
--instui-component-checkbox-error-border-color<color>LightDarklight-dark(#CF1F24, #F56050)
--instui-component-checkbox-error-border-hover-color<color>LightDarklight-dark(#CF1F24, #FE7D6A)
--instui-component-checkbox-font-family[ <font-family-name> | <generic-font-family> ]#Atkinson Hyperlegible Next, "Helvetica Neue", Helvetica, Arial, sans-serif
--instui-component-checkbox-font-size-lg<length>1.25rem
--instui-component-checkbox-font-size-md<length>1rem
--instui-component-checkbox-font-size-sm<length>0.875rem
--instui-component-checkbox-font-weight<integer>400
--instui-component-checkbox-gap<length>0.5rem
--instui-component-checkbox-label-base-color<color>LightDarklight-dark(#273540, #ffffff)
--instui-component-checkbox-label-disabled-color<color>LightDarklight-dark(#8D959F, #576773)
--instui-component-checkbox-label-hover-color<color>LightDarklight-dark(#273540, #ffffff)
--instui-component-checkbox-label-readonly-color<color>LightDarklight-dark(#273540, #ffffff)
--instui-component-checkbox-line-height<percentage>125%
--instui-component-radio-input-toggle-background-success<color>#03893D
--instui-component-radio-input-toggle-handle-text<color>#ffffff
--instui-component-radio-input-toggle-medium-height<length>2.5rem
--instui-icon-check<image>url('data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20width%3D%2224%22%20height%3D%2224%22%20viewBox%3D%220%200%2024%2024%22%20fill%3D%22none%22%20stroke%3D%22currentColor%22%20stroke-width%3D%222%22%20stroke-linecap%3D%22round%22%20stroke-linejoin%3D%22round%22%3E%3Cpath%20d%3D%22M20%206%209%2017l-5-5%22%2F%3E%3C%2Fsvg%3E')
--instui-icon-minus<image>url('data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20width%3D%2224%22%20height%3D%2224%22%20viewBox%3D%220%200%2024%2024%22%20fill%3D%22none%22%20stroke%3D%22currentColor%22%20stroke-width%3D%222%22%20stroke-linecap%3D%22round%22%20stroke-linejoin%3D%22round%22%3E%3Cpath%20d%3D%22M5%2012h14%22%2F%3E%3C%2Fsvg%3E')
--instui-icon-x<image>url('data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20width%3D%2224%22%20height%3D%2224%22%20viewBox%3D%220%200%2024%2024%22%20fill%3D%22none%22%20stroke%3D%22currentColor%22%20stroke-width%3D%222%22%20stroke-linecap%3D%22round%22%20stroke-linejoin%3D%22round%22%3E%3Cpath%20d%3D%22M18%206%206%2018%22%2F%3E%3Cpath%20d%3D%22m6%206%2012%2012%22%2F%3E%3C%2Fsvg%3E')
--instui-size-choice-control-height-md<length>1.5rem

مرتبط ​

  • radio — معادل تک‌انتخابی.