From 72e4d2b6e6963b02faed0edeeb2ba1c8fd0e8d08 Mon Sep 17 00:00:00 2001 From: DCloud_LXH <283700113@qq.com> Date: Wed, 13 Dec 2023 16:11:47 +0800 Subject: [PATCH] =?UTF-8?q?chore:=20=E5=A4=84=E7=90=86=E9=93=BE=E6=8E=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/api/page-scroll-to.md | 8 ++++---- docs/collocation/manifest.md | 2 +- docs/component/README.md | 2 +- docs/component/text.md | 2 +- docs/component/unsupport.md | 2 +- docs/css/font-family.md | 4 ++-- docs/css/font-size.md | 12 ++++++------ docs/css/line-height.md | 14 +++++++------- docs/css/readme.md | 2 +- docs/dom/README.md | 26 +++++++++++++------------- docs/tutorial/codegap.md | 12 ++++++------ docs/tutorial/stickynestlist.md | 2 +- docs/vue/README.md | 6 +++--- 13 files changed, 47 insertions(+), 47 deletions(-) diff --git a/docs/api/page-scroll-to.md b/docs/api/page-scroll-to.md index 3342b516..bfa74009 100644 --- a/docs/api/page-scroll-to.md +++ b/docs/api/page-scroll-to.md @@ -31,10 +31,10 @@ selector类似于 CSS 的选择器，但仅支持下列语法。 ## uni-app x 注意事项 -1. app-uvue支持的选择器较少，不支持ID选择器，[详见](uni-app-x/css/README.md#选择器) -2. app-uvue的页面滚动，是由页面最外层的scroll-view模拟的，如果页面最外层不是scroll-view，无法使用本api。[详见](uni-app-x/css/README.md#pagescroll) -3. app-uvue的scroll-view滚动时，如需动画，则需要在scroll-view的属性中配置 `scroll-with-animation="true"`，[详见](component/scroll-view.md) -4. scroll-view的滚动，设置其scrollTop即可。[详见](component/scroll-view.md) +1. app-uvue支持的选择器较少，不支持ID选择器，[详见](../css/README.md#选择器) +2. app-uvue的页面滚动，是由页面最外层的scroll-view模拟的，如果页面最外层不是scroll-view，无法使用本api。[详见](../css/README.md#pagescroll) +3. app-uvue的scroll-view滚动时，如需动画，则需要在scroll-view的属性中配置 `scroll-with-animation="true"`，[详见](../component/scroll-view.md) +4. scroll-view的滚动，设置其scrollTop即可。[详见](../component/scroll-view.md) **示例** diff --git a/docs/collocation/manifest.md b/docs/collocation/manifest.md index f1aebe28..dbc652fc 100644 --- a/docs/collocation/manifest.md +++ b/docs/collocation/manifest.md @@ -37,7 +37,7 @@ uni-app x 的权限配置，移入了[AndroidManifest.xml](https://uniapp.dcloud 使用[uni内置模块](#utsmodules)时，云端打包会自动添加模块需要的Android权限，不需要在[AndroidManifest.xml](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android.md#permissions)中配置。 -HBuilderX3.97+版本标准基座已经包含了所有Android权限，在 uvue 页面中直接通过 uts 调用需要权限的 Android 系统 API 时，使用标准基座真机运行可直接通过[UTSAndroid.requestSystemPermission](../uts/utsandroid.md#requestSystemPermission)申请；使用自定义基座则需要在项目的[AndroidManifest.xml](../tutorial/app-nativeresource-android.md#permissions)中配置要使用的权限，重新提交云端打包。 +HBuilderX3.97+版本标准基座已经包含了所有Android权限，在 uvue 页面中直接通过 uts 调用需要权限的 Android 系统 API 时，使用标准基座真机运行可直接通过[UTSAndroid.requestSystemPermission](../uts/utsandroid.md#requestSystemPermission)申请；使用自定义基座则需要在项目的[AndroidManifest.xml](https://uniapp.dcloud.io/tutorial/app-nativeresource-android.md#permissions)中配置要使用的权限，重新提交云端打包。 #### DISTRIBUTE配置 @app-distribute diff --git a/docs/component/README.md b/docs/component/README.md index 18b62c06..68a83fc9 100644 --- a/docs/component/README.md +++ b/docs/component/README.md @@ -100,7 +100,7 @@ export default { ## 自定义事件 -- [v-model](tutorial/vue3-components.html#v-model-modifiers) 暂不支持 `capitalize` 修饰符。 +- [v-model](https://uniapp.dcloud.io/tutorial/vue3-components.html#v-model-modifiers) 暂不支持 `capitalize` 修饰符。 ## 计算属性和侦听器 diff --git a/docs/component/text.md b/docs/component/text.md index 6c168caf..30489ae4 100644 --- a/docs/component/text.md +++ b/docs/component/text.md @@ -4,7 +4,7 @@ 在app-uvue和app-nvue中，文本只能写在text中，而不能写在view的text区域。文本样式的控制也应该在text组件上写style，而不是在view的样式里写。 -虽然app-uvue中写在view的text区域的文字，也会被编译器自动包裹一层text组件，看起来也可以使用。但这样会造成无法修改该text文字的样式，详见uvue的[样式不继承](uni-app-x/css/README.md#stylenoextends)章节。 +虽然app-uvue中写在view的text区域的文字，也会被编译器自动包裹一层text组件，看起来也可以使用。但这样会造成无法修改该text文字的样式，详见uvue的[样式不继承](../css/README.md#stylenoextends)章节。 diff --git a/docs/component/unsupport.md b/docs/component/unsupport.md index dfb45fef..94633976 100644 --- a/docs/component/unsupport.md +++ b/docs/component/unsupport.md @@ -7,7 +7,7 @@ uni-app x在App端还有一批组件未与uni-app js引擎版拉齐。有的在 - picker：可改用[picker-view](picker-view.md) - canvas：目前没有完整的canvas组件，但 * 每个view，都提供了[draw API](../dom/drawablecontext.md)，可以高性能的画各种形状、写字。 - * 关于截图，无需像webview那样通过canvas中转，view直接提供截图方案，[takesnapshot](dom/element.md#takesnapshot)。 + * 关于截图，无需像webview那样通过canvas中转，view直接提供截图方案，[takesnapshot](../dom/element.md#takesnapshot)。 * 使用web-view中的canvas也是一种方案，uvue页面里的web-view组件可以和uvue页面里的uts代码双向通信。比如生成二维码，可以由web-view组件来渲染，复用web生态的库。 * 当然二维码在插件市场也有现成的[插件](https://ext.dcloud.net.cn/search?q=%E4%BA%8C%E7%BB%B4%E7%A0%81&uni-appx=1) * 后期uvue中也会补充正式的canvas组件 diff --git a/docs/css/font-family.md b/docs/css/font-family.md index d604f945..c69d032c 100644 --- a/docs/css/font-family.md +++ b/docs/css/font-family.md @@ -13,12 +13,12 @@ -#### App平台差异 +#### App平台差异 - font-family 样式不支持继承 #### 字体图标 支持ttf和otf字体图标。 - 可在css里直接加载，[参考](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/CSS/text/font-family.uvue) -- 也可以使用API [uni.loadFontface](../api/loadFontFace.md) +- 也可以使用API [uni.loadFontface](../api/load-font-face.md) \ No newline at end of file diff --git a/docs/css/font-size.md b/docs/css/font-size.md index 3b6b31fe..50930d07 100644 --- a/docs/css/font-size.md +++ b/docs/css/font-size.md @@ -13,11 +13,11 @@ -#### App平台差异 -App平台仅支持以像素值（px）设置字体大小，默认值为16px。 -font-size 样式不支持继承，仅对[text](uni-app-x/component/text.md)组件生效。 -> 不支持百分比的值 -> 不支持基于用户默认字体大小的绝对大小关键字，如small、medium、large等 -> 不支持em、rem、ex等单位 +#### App平台差异 +App平台仅支持以像素值（px）设置字体大小，默认值为16px。 +font-size 样式不支持继承，仅对[text](../component/text.md)组件生效。 +> 不支持百分比的值 +> 不支持基于用户默认字体大小的绝对大小关键字，如small、medium、large等 +> 不支持em、rem、ex等单位 \ No newline at end of file diff --git a/docs/css/line-height.md b/docs/css/line-height.md index 1ff54163..44198f80 100644 --- a/docs/css/line-height.md +++ b/docs/css/line-height.md @@ -13,15 +13,15 @@ -#### App平台 -App平台仅支持以像素值（px）和相对长度单位（em）相对当前元素字体字体单位（em），em单位表示数字值乘以该元素的字体大小，无单位值时使用em，默认值为1.2em。 -line-height 样式不支持继承，仅对 [text](uni-app-x/component/text.md) 组件生效。 +#### App平台 +App平台仅支持以像素值（px）和相对长度单位（em）相对当前元素字体字体单位（em），em单位表示数字值乘以该元素的字体大小，无单位值时使用em，默认值为1.2em。 +line-height 样式不支持继承，仅对 [text](../component/text.md) 组件生效。 建议设置大于15%字号大小的值，以避免出现渲染异常。 -> 不支持百分比的值 -> 不支持设置关键字 normal 值 -> 不支持ch、rem、ex等单位 +> 不支持百分比的值 +> 不支持设置关键字 normal 值 +> 不支持ch、rem、ex等单位 -#### Web规范 +#### Web规范 line-height 样式支持继承，默认值为normal（大约为1.2em，取决于 font-family 样式） \ No newline at end of file diff --git a/docs/css/readme.md b/docs/css/readme.md index a07f1964..48123661 100644 --- a/docs/css/readme.md +++ b/docs/css/readme.md @@ -311,7 +311,7 @@ uni-app x的css的样式不继承规则，虽然与web有差异，其实只是 目前仅支持url()、rgb()、rgba()。 -暂不支持css变量val()。--status-bar-height、--window-top、--window-bottom，也暂时无法使用，有相关需求可使用[uni.getWindowInfo()](../api/getwindowinfo.md)方式获取。 +暂不支持css变量val()。--status-bar-height、--window-top、--window-bottom，也暂时无法使用，有相关需求可使用[uni.getWindowInfo()](../api/get-window-info.md)方式获取。 ## At-rules |类别 |支持情况 |备注 | diff --git a/docs/dom/README.md b/docs/dom/README.md index 1282ff81..d0d398a2 100644 --- a/docs/dom/README.md +++ b/docs/dom/README.md @@ -1,4 +1,4 @@ -# UVUE DOM +# UVUE DOM App-uvue的每个页面，在内存中都有一个 DOM（文档对象模型）。它和浏览器的 [DOM规范](https://www.w3.org/DOM/?spm=a2c7j.-zh-docs-api-weex-variable.0.0.2a5537c6FrgbYp) 类似。 @@ -19,9 +19,9 @@ DOM 是页面元素内容的结构数据。DOM 模型用一个逻辑树来表示 1. 跟手动效 响应触屏事件更新组件的位置，要想不掉帧，需要保证16毫秒绘制一帧。 - + uvue的data更新，有一套diff机制，每次触发data更新，会多几毫秒的耗时。 - + 此时推荐通过 DOM API 跳过 vue 框架直接操作组件的样式。 2. Draw API @@ -31,13 +31,13 @@ DOM 是页面元素内容的结构数据。DOM 模型用一个逻辑树来表示 在[性能](../performance.md)章节，对这2个场景有详细的阐述。 -## DOM元素对象@getDomNode +## DOM元素对象@getDomNode 在操作DOM元素对象前，需要先获取 `Element` 对象，可通过 `uni.getElementById` 或 `this.$refs` 获取。 -### 通过uni.getElementById获取DOM元素 +### 通过uni.getElementById获取DOM元素 -app-uvue 页面中可以为页面元素节点设置 id 属性，然后通过 [uni.getElementById](../api/get-element-by-id.md#getelementbyid) 获取 DOM 元素对象。 +app-uvue 页面中可以为页面元素节点设置 id 属性，然后通过 [uni.getElementById](../api/get-element.md#getelementbyid) 获取 DOM 元素对象。 首先需要为组件设置 id 属性值： ```vue @@ -57,14 +57,14 @@ app-uvue 页面中可以为页面元素节点设置 id 属性，然后通过 [un } }, onReady() { - // 获取组件对象并保存在 this.myView 中 + // 获取组件对象并保存在 this.myView 中 this.myView = uni.getElementById('myView'); }, } ``` ### 通过this.$refs获取DOM元素 -app-uvue页面中可以通过 vue 框架中的组件实例对象 [this.$refs](https://uniapp.dcloud.net.cn/tutorial/vue3-api.html#%E5%AE%9E%E4%BE%8B-property) 获取 DOM 元素对象。 +app-uvue页面中可以通过 vue 框架中的组件实例对象 [this.$refs](https://uniapp.dcloud.net.cn/tutorial/vue3-api.html#%E5%AE%9E%E4%BE%8B-property) 获取 DOM 元素对象。 首先需要为组件设置 ref 属性值，它类似于id： ```vue @@ -84,7 +84,7 @@ app-uvue页面中可以通过 vue 框架中的组件实例对象 [this.$refs](ht } }, onReady() { - // 获取组件对象并保存在 this.myView 中 + // 获取组件对象并保存在 this.myView 中 this.myView = this.$refs['myView'] as Element; //需要使用 as 转换 }, } @@ -98,9 +98,9 @@ app-uvue页面中可以通过 vue 框架中的组件实例对象 [this.$refs](ht this.myView?.style?.setProperty('background-color', 'red'); ``` -### 示例 -以下是完整的操作示例： -```vue +### 示例 +以下是完整的操作示例： +```vue