Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

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

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

还没有人认领这个 Issue。

评估

难度
5/5
预计耗时
一周以上
新手友好度
35/100
Issue 类型
功能
描述清晰度
基本清楚
活跃度
冷清
技术栈
typescript

调研方向

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.

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

描述

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)
主要语言
TypeScript
星标
394
派生
107
PR 合并指标
30 天内没有已合并 PR

贡献指南

打开贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

patternfly/patternfly-elements 的其他 Issue

查看 patternfly/patternfly-elements 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。