iter(g258): select 增加可访问名参数

2026-10-26 22:21:04 +08:00
parent 9a1a6f9ed1
commit 3036f26505
6 changed files with 21 additions and 4 deletions
@@ -641,6 +641,11 @@
            "t": "boolean | Signal<boolean>",
            "d": "禁用态：布尔直接置位，传信号则动态同步；禁用时触发器置灰且不展开弹层"
          },
+          {
+            "n": "ariaLabel",
+            "t": "string",
+            "d": "触发器的可访问名：没有可见 label 关联时（如表格分页条的「每页条数」）给读屏一个名字；缺省不落 aria-label"
+          },
          {
            "n": "onChange",
            "t": "(value: string) => void",
@@ -662,7 +667,8 @@
          "弹层展开时按 Esc 只收起下拉并回焦触发器；若下拉在弹窗/抽屉内，再按一次 Esc 才关外层（逐层关闭）",
          "searchable: true 时打开即聚焦搜索框，输入实时过滤；↑↓/Home/End 只在可见项间移动，无命中显示「无匹配选项」",
          "需要允许「不选」的筛选项就开 clearable：有值时右缘出现 ×，点它把值写成空串并回调 onChange('')，键盘在收起态按 Delete / Backspace 等价",
-          "候选多时给选项加 group：相邻同组合成一段、组首插灰色小标题（段间有分隔线），过滤后整组无命中时标题一起隐藏——搜索路径与键盘 ↑↓ 仍只走真实选项"
+          "候选多时给选项加 group：相邻同组合成一段、组首插灰色小标题（段间有分隔线），过滤后整组无命中时标题一起隐藏——搜索路径与键盘 ↑↓ 仍只走真实选项",
+          "没有可见 label 的场合（工具栏、分页条）传 ariaLabel：触发器只显示当前值文案，读屏需要「这个下拉在选什么"
        ]
      },
      {