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 验证
105 lines
5.1 KiB
Vue
105 lines
5.1 KiB
Vue
<template>
|
||
<div class="aa-sidemenu" :class="{ collapsed }" @mouseleave="hoverKey = ''">
|
||
<div
|
||
v-for="it in items" :key="it.key"
|
||
class="aa-menu-item"
|
||
:class="{ 'is-active': modelValue === it.key, 'is-open': openKeys.includes(it.key), 'is-disabled': it.disabled }"
|
||
@click="onTopClick(it)"
|
||
@mouseenter="onHover(it, $event)"
|
||
>
|
||
<span class="aa-menu-icon">{{ it.icon }}</span>
|
||
<span class="aa-menu-label">{{ it.label }}</span>
|
||
<span v-if="it.badge" class="aa-menu-badge">{{ it.badge }}</span>
|
||
<span v-if="it.children && it.children.length" class="aa-menu-arrow">›</span>
|
||
</div>
|
||
|
||
<template v-for="it in items" :key="'c-' + it.key">
|
||
<div v-if="it.children && it.children.length && openKeys.includes(it.key) && !collapsed" class="aa-menu-children">
|
||
<div
|
||
v-for="c in it.children" :key="c.key"
|
||
class="aa-menu-item" :class="{ 'is-active': modelValue === c.key }"
|
||
@click="select(c.key)"
|
||
>
|
||
<span class="aa-menu-label">{{ c.label }}</span>
|
||
</div>
|
||
</div>
|
||
</template>
|
||
|
||
<!-- 折叠态悬浮浮层 -->
|
||
<div v-if="collapsed && hoverKey && popItem" class="aa-menu-pop" :style="{ top: popTop + 'px' }">
|
||
<div class="aa-menu-pop-title">{{ popItem.label }}</div>
|
||
<template v-if="popItem.children && popItem.children.length">
|
||
<div
|
||
v-for="c in popItem.children" :key="c.key"
|
||
class="aa-menu-item" :class="{ 'is-active': modelValue === c.key }"
|
||
@click="select(c.key)"
|
||
><span class="aa-menu-label">{{ c.label }}</span></div>
|
||
</template>
|
||
<div v-else class="aa-menu-item is-active" @click="select(popItem.key)"><span class="aa-menu-label">{{ popItem.label }}</span></div>
|
||
</div>
|
||
</div>
|
||
</template>
|
||
|
||
<script setup>
|
||
import { ref, computed } from 'vue';
|
||
|
||
const props = defineProps({
|
||
modelValue: { type: String, default: '' }, // 当前选中 key
|
||
items: { type: Array, required: true }, // [{ key, label, icon?, badge?, children?, disabled? }]
|
||
collapsed: { type: Boolean, default: false }
|
||
});
|
||
const emit = defineEmits(['update:modelValue', 'select']);
|
||
|
||
const openKeys = ref([]);
|
||
const hoverKey = ref('');
|
||
const popItem = computed(() => props.items.find(x => x.key === hoverKey.value) || null);
|
||
const popTop = ref(0);
|
||
|
||
function onHover(it, e) {
|
||
if (props.collapsed && it.children) { hoverKey.value = it.key; popTop.value = e.currentTarget.offsetTop; }
|
||
}
|
||
function onTopClick(it) {
|
||
if (it.disabled) return;
|
||
if (it.children && it.children.length) {
|
||
if (props.collapsed) return;
|
||
openKeys.value = openKeys.value.includes(it.key) ? openKeys.value.filter(k => k !== it.key) : [...openKeys.value, it.key];
|
||
} else {
|
||
select(it.key);
|
||
}
|
||
}
|
||
function select(key) {
|
||
emit('update:modelValue', key);
|
||
emit('select', key);
|
||
hoverKey.value = '';
|
||
}
|
||
</script>
|
||
|
||
<!-- 样式对齐 组件7.txt SideMenu 规范 -->
|
||
<style scoped>
|
||
.aa-sidemenu { width: 220px; background: #fff; border-right: 1px solid #E8ECF1; font-family: var(--font-family, -apple-system, "PingFang SC", "Microsoft YaHei", sans-serif); color: #262626; user-select: none; }
|
||
.aa-sidemenu.collapsed { width: 56px; }
|
||
.aa-menu-item { position: relative; display: flex; align-items: center; gap: 8px; height: 44px; padding: 0 16px; cursor: pointer; font-size: 14px; color: #262626; transition: background .15s, color .15s; }
|
||
.aa-menu-item:hover { background: #F5F7FA; }
|
||
.aa-menu-item.is-active { background: #F0F5FF; color: #2F54EB; font-weight: 500; }
|
||
.aa-menu-item.is-active::before { content: ''; position: absolute; left: 0; top: 0; bottom: 0; width: 3px; background: #2F54EB; }
|
||
.aa-menu-item.is-disabled { color: #BFBFBF; cursor: not-allowed; }
|
||
.aa-menu-item.is-disabled:hover { background: none; }
|
||
.aa-menu-icon { width: 16px; text-align: center; flex-shrink: 0; font-size: 15px; }
|
||
.aa-menu-label { flex: 1; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
|
||
.aa-menu-badge { background: #CF1322; color: #fff; font-size: 11px; min-width: 16px; height: 16px; border-radius: 8px; padding: 0 5px; display: inline-flex; align-items: center; justify-content: center; }
|
||
.aa-menu-arrow { color: #6E6E6E; font-size: 12px; transition: transform .15s; }
|
||
.aa-menu-item.is-open > .aa-menu-arrow { transform: rotate(90deg); }
|
||
.aa-menu-children { background: #FAFAFA; }
|
||
.aa-menu-children .aa-menu-item { height: 40px; padding-left: 40px; font-size: 13px; }
|
||
.aa-menu-children .aa-menu-item.is-active::before { display: none; }
|
||
.aa-sidemenu.collapsed .aa-menu-label,
|
||
.aa-sidemenu.collapsed .aa-menu-badge,
|
||
.aa-sidemenu.collapsed .aa-menu-arrow { display: none; }
|
||
.aa-sidemenu.collapsed .aa-menu-item { justify-content: center; padding: 0; }
|
||
.aa-sidemenu.collapsed .aa-menu-children { display: none; }
|
||
.aa-menu-pop { position: absolute; left: 56px; top: 0; min-width: 180px; background: #fff; border: 1px solid #E8ECF1; border-radius: 6px; box-shadow: 0 4px 12px rgba(0,0,0,0.12); padding: 4px 0; z-index: 200; }
|
||
.aa-menu-pop-title { padding: 6px 16px; font-size: 12px; color: #6E6E6E; }
|
||
.aa-menu-pop .aa-menu-item { padding: 0 16px; }
|
||
.aa-menu-pop .aa-menu-item::before { display: none; }
|
||
</style>
|