更x

docs/uni-app-x/component/common.md

@@ -4,11 +4,19 @@
 
 ## 组件公共属性
 
-<!-- 自动生成 -->
+- id
+- ref
+- style
+- class
 
 ## 组件公共事件
 
-<!-- 自动生成 -->
+- @touchstart
+- @touchmove
+- @touchend
+- @tap
+- @click
+- @longpress
 
 ### 冒泡事件系统
 

docs/uni-app-x/component/image.md

@@ -4,7 +4,31 @@
 
 <!-- UTSCOMJSON.image.attrubute -->
 
+## 图标格式
+- [x] bmp
+- [x] gif
+- [x] ico
+- [x] jpg
+- [x] png
+- [x] webp
+- [x] heic（Android10+支持）
+
+如需其他图片格式，可搜索插件市场或自行开发uts组件插件。
+
+## src路径支持说明
+
+- 支持本地路径相对路径：比如根目录/、上级目录../、子目录subdir/。但不支持页面当前目录。
+- 支持本地绝对路径
+- 支持网络路径
+- 本地路径的大小写不敏感
+
+## 网络图缓存说明
+
+image组件内部使用facebook的fresco库，自带缓存策略。
+
 <!-- UTSCOMJSON.image.compatibility -->
 
 <!-- UTSCOMJSON.image.reference -->
 
+## bug&tips
+- 目前src不支持页面当前目录的图片。
\ No newline at end of file

docs/uni-app-x/component/list-view.md

@@ -2,6 +2,14 @@
 
 <!-- UTSCOMJSON.list-view.description -->
 
+在App中，基于recycle-view的list，才能实现长列表的资源自动回收，以保障列表加载很多项目时，屏幕外的资源被有效回收。list-view就是基于recycle-view的list组件。
+
+每个list由1个父组件list-view及若干子组件list-item构成。
+
+在list-item上使用v-for指令循环list-item，自动会回收屏幕外的列表项资源。
+
+list-view和scroll-view都是滚动组件，list适用于长列表场景，其他场景适用于scroll-view。
+
 <!-- UTSCOMJSON.list-view.attrubute -->
 
 <!-- UTSCOMJSON.list-view.compatibility -->
@@ -19,3 +27,13 @@
 
 <!-- UTSCOMJSON.list-item.reference -->
 
+## 示例代码
+
+- 联网联表：[https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/list-news/list.uvue](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/list-news/list.uvue)
+- 可左右滑动的多个列表：[https://gitcode.net/dcloud/hello-uni-app-x/-/tree/master/pages/template/long-list](https://gitcode.net/dcloud/hello-uni-app-x/-/tree/master/pages/template/long-list)
+
+## Bug&Tips
+
+- list触底偶尔不触发
+- 暂不支持reverse，目前还不能开发im那样的倒叙列表
+- 暂不支持waterfall多列瀑布流
\ No newline at end of file

docs/uni-app-x/component/picker-view.md

@@ -19,3 +19,5 @@
 
 <!-- UTSCOMJSON.picker-view-column.reference -->
 
+## tips
+- picker里如放置较长内容，应该使用list-view而不是scroll-view。
\ No newline at end of file

docs/uni-app-x/component/rich-text.md

@@ -8,3 +8,6 @@
 
 <!-- UTSCOMJSON.rich-text.reference -->
 
+## bug&tips
+
+- 目前只支持HTMLString，暂不支持node。HTMLString支持常用但不是全部web样式，具体清单后续给出。
\ No newline at end of file

docs/uni-app-x/component/scroll-view.md

@@ -8,3 +8,5 @@
 
 <!-- UTSCOMJSON.scroll-view.reference -->
 
+## bug@tips
+- 嵌套滚动暂未发布
\ No newline at end of file

docs/uni-app-x/component/text.md

@@ -2,9 +2,19 @@
 
 <!-- UTSCOMJSON.text.description -->
 
+在app-uvue和app-nvue中，文本只能写在text中，而不能写在view的text区域。
+
+虽然app-uvue中写在view的text区域的文字，也会被编译器自动包裹一层text组件，看起来也可以使用。但这样会造成无法修改该text文字的样式，详见uvue的[样式不继承](../uni-app-x/css/readme.md#stylenoextends)章节
+
 <!-- UTSCOMJSON.text.attrubute -->
 
 <!-- UTSCOMJSON.text.compatibility -->
 
+## 子组件
+
+text组件在web浏览器渲染（含浏览器、小程序webview渲染模式、app-vue）和uvue中，可以并只能嵌套text组件。
+
+在nvue中，text组件不能嵌套。
+
 <!-- UTSCOMJSON.text.reference -->
 

docs/uni-app-x/component/video.md

@@ -8,3 +8,7 @@
 
 <!-- UTSCOMJSON.video.reference -->
 
+
+## bug@tips
+- 暂不支持全屏后放置子组件
+- video组件的API目前只支持ref方式，详见[示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/video/video.uvue)
\ No newline at end of file

docs/uni-app-x/component/view.md

@@ -8,3 +8,4 @@
 
 <!-- UTSCOMJSON.view.reference -->
 
+view是Drawable的组件，也就是可以在view上调用绘制API自绘内容。它类似canvas，但不需要单独的canvas组件，在view上就可以直接draw。[详见](../dom/drawablecontext.md)
\ No newline at end of file