callstack / callstack/react-native-paper

refactor(list-item): improve layout system and remove implicit child composition

未关闭
#4,930 2 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看
v6
主要语言
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

把新 issue 发到你的邮箱

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