侧边栏灰阶应按层级而非纯黑白区分
要解决的问题
侧栏通常同时包含工作区身份、搜索、导航、当前项、辅助入口和账户信息。若所有文字与图标都使用同一黑色,界面会显得僵硬;若为了「柔和」把所有层级都变淡,又会损失可读性和当前位置。灰阶需要按职责分配,而不是只选一个好看的灰色。
规则和其他情况说明
- 核心规则:为背景、容器、主文字、次文字、图标、当前项和禁用状态建立不同灰阶职责。
- 当前项与 hover 要分开:示例 Dashboard 使用浅灰选中底,右侧还有窄条标记;其他状态不应复用完全相同的组合(E1)。
- 辅助入口弱于主导航但保持可读:底部 GST portal、Settings 与账户区可以较低权重,不能淡到像禁用(E1)。
- 色板必须放回组件比较:同一组灰阶在色卡上差异明显,进入浅背景侧栏后可能无法区分,需要在真实间距和字号下评审。
- 灰阶不等于绝对无色:四组对照呈现不同冷暖倾向,选择会影响整体气质,但仍要检查状态对比(E1)。
建议的Token职责
sidebar-bg:整个侧栏表面,与主内容区形成适度边界。sidebar-item-hover:指针或焦点经过时的临时反馈,弱于当前项。sidebar-item-active:当前页面容器,需与普通行稳定区分。sidebar-text-primary:当前导航和主要名称。sidebar-text-secondary:辅助入口与元信息,仍满足可读要求。sidebar-icon:与对应文字保持关联,不必所有图标都使用同一深度。sidebar-divider:只辅助分区,不替代间距和分组结构。
这些是职责命名示例,不是从截图测得的色值规范。
状态检查
- 默认、hover、focus、active、disabled 需要在同一灰阶体系中可区分。
- 当前项的背景、文字、图标和侧边标记不必全部同时使用;应避免多层强调叠加。
- 深色主题不能直接反转所有色阶,需要重新检查表面与文字对比。
- 搜索框、快捷键徽章和底部账户区也属于侧栏,不应在主行之外使用另一套灰色。
关键截图与效果

- 来源:作者对 Tailwind 灰阶方案的组件内对照。
- 页面或任务场景:四个相同侧栏并排,包含搜索、通知、五个主导航、当前 Dashboard、辅助入口和账户区。
- 具体观察:四组方案的背景与图标呈现不同冷暖倾向;当前项均通过浅灰容器与右侧标记突出,其他导航保持较低权重(E1)。
- 支持的结论:灰阶评审应比较完整组件和状态,而不是孤立比较色板;冷暖变化也会改变同一层级的感知。
- 证据限制:截图没有 hover、禁用或深色主题,不能据此完成全状态对比验证。
适用场景
- 仪表盘、文档、设置和文件产品的桌面侧栏。
- 需要统一浅色或深色导航 Token,并评估多套灰阶倾向的项目。
不适用场景
- 不能只通过降低对比制造「高级感」,辅助文字和图标仍要可读。
- 不以单一截图选定最终色板;不同显示器、主题和系统渲染可能改变感知。
- 作者仍在比较方案,这些不是 Tailwind 或项目的最终官方规范。
复核清单
- 默认、hover、focus、active、disabled 是否各自可辨。
- 当前项是否在灰度和色弱条件下仍成立。
- 次要文字、快捷键和图标是否可读且不像禁用。
- 亮暗主题、真实字号与主内容背景并排时是否仍保持层级。
来源与证据边界
- 原帖:https://x.com/iamsahilvhora/status/2042111791271162291
- 只有浅色静态对照,未测量色值或对比度,状态保持
draft。