callstack / callstack/react-native-paper
refactor(list-item): improve layout system and remove implicit child composition
- 主要语言
- TypeScript
- 星标
- 14.5k
- 派生
- 2.2k
- 平均合并
- 5 天 23 小时
- 30 天内合并 PR
- 12
描述
Refactor ListItem to improve Material Design 3 compliance, remove problematic children patterns, improve performance characteristics, and modernize the public API.
**Problems**
- Current API relies heavily on children composition in ways that are difficult to optimize
- Internal layout logic is tightly coupled to arbitrary child structures
- MD3 behaviors and visuals are not fully aligned with current Material guidelines
- Rendering performance can degrade in large lists or frequently updated screens
- Type safety and discoverability of the API can be improved
- The component has inconsistent behavior between platforms and edge cases
**Focus Areas**
- Replace arbitrary child composition with explicit slots
- Improve left/right accessory APIs
- Standardize spacing and density
- Improve multiline layout behavior
- Improve virtualization friendliness
**Proposed API Direction**
Instead of:
`
`
Prefer:
``
**Performance Opportunities**
- Improve rendering in FlatList usage
- Memoize accessories
- Reduce layout passes
- Avoid child traversal
贡献指南
调研方向
该 issue 没有指定实现文件或测试;首先定位 TypeScript ListItem 组件并检查其当前用法,尤其是在 FlatList 中的用法。将针对 title、description、left 和 right 的显式 API 提案与现有的 children API 进行比较,然后在认为重构完成之前,确保覆盖间距、多行布局、平台行为和虚拟化。
由索引模型根据 Issue 内容生成。
评估
- 技术栈
- react-native, typescript
- 领域
- frontend, mobile
- Issue 类型
- 重构
- 难度
- 5/5
- 预计耗时
- 一周以上
- 活跃度
- 活跃
- 描述清晰度
- 需要澄清
- 新手友好度
- 30/100