Defaults 是一个界面默认规范技能,收拢那些应当在每一屏都生效的界面默认做法。它覆盖表面(surface)、字体排版、声音、焦点、表单、加载与浮层等主题。
使用方式与边界 优先使用项目已有的 token(设计变量);当某个值在项目中没有对应 token 时,文中给出的值是精确值。无论何种风格,硬性滚动裁切或被裁掉的阴影都应被视为问题。文案措辞与标点属于文案范畴;用项目基础组件搭建属于复用范畴;某个声音或动画是否应该存在属于克制范畴;运动方式属于动效范畴;颜色与对比度属于颜色范畴;同心圆角、视觉微调与图标对齐属于对齐范畴。
滚动与浮层 滚动容器在两端用 mask-image 渐变渐隐,溢出边缘硬裁切记为违规。滚动容器需留足内边距,让子元素阴影完整落在其中,避免被 overflow: hidden 裁掉。代码块与数据表横向滚动并隐藏滚动条,不换行。可滚动对话框、抽屉、菜单与侧栏设置 overscroll-behavior: contain,避免滚到尽头时把背后页面一起滚动。吸顶或吸底栏与内容交界处加 1px 边框;把 scroll-padding-block-start 设为吸顶栏高度,确保锚点与聚焦字段落在其下方。浮动的弹出层、菜单或卡片用阴影加半透明 1px 描边环(在阴影栈内),并在环下保留 1px 透明边框以便强制色模式仍能画出边缘。阴影按项目 elevation token;没有则用三层向下偏移阴影,模糊增大、透明度递减。悬停抬升表面用伪元素淡入承载抬升阴影,而不是对 box-shadow 做过渡。内容图片加 1px 内缩描边(浅色黑 10%、深色白 10%),logo 与透明图除外。卡片不嵌套;按钮与标签使用圆角 token 而非胶囊形;去掉装饰性渐变、辉光、模糊与纵深效果。
主题、焦点与可达性 深色主题在根上设置 color-scheme: dark,使滚动条与原生控件跟随;每种配色方案设置一个 theme-color,与页面顶部一致。主题切换时关闭一帧过渡,避免所有颜色同时渐变。焦点环仅用 :focus-visible 与 outline,不为鼠标点击显示。对话框打开时把焦点移入、Tab 保持在内部,关闭时归还触发器;原生 <dialog> 的 showModal() 已处理焦点陷阱。交互目标短边至少 24px,鼠标瞄准 40px、触摸瞄准 44px,字形较小时用负 inset 伪元素扩展命中区,扩展区不得重叠。图标按钮需带 aria-label 说明用途;状态不能只靠颜色,需配图标或文字。导航用 <a href>,以便新标签打开、中键点击与复制链接。筛选、标签页、分页与展开面板写入 URL,刷新、分享与后退均可保留。viewpor 标签不得设 maximum-scale=1 或 user-scalable=no。根上设 -webkit-tap-highlight-color: transparent,每个可点击元素有自己的 :active 状态,并设 touch-action: manipulation 加快点击响应。仅悬停样式包在 @media (hover: hover) and (pointer: fine) 内,避免触摸屏残留。
布局与内容 应用外壳或底部固定栏用 100dvh,首屏用 min-height: 100svh。viewport 加 viewport-fit=cover,并给固定头部、标签栏、Toast 与底部面板加 env(safe-area-inset-*) 内边距。按钮、标签、芯片与拖拽手柄设 user-select: none,正文保持可选。快捷键在输入框、textarea 或可编辑元素聚焦时不触发。单字段表单或从最后一个字段按 Enter 提交;textarea 中 Enter 换行、⌘/Ctrl+Enter 提交。字段接受用户粘贴的格式(如卡号空格、电话括号),在代码中清洗并规范展示,不阻止粘贴,并去掉键盘附带的尾随空格。每个字段设置 type、inputmode 与 autocomplete;移动端输入字号 16px 及以上,避免 iOS 聚焦时缩放。每个控件都有标签,点击标签可操作控件。表单在提交时校验,提交按钮在请求开始前保持可用,提交时在字段旁显示错误并聚焦第一个错误。请求进行中按钮保留文字、显示指示器并禁用自身。破坏性操作提供撤销;无法撤销时用菜单或弹出层就地确认。价格、计数、计时器与表格列使用 tabular-nums。标题用 text-wrap: balance,正文段落用 text-wrap: pretty。根上一次性设置字体平滑。行内等宽代码降为 0.9em。被截断且用户需要的文本可通过提示、展开控件或详情查看完整内容;文件名与路径从中部截断,数字、金额与日期不截断。用最长真实值测试各字段;文本列设 min-width: 0,头像等固定框设 flex-shrink: 0,邮箱与 URL 设 overflow-wrap: anywhere。缺失的可选字段整行省略,不显示占位符。数字、日期与复数通过 Intl.NumberFormat、Intl.DateTimeFormat 与 Intl.PluralRules 按区域格式化。Toast、结果计数与行内校验放在 role="status" 的礼貌实时区域,文本变化前先渲染为空。操作在 400ms 内响应,或立刻以乐观值、骨架屏或进度条给出反馈;骨架屏延迟 150–300ms 出现,出现后至少保持 300–500ms,并与所替代布局匹配。声音只用于确认(支付、上传、提交)与不可忽略的错误,且每个声音都有可见对应物;打字、悬停、滚动与键盘导航不出声;用户可关闭声音,音量初始为 0.3。一次只开一个对话框,不在对话框上再叠加对话框,改用菜单、弹出层或新页面。
资料还以「规则 / 错误做法 / 替代做法」成对列出每条检查项,便于在实现与评审中逐条对照;具体代码配方记录在 recipes.md 中。