Skip to content

CSS: segmented-control ​

.instui-segmented-control — Một hàng chọn một mục cho các tuỳ chọn chế độ xem gọn hoặc bộ lọc.

Đoạn được chọn sử dụng một bóng mục-đang-hoạt-động riêng biệt; nó không khớp với một existing --instui-elevation-* composite. Các nút tràn sử dụng các token component elevation3 từ upstream.

TIP

Nâng cao JS — CSS của component này tự render và hoạt động độc lập; ghép với @pantoken/interactions để thêm hành vi tương tác. Xem bảng modifier phía dưới.

Sử dụng ​

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

Cấu trúc ​

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;

Bộ sửa ​

Bộ sửaMô tả
.-size-lgĐoạn lớn.
.-size-mdĐoạn trung bình (mặc định).
.-size-smĐoạn nhỏ.

Phần ​

PhầnMô tả
.overflow-endCuộn đến đoạn ẩn tiếp theo.
.overflow-startCuộn đến đoạn ẩn trước đó.
.trackHàng có thể cuộn chứa các đoạn có thể chọn.
.viewportCắt hàng đoạn và neo các điều khiển tràn.

Phần tử giả ​

Phần tử giảMô tả
::before—

Trạng thái ​

Trạng tháiMô tả
:disabled—

Khả năng truy cập ​

Sử dụng một fieldset có nhãn và một tên radio chung với một mặc định được đánh dấu. Các radio gốc thông báo trạng thái được chọn của chúng; các nút tràn cần nhãn mô tả hướng cuộn của chúng.

Điều kiệnĐổi thương hiệu (sáng)Đổi thương hiệu (tối)CanvasCanvas tương phản cao
forced-colors-focus-visibleWCAG 2.2 1.4.11, 2.4.7FailFailFailFail

Khi bật chế độ màu cưỡng bức, không có gì thay đổi rõ rệt khi điều khiển nhận tiêu điểm. Vòng tiêu điểm được vẽ bằng box-shadow hoặc màu nền sẽ biến mất trong chế độ màu cưỡng bức. Hãy dùng outline.

less-contrast-stays-readableWCAG 2.2 1.4.3FailFailPassPass

Đổi thương hiệu (sáng): Với prefers-contrast: less, ba đoạn văn bản có độ tương phản thấp hơn mức tối thiểu. Tệ nhất là "Điểm số", ở mức 1.48:1 (cần 4.5:1). Độ tương phản thấp hơn vẫn ổn miễn là văn bản còn dễ đọc.

Đổi thương hiệu (tối): Với prefers-contrast: less, ba đoạn văn bản có độ tương phản thấp hơn mức tối thiểu. Tệ nhất là "Điểm số", ở mức 1.38:1 (cần 4.5:1). Độ tương phản thấp hơn vẫn ổn miễn là văn bản còn dễ đọc.

reduced-motion-respectedWCAG 2.2 2.3.3, 2.2.2PassPassPassPass
reduced-transparency-respectedWCAG 2.2 1.4.3, 1.4.11PassPassKhông áp dụngKhông áp dụng
reflow-at-320pxWCAG 2.2 1.4.10PassPassPassPass
text-spacing-no-clippingWCAG 2.2 1.4.12PassPassPassPass
Trình đọc màn hình (mô phỏng)Đổi thương hiệu (sáng)Đổi thương hiệu (tối)CanvasCanvas tương phản cao
AnnouncementsPassPassPassPass

Các kết quả tự động này không chứng minh rằng trang đáp ứng WCAG; vẫn cần đánh giá thủ công.

Token tiêu thụ ​

TokenKiểuGiá trị
--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——

Các thành phần phụ ​