Rodapé de ações quebra em linha órfã (Drawer/Dialog/Sheet) + regras de espaço e consistência que o dono do wi cobra em toda tela
Maintainer thường phản hồi trong vòng 1 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức phù hợp với người mới
- 25/100
- Loại issue
- Tính năng
- Độ rõ ràng
- Khá rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- typescript
- Lĩnh vực
- accessibility, design, frontend
Hướng nghiên cứu
Start by reading the related issues #922, #1290, and #1347, then inspect the overlay action footers and AppShellLayout in apps/web. The issue proposes work across overlays, admin list patterns, context selection, status visuals, and date helpers, so identify which proposal is in scope before making changes. For the action footer portion, done means grouped actions stack by container width without orphaned buttons, with a detector and demos at 360 and 1440 px.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Versão: 4.6.0 · App: wi (apps/web: painel, landing, página de status, painel administrativo)
Esta issue junta o que o dono do produto apontou numa sessão longa de revisão do wi, telas reais em 360–1440 px. Cada ponto abaixo foi um defeito que ele viu a olho, não um detector. O padrão é sempre o mesmo: a tela "funciona", mas o espaço não foi planejado. A lib precisa tornar o caminho certo o caminho padrão, porque hoje cada app conserta à mão e o resultado varia.
Relacionadas (esta não as substitui): #922 (princípios de layout), #1003 (UI viva por padrão), #1085 (acabamento é critério de aceite), #1347 (composição por tela), #1290 (detectores consumíveis), #1338 (EmptyState), #1341 (SimpleTable em cartões).
1. Rodapé de ações (Drawer, Dialog, Sheet): o defeito que motivou a issue
No detalhe de um cliente (Drawer à direita), o rodapé tem três ações: "Conceder plano", "Revogar concessão" e "Excluir cliente". O resultado foi duas na primeira linha e a destrutiva sozinha numa segunda linha, alinhada à direita. Parece quebrado.
Causa na lib: .ca-drawer__actions é display: flex; justify-content: flex-end; gap: var(--ca-space-2), sem flex-wrap e sem nenhuma noção de grupo. O app que precisa de mais de duas ações escreve CSS próprio e cada um erra de um jeito (aqui virou uma linha órfã).
O que a lib deveria oferecer, em Dialog, Drawer, Sheet e no rodapé de formulários:
- Dois grupos com nome:
actions(fim da linha: secundária e primária, nessa ordem) eleadingActions(início da linha: destrutiva ou "Cancelar assinatura"). A destrutiva fica longe da primária por padrão. - Uma linha ou empilhado, nunca meio termo: abaixo de uma largura do contêiner (container query, não viewport) os botões viram coluna de largura total, na ordem primária, secundária, espaço, destrutiva. Nunca um botão órfão numa segunda linha, nunca rótulo quebrado.
- Alvo de 44 px no toque, mesma altura para todos do grupo.
- Detector em
@codeatlasdev/ui/testing: "ação órfã" (um botão sozinho numa linha de rodapé quando os outros estão numa linha acima) e "rótulo de botão quebrado".
2. Regras do dono que valem para toda tela
- Espaço vazio sem função é defeito. Faixa vazia dentro de seção, cartão que não abraça o conteúdo, vão entre blocos. Vale igual para o oposto: elementos amontoados.
- Nada quebra de forma estranha. Botão com rótulo em duas linhas, botão órfão, chip ou filtro que passa da largura em 390 px (um
FilterGroupde 7 opções passou de 390 px; o app trocou porSelect). - Uma tela composta cabe inteira (sem rolar) e uma tela de coleção deixa rolar só a coleção (#1347).
- No celular, lista é lista agrupada, não pilha de cartões. Linhas separadas por filete num quadro só; o destaque (plano popular, item com falha) é um fundo leve na linha, não outro cartão. Cinco cartões empilhados com bordas e sombras parecem "jogados".
- Mesma UX em telas do mesmo tipo. Quatro listas de administração (clientes, lista de espera, pagamentos, e-mails) precisam ter o mesmo cabeçalho, a mesma barra (busca, filtro, exportar), a mesma lista (
RecordList), a mesma gaveta de detalhe e a mesma paginação. Hoje a lib temAppList,ResourceTable-like nos apps,SimpleTable,DataTableeRecordList; falta uma receita de "página de CRUD paginada no servidor" que costure essas peças, com filtro e página na URL. - Clicar num registro mostra tudo dele. Um detalhe com três campos frustra; a receita de detalhe deveria prever seções (resumo, relacionados, histórico, atividade) com estado vazio próprio em cada uma.
- Controle de contexto tem lugar fixo. A troca "Área do cliente ↔ Painel administrativo" foi primeiro um cartão solto no topo do conteúdo e pareceu "gambiarra". O
AppShellLayoutnão tem um lugar canônico para seletor de contexto (espaço de trabalho, organização, modo admin) que apareça igual no desktop e no celular. Proposta: slotcontextno topo do painel/rail que vira o título tocável do cabeçalho móvel, com variante de "modo elevado" (faixa e cor de aviso enquanto o contexto é administrativo). - Página "viva", não planilha. A página de status era uma lista de três chips; ficou boa com estado em destaque (selo com pulso na cor do estado), caminho animado da mensagem, barras de 24 h e gráfico. Movimento só com o elemento na tela e ausente sob
prefers-reduced-motion. A lib poderia ter as peças: barra de disponibilidade por intervalo, sparkline com lacunas, indicador de estado com pulso. - Nenhum formatador de hora sem fuso em página renderizada no servidor: SSR em UTC mostrou 12:10 para 09:10. Os helpers de data deveriam aceitar o fuso e documentar o risco.
Critério de aceite sugerido
- Rodapé de ações com
leadingActions, empilhamento por contêiner e o detector de ação órfã, nos três overlays. - Receita "lista de administração" (cabeçalho, barra,
RecordList, gaveta de detalhe com seções, paginação na URL) com demo em 360 e 1440. - Slot de contexto no
AppShellLayoutcom variante de modo administrativo. - Itens 1, 2 e 4 da seção 2 viram texto normativo em #922 e checagem em #1290.
- Ngôn ngữ chính
- TypeScript
- Star
- 6
- Fork
- 3
- Merge trung bình
- 5 giờ 21 phút
- Pull request đã merge (30 ngày)
- 378
Chuẩn bị môi trường
- Không có Dockerfile hay tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của codeatlasdev/ui
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 84/100
codeatlasdev/ui#1340 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
area:a11y area:components bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
codeatlasdev/ui#1336 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 77/100
codeatlasdev/ui#1329 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
good first issue
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 74/100
codeatlasdev/ui#1292 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
area:components enhancement good first issue
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
codeatlasdev/ui#1198 ·
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của codeatlasdev/ui
Issue tương tự
-
Console writes URL credentials to the local log, though AGENTS.md says secrets never reach diskĐang mở
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 86/100
sandbox-quantum/switch#2163 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
automated issue report
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 78/100
Maintainer thường phản hồi trong vòng 1 ngày
-
area/dashboard kind/bug QA/dev-automation
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 75/100
Maintainer thường phản hồi trong vòng 1 ngày
-
bug pydanty:is-working
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
pydantic/pydantic-ai#13939 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
self-host
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100
funmusicplace/mirlo#2625 ·
Maintainer thường phản hồi trong vòng 1 ngày