[feat]: Create `<pf-v6-tree-view>` element

Đang mở
#3,049 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
35/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
typescript

Hướng nghiên cứu

Start with .claude/ADVICE.md and review the PatternFly v6 Tree view design and @patternfly/react-core feature set. Define the element and tree-item API, demos, and public accessibility tests around the listed variants, keyboard behavior, attributes, properties, events, and slots. Done means the implementation, demos, a11ySnapshot assertions, review commands, lint checks, changeset, and staging/pfv6 targeting all pass.

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-tree-view> web component implementing the PatternFly v6 Tree view component.

Hierarchical tree display for nested data, with expandable nodes, checkboxes, and action menus.

Prior Art

Source Element Status
PFE v4 -- --
cem <pf-v6-tree-view> Exists
cockpit <pf-v6-tree-view> Exists
chickadee -- --

Sub-components

  • <pf-v6-tree-item> - Individual tree node

Requirements

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

  • Tree ARIA pattern: role="tree" on root, role="treeitem" per node, role="group" on child lists
  • aria-expanded on expandable nodes, aria-selected for selection
  • Keyboard: Arrow Up/Down navigate siblings, Arrow Right expands/enters children, Arrow Left collapses/exits, Home/End jump to first/last, Enter/Space select
  • hasCheckboxes variant: each node has checkbox; aria-checked for tri-state (indeterminate when partial children selected)
  • hasActions variant: action button per node (e.g., edit, delete)
  • hasBadges variant: badge on each node showing child count
  • hasGuides variant: vertical guide lines
  • isNested for compact nested style
  • onSelect event with node data; onExpand / onCollapse
  • activeItems prop for controlled selection
  • Search/filter: onSearch callback or toolbar integration
  • Data-driven API: data prop array vs slotted <pf-v6-tree-item> children - evaluate both approaches

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)
Ngôn ngữ chính
TypeScript
Star
394
Fork
107
Chỉ số merge pull request
Không có pull request nào được merge trong 30 ngày

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

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.