[feat]: Create `<pf-v6-drag-drop>` element

Đang mở
#3,006 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

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
30/100
Loại issue
Tính năng
Độ rõ ràng
Cần làm rõ
Mức độ hoạt động
Ít trao đổi
Công nghệ
typescript

Hướng nghiên cứu

Start by reading .claude/ADVICE.md and the @patternfly/react-drag-drop reference, then resolve whether this should be an element, controller, mixin, or native drag-and-drop implementation. Define the public API and accessibility behavior before building the demos and tests. Done means visual and feature parity, documented API coverage, accessibility checks, review commands, linting, a changeset, and a PR targeting staging/pfv6.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

1:1 for dev priority: medium

Summary

Create a <pf-v6-drag-drop> web component implementing the PatternFly v6 Drag and drop component (@patternfly/react-drag-drop).

Drag-and-drop reordering for lists and multi-zone transfers.

Prior Art

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

Notes

Consider whether this should be an element or a controller/directive that enhances existing list elements. The web component approach may differ significantly from the React HOC/context pattern.

Requirements

  • MUST implement PFv6 visual designs
  • MUST provide end-user feature parity with @patternfly/react-drag-drop
  • 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

  • React uses @dnd-kit library; web component may use native HTML5 drag-and-drop or @dnd-kit wrapped in a Lit controller
  • Architectural decision required: element vs Lit controller/mixin vs native drag events
  • Sub-components: DragDropSort (single list reorder), DraggableObject, DragDropContainer (multi-zone), DroppableObject
  • items prop for data-driven approach; onDrop event fires with new order
  • Keyboard reorder: Space to grab, Arrow keys to move, Space/Enter to drop, Escape to cancel
  • ARIA: aria-grabbed (deprecated but still used), aria-dropeffect; announce position via aria-live
  • Dragging visual: ghost element, drop zone highlight
  • pf-v6-data-list drag variant can use this controller
  • prefers-reduced-motion: skip animation, still support keyboard reorder
  • Touch support: touchstart/touchmove/touchend or pointer events

Checklist

Implementation
  • Architectural decision: element vs controller vs native events
  • 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)
Ngôn ngữ chính
TypeScript
Star
397
Fork
109
Chỉ số merge pull request
Không có pull request nào được merge trong 30 ngày

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. 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.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của patternfly/patternfly-elements

Tất cả issue của patternfly/patternfly-elements

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.