x

docs/uni-app-x/_sidebar.md

@@ -7,8 +7,8 @@
   * [view](component/view.md)
   * [scroll-view](component/scroll-view.md)
   * [list-view](component/list-view.md)
-  * [navigator](component/navigator.md)
   * [swiper](component/swiper.md)
+  * [navigator](component/navigator.md)
   * [text](component/text.md)
   * [rich-text](component/rich-text.md)
   * [image](component/image.md)
@@ -22,8 +22,8 @@
   * [slider](component/slider.md)
   * [switch](component/switch.md)
   * [video](component/video.md)
-  * [animation-view](component/animation-view.md)
   * [web-view](component/web-view.md)
+  * [animation-view](component/animation-view.md)
 * [API](api.md)
 * CSS
   * [CSS概述](css/README.md)

docs/uni-app-x/codegap.md

@@ -231,10 +231,13 @@ uni.navigateTo({
 - 函数声明方式不支持[作为值传递](../uts/function.md#作为值传递)
 - 函数表达式方式不支持[默认参数](../uts/function.md#默认参数)
 
-## css使用注意
-
-[详见](css/readme.md)
-
 ## 组件监听页面生命周期
 
 目前暂不支持在组件内监听页面生命周期，待后续支持组合式 API 后，可通过组合式 API 实现。
+
+## 与uni-app js引擎版的其他差异
+- uni-app x 新增了onLastPageBackPress和onExit等应用级生命周期，Android退出应用逻辑写在app.uvue里，新建项目的模板自动包含相关代码。如需修改退出逻辑，请直接修改相关代码。
+
+## css使用注意
+
+[详见](css/readme.md)

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

@@ -56,5 +56,6 @@ button 组件没有 url 属性，如果要跳转页面，可以在@click中编
 	}
 </script>
 ```
+
 ## tips
-- button 不支持 `\n` 方式换行。
+- button 的text区域文字，app-uvue下不支持 `\n` 方式换行，会直接显示 `\n` 字符。微信小程序下 `\n` 会变成一个空格

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

@@ -4,7 +4,7 @@
 
 <!-- UTSCOMJSON.image.attrubute -->
 
-## 图标格式
+## 图片格式
 - [x] bmp
 - [x] gif
 - [x] ico
@@ -17,18 +17,20 @@
 
 ## src路径支持说明
 
-- 支持本地路径相对路径：比如根目录/、上级目录../、子目录subdir/。但不支持页面当前目录。
-- 支持本地绝对路径
+- 本地路径/static方式
+	由于uni-app编译时，只把/static目录下的静态资源copy到app中，所以src均需指向/static目录下。
+	其他目录的图片由于不会被打包进去，所以无法访问。本地路径的大小写不敏感。
+- 本地绝对路径file:///方式
+	形如`file:///storage/emulated/0/Android/data/io.dcloud.uniappx/apps/__UNI__4517034/www/static/test-image/logo.png`。
+	访问本应用内的资源时无需使用本方式，推荐使用/static方式。上述地址受包名、appid影响。
+	file:///方式一般用于download等公共目录。使用前需确保拥有相关权限。
 - 支持网络路径
-- 本地路径的大小写不敏感
-
-## 网络图缓存说明
-
-image组件内部使用facebook的fresco库，自带缓存策略。
+	支持http、https。
+	image组件内部使用facebook的fresco库，自带缓存策略，也会自动清理缓存。
 
 <!-- UTSCOMJSON.image.compatibility -->
 
-<!-- UTSCOMJSON.image.reference -->
+## tips
+在error事件里监听报错，并重新设置image组件的src，可实现自定义错误图。[详见示例代码](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/image/image-path.uvue)
 
-## bug&tips
-- 目前src不支持页面当前目录的图片。
\ No newline at end of file
+<!-- UTSCOMJSON.image.reference -->

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

@@ -6,5 +6,12 @@
 
 <!-- UTSCOMJSON.slider.compatibility -->
 
+## tips
+show-value属性设为true后，会在横条右侧显示一个数字。
+
+但注意app-uvue中，value显示区的默认宽度是3位数字。超出宽度后，后面的数字无法显示。即最大999。（其他平台不限制）
+
+如您需要4位或更多数字，请将show-value设为false或不设，自行写一个text组件，绑定value的数值来显示。
+
 <!-- UTSCOMJSON.slider.reference -->
 

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

@@ -2,7 +2,7 @@
 
 <!-- UTSCOMJSON.text.description -->
 
-在app-uvue和app-nvue中，文本只能写在text中，而不能写在view的text区域。
+在app-uvue和app-nvue中，文本只能写在text中，而不能写在view的text区域。文本样式的控制也应该在text组件上写style，而不是在view的样式里写。
 
 虽然app-uvue中写在view的text区域的文字，也会被编译器自动包裹一层text组件，看起来也可以使用。但这样会造成无法修改该text文字的样式，详见uvue的[样式不继承](../uni-app-x/css/readme.md#stylenoextends)章节
 
@@ -14,9 +14,11 @@
 
 text组件在web浏览器渲染（含浏览器、小程序webview渲染模式、app-vue）和uvue中，可以并只能嵌套text组件。
 
-在nvue中，text组件不能嵌套。
+但注意，text组件嵌套后子组件也不继承父组件样式，这样使用会在编译到浏览器平台时产生差异。所以尽量避免使用text嵌套。
+
+app-nvue中，text组件不能嵌套。
 
 <!-- UTSCOMJSON.text.reference -->
 
 ## tips
-- 选择复制，仅支持全选复制，暂未支持自由调整光标选择文字
\ No newline at end of file
+- app-uvue的选择复制，仅支持全部文字复制，暂未支持自由调整光标选择文字
\ No newline at end of file

docs/uni-app-x/css/readme.md

@@ -78,7 +78,7 @@ web开发中，页面是必然可以滚动的。当然也可以给某些div设
 但在uvue中，废弃了这个策略。因为开发者的页面情况较复杂，而且vue3支持多个一级组件，之前的策略可能会多给页面套一层不必要的scroll-view。
 在追求高性能时，多一层scroll-view是不能忍受的。
 
-uvue的策略是，在新建页面时，提供一个选项，让开发者选择是否需要页面级滚动。如需要则自动在页面代码里template的根节点加一个scroll-view。
+uvue的策略是，在新建页面时，提供一个选项，让开发者选择是否需要页面级滚动。如需要则自动在页面代码里template的根节点加一个全屏的scroll-view。
 如果开发者不需要，随时可以自己修改代码。
 
 ```html
@@ -97,7 +97,7 @@ uvue的策略是，在新建页面时，提供一个选项，让开发者选择
 
 这样在web浏览器里就无需多套一层scroll-view，自然的使用浏览器的页面滚动就好了。
 
-尤其在Android webview中，scroll-view其实是可区域滚动的div，滚动区变长后，性能远不如页面的自然滚动。
+尤其在Android webview中，scroll-view其实是可区域滚动的div，滚动区变长后，性能远不如页面滚动。
 
 当然如果你只做app，可以不写条件编译。
 
@@ -136,10 +136,16 @@ uvue的策略是，在新建页面时，提供一个选项，让开发者选择
 
 	* 如果不是scroll-view，全部失效。
 
-如果根节点使用了list-view，它也有自己的滚动相关的API和监听事件。详见[list-view]()的文档。
+如果根节点使用了list-view，它也有自己的滚动相关的API和监听事件。详见[list-view](../component/list-view.md)的文档。
 
 ## 样式不继承@stylenoextends
 
+web的样式继承，主要是文字样式继承。web的css属性众多，规范比较松散，随便一个div都可以写文字相关的样式。这样其实不严谨、性能也不好。
+
+在原生等严谨的应用开发方案中，均是组件搭配组件的属性，容器组件和文本组件分离，属性各自隔离，不可能在容器组件里写文本组件的样式。
+
+在uni-app x中也是，文本必须使用`<text>`组件，`<view>`组件就是容器组件，它的style里不应用使用与文本修饰相关的样式，比如文字颜色、大小等。
+
 如下代码，在web浏览器渲染时，父view的style会影响子text，所以123是红色。
 
 但是在uvue中，样式不继承，123的颜色仍然是默认颜色黑色。
@@ -187,9 +193,13 @@ uvue中文字都是要使用text组件的。
 </template>
 ```
 
+uni-app x的css的样式不继承规则，虽然与web有差异，其实只是更严谨。
+
+开发者遵循仅在text组件下写文字有关的样式，就可以编译到全端而保持界面正常。
+
 ## 层级
 
-目前仅对同层的兄弟节点之间支持z-index来调节层级。不支持脱离dom树任意调节层级；暂不支持通过js修改z-index。
+仅对同层的兄弟节点之间支持z-index来调节层级。不支持脱离dom树任意调节层级。
 
 ## css模块
 

docs/uni-app-x/css/z-index.md

@@ -9,4 +9,8 @@
 
 <!-- CSSJSON.z-index.compatibility -->
 
+## tips
+
+仅对同层的兄弟节点之间支持z-index来调节层级。不支持脱离dom树任意调节层级。
+
 <!-- CSSJSON.z-index.reference -->
\ No newline at end of file