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

オープン
#1,226 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
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分
マージ済み PR(30日)
378

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

codeatlasdev/ui のほかの issue

codeatlasdev/ui の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。