[feat]: Create `<pf-v6-multiple-file-upload>` element

Aperta
#3,023 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
38/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Stack tecnologico
typescript

Direzione di ricerca

Start by reading .claude/ADVICE.md and the dependent pf-v6-file-upload issue (#2693), then review the PatternFly v6 Multiple file upload design and the repository's existing element structure. Done means the component, demos, public API tests, accessibility snapshots, styling checks, review commands, changeset, and staging/pfv6 targeting satisfy the listed checklist.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

1:1 for dev priority: medium

Summary

Create a <pf-v6-multiple-file-upload> web component implementing the PatternFly v6 Multiple file upload component.

Multi-file upload with drag-and-drop, per-file progress indicators, and file list management.

Prior Art

Source Element Status
PFE v4 -- --
cem -- --
cockpit -- --
chickadee -- --

Requirements

  • MUST implement PFv6 visual designs
  • MUST provide end-user feature parity with @patternfly/react-core MultipleFileUpload
  • MAY adjust element API to leverage web platform strengths
  • SHOULD maintain CSS custom property theming compatibility
  • SHOULD expose useful CSS shadow parts

Element-specific considerations

  • Depends on pf-v6-file-upload (#2693) - port that first
  • <input type="file" multiple> under the hood
  • Sub-components: MultipleFileUploadMain (drop zone), MultipleFileUploadInfo (status text), MultipleFileUploadStatus (file list), MultipleFileUploadStatusItem
  • Drag-and-drop zone shared with single upload; isDragActive state
  • Per-file status item: filename, file size, progress bar, remove button, success/error icon
  • onFileDrop / onFileInputChange events bubble the full FileList
  • Upload progress managed externally (consumer tracks progress per file and updates props)
  • isHorizontal layout variant
  • FACE: formAssociated may not apply here (multi-file forms typically use FormData manually); evaluate whether ElementInternals helps
  • Remove button per file: fires onFileRemove event with filename

Checklist

Implementation
  • API per .claude/ADVICE.md
  • CSS uses v6 tokens, logical properties, nesting
  • @summary and JSDoc on element class
Demos
  • Demos match patternfly.org naming/structure
  • CSS custom properties match computed styles from patternfly.org (Chrome MCP)
  • Visual parity verified via Chrome MCP
Tests
  • Public API covered (attributes, properties, events, slots)
  • a11ySnapshot assertions
Reviews
  • /review-api passes
  • /review-demos passes
  • /review-a11y passes
  • eslint and stylelint pass
Ship
  • Add changeset
  • PR targets staging/pfv6 (NOT main)
Lingua principale
TypeScript
Stelle
397
Fork
109
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di patternfly/patternfly-elements

Tutte le issue di patternfly/patternfly-elements

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.