[feat]: Update `<pf-v6-helper-text>` for PatternFly v6
Đánh giá
Issue này chưa được đánh giá.
Mô tả
Summary
Update `` to implement the PatternFly v6 Helper text component.
Contextual help or validation messages displayed beneath form fields, with status variants (default, success, warning, error).
Prior Art
| Source | Element | Status |
|---|---|---|
| PFE v4 | `` | Exists |
| cem | -- | -- |
| cockpit | -- | -- |
| chickadee | `` | Similar |
Sub-components
- `` - Individual helper text message with optional icon
Requirements
- MUST implement PFv6 visual designs
- MUST provide end-user feature parity with `@patternfly/react-core` HelperText
- 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 `component`: `div` or `ul` - drives whether items render as `
- `; may not need attribute if slot handles it semantically
- React `isLiveRegion` - adds `aria-live="polite"` and `aria-atomic`; map to `live` attribute
- `HelperTextItem` props: `variant` (`default`, `indeterminate`, `warning`, `success`, `error`), `hasIcon`, `isDynamic`, `icon` (custom icon)
- `isDynamic` on item - item is dynamically shown/hidden (live region relevance); verify v6 behavior
- Items with `error` variant should set appropriate `aria-live` or be associated via `aria-describedby` on the field
- Consider whether `` needs to be a separate custom element or a slotted pattern
Checklist
Rename
- Delete `elements/pf-v5-helper-text/`
- Update `elements/package.json` exports
- Update `eslint.config.js` ignore globs if applicable
- Update docs `_snippets/` and `framework-integration/` references
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
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- 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.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của patternfly/patternfly-elements
-
bug
patternfly/patternfly-elements#3158 · 1 người được giao ·
-
patternfly/patternfly-elements#3136 · 1 bình luận · 1 người được giao ·
-
docs
patternfly/patternfly-elements#3131 · 1 người được giao ·
-
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 55/100
patternfly/patternfly-elements#3122 ·
-
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 38/100
patternfly/patternfly-elements#3118 ·
Tất cả issue của patternfly/patternfly-elements
Issue tương tự
-
VerificationGate: ATTRIBUTION quote guard never matches a normal quotation (\b around the quote) Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
danielmiessler/LifeOS#2234 ·
-
T: Bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 65/100
-
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 85/100
-
Mend: dependency security vulnerability untriaged
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100