Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
ff13d9a4
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3598
Star
108
Fork
921
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
120
列表
看板
标记
里程碑
合并请求
109
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
120
Issue
120
列表
看板
标记
里程碑
合并请求
109
合并请求
109
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
ff13d9a4
编写于
10月 17, 2023
作者:
D
DCloud_LXH
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
chore: uts com json
上级
ef86aceb
变更
5
隐藏空白更改
内联
并排
Showing
5 changed file
with
347 addition
and
20 deletion
+347
-20
docs/.vuepress/utils/utsComJson.json
docs/.vuepress/utils/utsComJson.json
+272
-1
docs/uni-app-x/_sidebar.md
docs/uni-app-x/_sidebar.md
+1
-0
docs/uni-app-x/component/list-view.md
docs/uni-app-x/component/list-view.md
+35
-19
docs/uni-app-x/component/unicloud-db.md
docs/uni-app-x/component/unicloud-db.md
+16
-0
docs/uni-app-x/dom/element.md
docs/uni-app-x/dom/element.md
+23
-0
未找到文件。
docs/.vuepress/utils/utsComJson.json
浏览文件 @
ff13d9a4
因为 它太大了无法显示 source diff 。你可以改为
查看blob
。
docs/uni-app-x/_sidebar.md
浏览文件 @
ff13d9a4
...
...
@@ -44,6 +44,7 @@
*
[
video
](
component/video.md
)
*
[
web-view
](
component/web-view.md
)
*
[
animation-view
](
component/animation-view.md
)
*
[
unicloud-db
](
component/unicloud-db.md
)
*
API
*
[
概述
](
api/README.md
)
*
全局
...
...
docs/uni-app-x/component/list-view.md
浏览文件 @
ff13d9a4
...
...
@@ -25,38 +25,54 @@ list-view和scroll-view都是滚动组件,list适用于长列表场景,其
<!-- UTSCOMJSON.list-view.reference -->
## sticky-header
<!-- UTSCOMJSON.sticky-header.description -->
<!-- UTSCOMJSON.sticky-header.attrubute -->
<!-- UTSCOMJSON.sticky-header.event -->
<!-- UTSCOMJSON.sticky-header.example -->
<!-- UTSCOMJSON.sticky-header.compatibility -->
<!-- UTSCOMJSON.sticky-header.children -->
<!-- UTSCOMJSON.sticky-header.reference -->
## list-item
<!-- UTSCOMJSON.list-item.description -->
<!-- UTSCOMJSON.list-item.attrubute -->
### list-item复用机制
+
type属性定义list-item组件类型。不赋值type属性默认值为0,每一个type类型都会有对应的list-item组件缓存池。
+
list-view组件加载list-item组件时,会优先查询对应type缓存池是否存在可复用的list-item组件。有则复用没有则创建新的list-item组件。
+
list-item组件被滑动出屏幕则会优先添加到对应类型的list-item缓存池,每个类型缓存最大5个(不同平台缓存最大值不固定),如果缓存池已满则进行组件销毁!
<!-- UTSCOMJSON.list-item.attrubute -->
### list-item复用机制
+
type属性定义list-item组件类型。不赋值type属性默认值为0,每一个type类型都会有对应的list-item组件缓存池。
+
list-view组件加载list-item组件时,会优先查询对应type缓存池是否存在可复用的list-item组件。有则复用没有则创建新的list-item组件。
+
list-item组件被滑动出屏幕则会优先添加到对应类型的list-item缓存池,每个类型缓存最大5个(不同平台缓存最大值不固定),如果缓存池已满则进行组件销毁!
+
部分list-item组件存在子元素个数差异或排版差异时。请尽可能的配置不同的type,这样可以规避获取相同type类型的list-item组件后。由于子元素差异导致list-item无法正常复用问题。具体可参考示例:
```
html
```html
<template>
<view class="content">
<list-view
ref=
"listView"
class=
"list"
:scroll-y=
"true"
>
<list-item
v-for=
"(item,index) in list"
:key=
"index"
class=
"content-item1"
type=
1
>
<text
class=
"text"
>
title-{{item}}
</text>
<text
class=
"text"
>
content-{{item}}
</text>
</list-item>
<list-item
v-for=
"(item,index) in list"
:key=
"index"
class=
"content-item2"
type=
2
>
<image
class=
"image"
src =
"/static/test-image/logo.png"
></image>
<list-view ref="listView" class="list" :scroll-y="true">
<list-item v-for="(item,index) in list" :key="index" class="content-item1" type=1>
<text class="text">title-{{item}}</text>
<text class="text">content-{{item}}</text>
</list-item>
<list-item v-for="(item,index) in list" :key="index" class="content-item2" type=2>
<image class="image" src ="/static/test-image/logo.png"></image>
</list-item>
<list-item type=3>
<text class="loading">{{text}}</text>
</list-item>
</list-view>
</view>
</template>
```
示例中有三种类型的list-item组件。如果都不赋值type,list-item组件滑动出屏幕后都归类到type=0的缓存池。当触发list-item组件重新加载时,获取type=0的缓存池的组件,获取到的list-item组件可能是两个text子组件也可能是一个image子组件或一个text子组件,底层复用判断时则认为该情况异常不复用,重新创建新的list-item组件!复用失败未能优化性能。正确的方式则是不同的类型设置不同的type。加载时则会获取对应type类型缓存池中的list-item组件实现复用。
</template>
```
示例中有三种类型的list-item组件。如果都不赋值type,list-item组件滑动出屏幕后都归类到type=0的缓存池。当触发list-item组件重新加载时,获取type=0的缓存池的组件,获取到的list-item组件可能是两个text子组件也可能是一个image子组件或一个text子组件,底层复用判断时则认为该情况异常不复用,重新创建新的list-item组件!复用失败未能优化性能。正确的方式则是不同的类型设置不同的type。加载时则会获取对应type类型缓存池中的list-item组件实现复用。
<!-- UTSCOMJSON.list-item.event -->
...
...
docs/uni-app-x/component/unicloud-db.md
0 → 100644
浏览文件 @
ff13d9a4
## unicloud-db
<!-- UTSCOMJSON.unicloud-db.description -->
<!-- UTSCOMJSON.unicloud-db.attrubute -->
<!-- UTSCOMJSON.unicloud-db.event -->
<!-- UTSCOMJSON.unicloud-db.example -->
<!-- UTSCOMJSON.unicloud-db.compatibility -->
<!-- UTSCOMJSON.unicloud-db.children -->
<!-- UTSCOMJSON.unicloud-db.reference -->
docs/uni-app-x/dom/element.md
浏览文件 @
ff13d9a4
...
...
@@ -201,3 +201,26 @@
<!-- CUSTOMTYPEJSON.Element.methods.scrollBy.tutorial -->
<!-- CUSTOMTYPEJSON.Element.methods.focus.name -->
<!-- CUSTOMTYPEJSON.Element.methods.focus.description -->
<!-- CUSTOMTYPEJSON.Element.methods.focus.param -->
<!-- CUSTOMTYPEJSON.Element.methods.focus.returnValue -->
<!-- CUSTOMTYPEJSON.Element.methods.focus.compatibility -->
<!-- CUSTOMTYPEJSON.Element.methods.focus.tutorial -->
<!-- CUSTOMTYPEJSON.Element.methods.blur.name -->
<!-- CUSTOMTYPEJSON.Element.methods.blur.description -->
<!-- CUSTOMTYPEJSON.Element.methods.blur.param -->
<!-- CUSTOMTYPEJSON.Element.methods.blur.returnValue -->
<!-- CUSTOMTYPEJSON.Element.methods.blur.compatibility -->
<!-- CUSTOMTYPEJSON.Element.methods.blur.tutorial -->
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录