Skip to content

CSS: segmented-control ​

.instui-segmented-control — Wiersz z pojedynczym wyborem dla kompaktowego widoku lub opcji filtrowania.

Wybrany segment używa odrębnego cienia aktywnego elementu; nie odpowiada istniejącemu --instui-elevation-* composite. Przyciski przepełnienia używają tokenów komponentu elevation3 pochodzących z upstream.

TIP

Ulepszenie JS — CSS tego komponentu renderuje i działa samodzielnie; sparuj go z @pantoken/interactions aby dodać zachowanie interaktywne. Zobacz tabelę modyfikatorów poniżej.

Użycie ​

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

Struktura ​

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;

Modyfikatory ​

ModyfikatorOpis
.-size-lgDuże segmenty.
.-size-mdŚrednie segmenty (domyślnie).
.-size-smMałe segmenty.

Części ​

CzęśćOpis
.overflow-endPrzewiń do następnego ukrytego segmentu.
.overflow-startPrzewiń do poprzedniego ukrytego segmentu.
.trackPrzewijalny wiersz zawierający wybieralne segmenty.
.viewportPrzycina wiersz segmentów i kotwiczy kontrolki przepełnienia.

Pseudo-elementy ​

Pseudo-elementOpis
::before—

Stany ​

StanOpis
:disabled—

Dostępność ​

Użyj oznaczonego fieldsetu i jednej wspólnej nazwy dla przycisków radio z domyślnie zaznaczonym elementem. Natywne radio zgłaszają swój stan zaznaczenia; przyciski przepełnienia potrzebują etykiet opisujących kierunek przewijania.

WarunkiNowa identyfikacja (jasny)Nowa identyfikacja (ciemny)CanvasWysoki kontrast płótna
forced-colors-focus-visibleWCAG 2.2 1.4.11, 2.4.7FailFailFailFail

Przy włączonych wymuszonych kolorach widok nie zmieniał się, gdy kontrolka otrzymywała fokus. Obramowanie fokusu utworzone za pomocą box-shadow lub koloru tła znika w trybie wymuszonych kolorów. Użyj obrysu.

less-contrast-stays-readableWCAG 2.2 1.4.3FailFailPassPass

Zmiana marki (jasny): Przy ustawieniu prefers-contrast: less kontrast trzech fragmentów tekstu spada poniżej minimum. Najgorzej wypada „Oceny” — 1.48:1 (wymagane 4.5:1). Mniejszy kontrast jest w porządku tylko wtedy, gdy tekst pozostaje czytelny.

Zmiana marki (ciemny): Przy ustawieniu prefers-contrast: less kontrast trzech fragmentów tekstu spada poniżej minimum. Najgorzej wypada „Oceny” — 1.38:1 (wymagane 4.5:1). Mniejszy kontrast jest w porządku tylko wtedy, gdy tekst pozostaje czytelny.

reduced-motion-respectedWCAG 2.2 2.3.3, 2.2.2PassPassPassPass
reduced-transparency-respectedWCAG 2.2 1.4.3, 1.4.11PassPassNie dotyczyNie dotyczy
reflow-at-320pxWCAG 2.2 1.4.10PassPassPassPass
text-spacing-no-clippingWCAG 2.2 1.4.12PassPassPassPass
Czytnik ekranu (symulowany)Nowa identyfikacja (jasny)Nowa identyfikacja (ciemny)CanvasWysoki kontrast płótna
AnnouncementsPassPassPassPass

Te zautomatyzowane wyniki nie potwierdzają zgodności strony z WCAG; nadal konieczna jest ręczna weryfikacja.

Zużyte tokeny ​

TokenTypWartość
--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——

Subkomponenty ​