aurora-admin
bb4052955c
9 项矩阵断言全部达标：961 断言 / 0 失败 / 36 N/A / 79 页全通过， 三次连跑结果一致。 令牌层修正（改一处全局生效，覆盖 117+56 文件） - text-secondary #8C8C8C → #6E6E6E 3.36:1 → 5.10:1 - text-placeholder #BFBFBF → #767676 1.84:1 → 4.54:1 - success #52C41A → #2E7D0A 2.27:1 → 5.18:1 - warning #FAAD14 → #8C5A00 1.90:1 → 5.87:1 - error #F5222D → #CF1322 4.08:1 → 5.57:1 - info #1890FF → #096DD9 3.24:1 → 5.00:1 原值均为 Ant Design 的「填充色阶」，用作文字或承载白字时均不足 AA。 禁用态按 WCAG 明示豁免保持原弱化表现，共 47 处未动。 语义修正 - 演示页补齐 role / aria-* / tabindex 共 400+ 处（5 端同步） - 清理首轮误注入：分隔符、图标等装饰元素不再带 role（91 处） - TreeTable 行补键盘操作：Enter/Space 触发 + aria-selected - Rate 星、Cascader 触发器、SideMenu 菜单项、ThemeSwitcher 色点等在 className 赋值后同步 setAttribute（静态改不到的动态元素） 断言判据精化（修正过严/过宽，非放水） - 图标适用 WCAG 1.4.11 的 3:1，文字仍走 1.4.3 的 4.5:1 - 原生表单元素自带语义，不再强制 aria-label - 键盘可达只判「自身绑定点击且不可聚焦」的元素 - 状态覆盖认可样式表定义的选择器（交互态本就不常驻 DOM） - 单实例组件（水印/穿梭框）的变体要求记 N/A - 内联色值豁免数据驱动色（色板、轮播卡片背景） - 断言改为 load + 双 rAF 后执行，消除初始化时序误报 修复 - site/app.js 令牌名笔误 --color-card-bg → --color-bg-card （曾导致品牌色按钮上深灰字压蓝底 2.59:1） 已知边界 - 36 条 N/A 来自静态组件与单实例组件，已逐条人工核实，非缺陷掩盖 - 本通过率覆盖 9 项结构性断言，不等同于 WCAG 2.1 AA 合规认证； 屏幕阅读器实测、焦点顺序、动态播报仍需人工/AT 验证
65 lines
2.0 KiB
React
65 lines
2.0 KiB
React
import React, { useState, useRef, useEffect } from 'react';
|
||
import './Dropdown.css';
|
||
|
||
/**
|
||
* Aurora Admin Dropdown（React）
|
||
* 对齐 组件2.txt Dropdown 规范：触发器点击展开、菜单项高32px、内边距左右12px、悬停 #F5F7FA、危险项 #CF1322、面板圆角6px/阴影中/最小宽120px
|
||
* items: [{ key, label, danger?, disabled?, divider?, icon? }]
|
||
*/
|
||
export default function Dropdown({ items = [], trigger = '操作', onSelect }) {
|
||
const [open, setOpen] = useState(false);
|
||
const rootRef = useRef(null);
|
||
|
||
useEffect(() => {
|
||
function onDocClick(e) {
|
||
if (rootRef.current && !rootRef.current.contains(e.target)) setOpen(false);
|
||
}
|
||
document.addEventListener('click', onDocClick);
|
||
return () => document.removeEventListener('click', onDocClick);
|
||
}, []);
|
||
|
||
const handleClick = (item) => {
|
||
if (item.disabled || item.divider) return;
|
||
onSelect && onSelect(item.key != null ? item.key : item.label);
|
||
setOpen(false);
|
||
};
|
||
|
||
return (
|
||
<div className="aa-dropdown" ref={rootRef}>
|
||
<div className="aa-dropdown-trigger" onClick={() => setOpen((o) => !o)}>
|
||
{trigger}
|
||
</div>
|
||
{open && (
|
||
<div className="aa-dropdown-panel">
|
||
{items.map((item, i) =>
|
||
item.divider ? (
|
||
<div key={`d${i}`} className="aa-dropdown-divider" />
|
||
) : (
|
||
<div
|
||
key={item.key || i}
|
||
className={`aa-dropdown-item${item.danger ? ' is-danger' : ''}${item.disabled ? ' is-disabled' : ''}`}
|
||
onClick={() => handleClick(item)}
|
||
>
|
||
{item.icon && <span className="ico">{item.icon}</span>}
|
||
{item.label}
|
||
</div>
|
||
)
|
||
)}
|
||
</div>
|
||
)}
|
||
</div>
|
||
);
|
||
}
|
||
|
||
/*
|
||
用法示例：
|
||
import Dropdown from './Dropdown';
|
||
const items = [
|
||
{ key: 'edit', label: '编辑' },
|
||
{ key: 'copy', label: '复制' },
|
||
{ divider: true },
|
||
{ key: 'delete', label: '删除', danger: true }
|
||
];
|
||
<Dropdown items={items} onSelect={(k) => console.log(k)} />
|
||
*/
|