Recorte de imagem com ponto focal (moldura proporcional, arrastar, teclado, saída 2x)

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

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
38/100
Issue 类型
功能
描述清晰度
基本清楚
活跃度
活跃
技术栈
html, tailwindcss, typescript

调研方向

Start from index.ts exports and Image.svelte to match existing API conventions, then add a pure cropPlan module under ./utils/crop and an ImageCrop component. Verify against the acceptance criteria: 3000×1500 at 16:9 exports 3840×2160 within 1e-2, drag clamps within source bounds, arrow steps of 0.02 update aria-valuetext, and canvas.toBlob honors the requested MIME type. The private AC paths are reference only, so rely on the proposed API and write component tests for the geometry helpers plus the 390 px layout.

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

描述

area:components area:forms 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

(leitura de origin/main: index.ts exports e Image.svelte lido via raw) Image tem ratio e fit (cover/contain) para exibir, mas não recorta nem exporta arquivo. FileUpload tem capture e drop. Não há cropper nem ponto focal.

Referência no AC

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

apps/web/src/components/videowall-banners/crop-dialog.tsx (CropDialog, renderCrop, moldura role="slider", setas de 0,02, "Cortar e enviar" e "Manter e usar ponto focal"); banners.helpers.ts:273-296 (cropPlan com retinaScale 2, focalFromCrop); components/creative/art-uploader.tsx:40, 93-98, 149-183 ("Ajustar recorte" abre o diálogo com slot e orientation).

Defeitos do AC (verificados por leitura do código): (leitura) nenhum visível. Ponto focal sem alternativa de toque fora do arrastar: as setas cobrem teclado.

Proposta

<ImageCrop bind:focal src mime={image/jpeg|image/png} aspect={{w,h}} retina={2} onconfirm={(blob) => {}} onkeepfocal={(f) => {}} />, com cropPlan puro exportado (./forms ou ./utils/crop), saída via canvas.toBlob e :focus-visible nas setas. Sem crossorigin a saída falha: documentar.

Critério de aceite (testável)

  • Imagem 3000×1500 com aspecto 16:9 gera saída 3840×2160 (retina 2x) e o blob respeita a proporção com erro ≤ 1e-2.
  • Arrastar a moldura até a borda mantém crop.left >= 0 e crop.left + crop.width <= src.width.
  • Setas movem o foco em passos de 0,02 e o aria-valuetext mostra "Ponto focal X% x, Y% y".
  • Com mime="image/png" o blob tem type image/png; com JPEG, image/jpeg.
  • Em 390 px, o diálogo ocupa a folha inferior e a moldura cabe em max-h-[55vh] sem rolagem horizontal.

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 摘要。