diff --git a/docs/components/virtuallist.md b/docs/components/virtuallist.md index 4f76fe4e..59ccfbdb 100644 --- a/docs/components/virtuallist.md +++ b/docs/components/virtuallist.md @@ -4,48 +4,49 @@ 对于这种列表数据,我们可以采用虚拟滚动来进行性能优化。 +> 1. **现在暂时只支持固定高度的列表** +> 2. 以后可以考虑使用 `css3` 属性 [content-visibility](https://developer.mozilla.org/zh-CN/docs/Web/CSS/content-visibility) + ## 演示 ### 基础用法 -对于固定高度, 一次性渲染 `10w` 条数据。 +对于固定高度, 一次性渲染 `1w` 条数据。`item-size` 表示每一行的高度 - @@ -57,4 +58,16 @@ | 参数 | 说明 | 类型 | 默认值 | | --- | --- | --- | --- | -| x | x | x | x | +| `items` | *必传*, 需要展示的数据 | `any[]` | - | +| `item-size` | *必传*, 表项的高度,用于计算滚动大小和位置 | `number` | - | +| `item-class` | 列表项的 `class` | `string` | - | +| `key-field` | 选项 `key` 的字段名, 用于 `v-for` 的 `key`, 不传则用 `index` | `string` | - | +| `buffer` | 冲区数量,列表会在上下多渲染额外的项 | `number` | `2` | + +### VirtualList Slots + + +| 名称 | 说明 | 字段 | +| --- | --- | --- | +| `default` | 渲染列表项内容 | `item`: 列表项数据 | +| `render` | 渲染整个列表项, 需要手动遍历数据列表进行渲染 | `items`: 可现实列表数据 | diff --git a/src/app_components/SourceCode.vue b/src/app_components/SourceCode.vue index 8ea8126f..dfb2495e 100644 --- a/src/app_components/SourceCode.vue +++ b/src/app_components/SourceCode.vue @@ -79,7 +79,6 @@ onMounted(async () => { const parser = new DOMParser(); const doc = parser.parseFromString(preCode, 'text/html'); const children = doc.body.children; - for (let i = 0, len = children.length; i < len; i++) { if (children[i] != null) { fragment.appendChild(children[i]); diff --git a/src/components/VirtualList.vue b/src/components/VirtualList.vue index ee86a071..1e33ff0e 100644 --- a/src/components/VirtualList.vue +++ b/src/components/VirtualList.vue @@ -1,24 +1,24 @@