Skip to content

CSS: segmented-control ​

.instui-segmented-control — صف اختيار مفرد لعرض مضغوط أو لخيارات التصفية.

يستخدم المقطع المحدد ظل عنصر-نشط مميز؛ لا يتطابق مع مركب موجود --instui-elevation-*. أزرار الفائض تستخدم توكنات مكون elevation3 الأصلية.

TIP

JS Enhancement — CSS هذا المكوّن يعرض ويعمل بمفرده؛ زَوجه مع @pantoken/interactions لإضافة السلوك التفاعلي. راجع جدول المعدّلات أدناه.

Usage ​

css
@import "@pantoken/plugin-custom-components/custom-components.css";

Structure ​

text
fieldset.instui-segmented-control
  .viewport
    button.overflow-start (0..1)
    .track
      segmented-control.segment (component, 1..n)
    button.overflow-end (0..1)
flowchart TD n0["fieldset.instui-segmented-control"]:::cssdoc-root n1(".viewport"):::cssdoc-part n2("button.overflow-start"):::cssdoc-part n3(".track"):::cssdoc-part n4(["segmented-control.segment"]):::cssdoc-component n5("button.overflow-end"):::cssdoc-part n1 -.->|0..1| n2 n3 -->|1..n| n4 n1 --> n3 n1 -.->|0..1| n5 n0 --> n1 click n4 "/api/css/segmented-control.segment.md" classDef cssdoc-root stroke-width:1px; classDef cssdoc-part stroke-width:1px; classDef cssdoc-slot stroke-width:1px; classDef cssdoc-component stroke-width:1px;

Modifiers ​

ModifierDescription
.-size-lgمقاطع كبيرة.
.-size-mdمقاطع متوسطة (الافتراضي).
.-size-smمقاطع صغيرة.

Parts ​

PartDescription
.overflow-endالتمرير إلى المقطع المخفي التالي.
.overflow-startالتمرير إلى المقطع المخفي السابق.
.trackصف قابل للتمرير يحتوي على المقاطع القابلة للاختيار.
.viewportيقص صف المقاطع ويرسّخ عناصر التحكم في الفائض.

Pseudo-elements ​

Pseudo-elementDescription
::before—

States ​

StateDescription
:disabled—

Accessibility ​

استخدم مجموعة حقول معنونة واسم راديو مشترك واحد مع قيمة افتراضية محددة. أجهزة الراديو الأصلية تعلن عن حالتها المحددة؛ أزرار الفائض تحتاج إلى تسميات تصف اتجاه التمرير.

الشروطإعادة تصميم العلامة التجارية (فاتح)إعادة تصميم العلامة التجارية (داكن)Canvasتباين عالٍ للوحة
forced-colors-focus-visibleWCAG 2.2 1.4.11, 2.4.7FailFailFailFail

عند تفعيل الألوان الإجبارية، لم يتغير أي شيء مرئي عند انتقال التركيز إلى عنصر التحكم. يختفي مؤشر التركيز المرسوم باستخدام box-shadow أو لون الخلفية في وضع الألوان الإجبارية. استخدم outline.

less-contrast-stays-readableWCAG 2.2 1.4.3FailFailPassPass

إعادة تسمية العلامة التجارية (الفاتح): عند استخدام prefers-contrast: less، ينخفض تباين ثلاثة نصوص عن الحد الأدنى. أسوأها "الدرجات" بنسبة 1.48:1 (المطلوب 4.5:1). لا بأس بتباين أخف ما دام النص يظل مقروءًا.

إعادة تسمية العلامة التجارية (الداكن): عند استخدام prefers-contrast: less، ينخفض تباين ثلاثة نصوص عن الحد الأدنى. أسوأها "الدرجات" بنسبة 1.38:1 (المطلوب 4.5:1). لا بأس بتباين أخف ما دام النص يظل مقروءًا.

reduced-motion-respectedWCAG 2.2 2.3.3, 2.2.2PassPassPassPass
reduced-transparency-respectedWCAG 2.2 1.4.3, 1.4.11PassPassلا ينطبقلا ينطبق
reflow-at-320pxWCAG 2.2 1.4.10PassPassPassPass
text-spacing-no-clippingWCAG 2.2 1.4.12PassPassPassPass
قارئ شاشة (محاكاة)إعادة تصميم العلامة التجارية (فاتح)إعادة تصميم العلامة التجارية (داكن)Canvasتباين عالٍ للوحة
AnnouncementsPassPassPassPass

لا تثبت هذه النتائج الآلية أن الصفحة تستوفي معايير WCAG؛ فما زالت المراجعة اليدوية مطلوبة.

Tokens consumed ​

TokenTypeValue
--instui-border-width-sm<length>0.0625rem
--instui-color-background-interactive-action-primary-base<color>LightDarklight-dark(#1D354F, #EEF4FD)
--instui-color-drop-shadow-shadow-color1<color>LightDarklight-dark(rgba(35,68,101,0.15), rgba(0,0,0,0.3))
--instui-color-drop-shadow-shadow-color2<color>LightDarklight-dark(rgba(35,68,101,0.1), rgba(0,0,0,0.15))
--instui-color-stroke-interactive-action-primary-base<color>LightDarklight-dark(#1D354F, #EEF4FD)
--instui-color-text-interactive-action-primary-base<color>LightDarklight-dark(#ffffff, #1D354F)
--instui-component-base-button-border-radius<length>0.75rem
--instui-component-base-button-medium-height<length>2.5rem
--instui-component-segmented-control-font-family[ <font-family-name> | <generic-font-family> ]#Atkinson Hyperlegible Next, "Helvetica Neue", Helvetica, Arial, sans-serif
--instui-component-segmented-control-font-size-lg<length>1.125rem
--instui-component-segmented-control-font-size-md<length>1rem
--instui-component-segmented-control-font-size-sm<length>0.875rem
--instui-component-segmented-control-font-weight<integer>500
--instui-component-segmented-control-height-lg<length>3rem
--instui-component-segmented-control-height-md<length>2.5rem
--instui-component-segmented-control-height-sm<length>2rem
--instui-component-segmented-control-item-gap-lg<length>0.75rem
--instui-component-segmented-control-item-gap-md<length>0.5rem
--instui-component-segmented-control-item-gap-sm<length>0.25rem
--instui-component-segmented-control-item-padding-horizontal-lg<length>1.25rem
--instui-component-segmented-control-item-padding-horizontal-md<length>1rem
--instui-component-segmented-control-item-padding-horizontal-sm<length>0.75rem
--instui-component-segmented-control-line-height<percentage>125%
--instui-component-segmented-control-track-background-color<color>LightDarklight-dark(#44709f33, #86a8d54d)
--instui-component-segmented-control-track-background-disabled-color<color>LightDarklight-dark(#DFE1E3, #334450)
--instui-component-segmented-control-track-border-radius<length>1rem
--instui-component-segmented-control-track-gap<length>0.125rem
--instui-component-segmented-control-track-padding<length>0.25rem
--instui-drop-shadow-blur-elevation3-dropshadow1<length>10px
--instui-drop-shadow-blur-elevation3-dropshadow2<length>3px
--instui-drop-shadow-spread-elevation3-dropshadow1<length>4px
--instui-drop-shadow-spread-elevation3-dropshadow2<length>0px
--instui-drop-shadow-y-elevation3-dropshadow1<length>6px
--instui-drop-shadow-y-elevation3-dropshadow2<length>2px
--instui-icon-chevron-left<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%22m15%2018-6-6%206-6%22%2F%3E%3C%2Fsvg%3E')
--instui-icon-chevron-right<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%22m9%2018%206-6-6-6%22%2F%3E%3C%2Fsvg%3E')
--pantoken-segmented-end-reserve——
--pantoken-segmented-font-size<length>1rem
--pantoken-segmented-overflow-shadow<color>0 2px 3px 0px light-dark(rgba(35,68,101,0.15), rgba(0,0,0,0.3)), 0 6px 10px 4px light-dark(rgba(35,68,101,0.1), rgba(0,0,0,0.15))
--pantoken-segmented-start-reserve——

Subcomponents ​