Paridade Liquid Glass: valores e borda do AC como receita da lib

未关闭
#1,226 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
3/5
预计耗时
1-2 天
新手友好度
55/100
Issue 类型
功能
描述清晰度
描述清楚
活跃度
活跃
技术栈
css, typescript
领域
design, frontend

调研方向

Start in lib/styles/tokens.css (the --ca-blur-regular declarations for light and dark) and lib/styles/materials.css / surface.css, then check base.css where solid is the default; the opt-in path is designStyle("liquid"), added in CHANGELOG a1d14f5. Extend defineTheme with a glass block that writes --ca-blur-regular, --ca-glass-tint, --ca-overlay-bg and --ca-surface-glass-edge, keeping the edge as a box-shadow inset rather than a border, and add an optional glass-ac design style alongside liquid. Done means the four acceptance checks pass: computed backdropFilter contains blur(24px) saturate(180%) under data-style="glass", borderTopWidth stays 0px, the overlay contrast test holds at the 0.94 fill, and light/dark Card VRTs are unchanged.

由索引模型根据 Issue 内容生成。

描述

area:theme enhancement

Versão: @codeatlasdev/ui 4.6.0 · código lido em main (950628f2) · classe: lacuna (migração do AC)

Problema

O AC depende deste comportamento hoje e a lib não o oferece. Sem ele, a migração perde qualidade no desktop, no mobile ou no PWA.

O que a lib já oferece (para não duplicar) e o que falta

Tiers de vidro existem (lib/styles/materials.css e surface.css, raw em 950628f2). Padrão é solid (base.css raw: mesh só em glass/frosted). Clone: --ca-blur-regular em tokens.css tem blur(22px) saturate(190%) claro e saturate(180%) escuro. O AC usa blur(24px) saturate(180%) em tudo. Opt-in de glass é designStyle("liquid") (clone CHANGELOG a1d14f5).

Referência no AC

Caminhos do repo AC (repo privado, só caminho):

packages/ui/src/styles.css:189-200 (claro), :330-340 (escuro), :1329-1348 (.glass-surface, .glass-overlay), packages/ui/src/components/card.tsx:18-19, dialog.tsx:57, sheet.tsx:126, drawer.tsx:102.

Defeitos do AC (verificados por leitura do código): Valores de vidro repetidos como literais em 11 declarações inline (ver D1). O mesmo look não sai de um único token.

Proposta

defineTheme({ glass: { blur: '24px', saturate: '180%', fill: 0.55, overlayFill: 0.94, edge: 'specular' } }), que escreve --ca-blur-regular, --ca-glass-tint, --ca-overlay-bg e --ca-surface-glass-edge. Sem border de vidro. Receita designStyle('glass-ac') opcional, para não quebrar liquid.

Critério de aceite (testável)

  • Com data-style="glass", getComputedStyle(el).backdropFilter de um Surface regular contém blur(24px) e saturate(180%).
  • A borda de vidro é box-shadow com inset 0 1px 0: borderTopWidth é 0px.
  • overlayFill abaixo de 0,94 falha em teste de contraste (≥4,5:1 no texto do overlay).
  • VRT claro e escuro do Card glass sem regressão.

Mãe: #1089

主要语言
TypeScript
星标
6
派生
3
平均合并
5 小时 21 分钟
30 天内合并 PR
378

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

codeatlasdev/ui 的其他 Issue

查看 codeatlasdev/ui 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。