@canvas-components/list-table 0.3.14 → 0.3.15

package/README.md

@@ -13,6 +13,27 @@
 - 列宽调整、列拖拽、行拖拽、轮播滚动
 - 内建二维码、条形码、进度、图表、评分、按钮等单元格内容
 
+### 展开详情自动高度
+
+`expandable.expandedRowRender` 返回标签、文本等富内容时，不传 `expandedRowHeight` 即按实际内容宽度自动换行、测高。容器宽度、列宽、字体或密度变化后会重新计算，并同步更新行位置和滚动范围。测量与绘制共用布局规则，业务侧无需自行测量标签或监听容器宽度。
+
+显式设置 `expandedRowHeight` 数字或回调时仍优先使用该配置；嵌套子表继续使用其独立的内容高度计算。
+
+### 分页尺寸缓存
+
+设置表格 `storageKey` 后，用户切换每页条数会自动保存到 localStorage，下次创建表格时恢复。不同表格应使用不同的键；不缓存页码，不影响滚动加载。无键、缓存无效或浏览器禁用存储时，继续使用默认配置。
+
+显式传入 `pagination.pageSize` 时以受控值为准。外部负责请求的封装（如 WWISuperTable）应在首次请求前读取缓存，初始化自己的分页状态，避免只改变显示值而请求条数不一致：
+
+```ts
+import { getListTableStoredPageSize } from '@canvas-components/list-table';
+
+const initialPageSize = explicitPageSize ?? getListTableStoredPageSize(storageKey) ?? 10;
+// 将 initialPageSize 用于首次请求和受控 pagination.pageSize。
+```
+
+该读取方法也由 `@canvas-components/react-list-table` 导出。
+
 ## 安装方法
 
 ```bash