diff --git a/docs/api/page-scroll-to.md b/docs/api/page-scroll-to.md index 3342b5163bd549898fcc3d0f5912771175b96f72..bfa7400998e4eb8d24da33e0b03cdc2e8a05290a 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 f1aebe28624c6447406ba473a2854550205a87dd..dbc652fcd88c1c36189faf31e753a1d3369d534b 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 18b62c06fa9df687ff4edd1affa1b1fc956f5430..68a83fc955a3bc70741f5570e0f732534775f0d7 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 6c168caf79ee4d1925fe331cd12a2267b7197195..30489ae43e2ac1ecbfc17efe691dee59c93c23b6 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 dfb45fef4dd86bd050deebae6a8dc25b0bd5a47b..94633976a2cfe8406b3d05ea3e6bc2fb2484ceb3 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 d604f94502f3a303a53bae138d16c33b391b11cb..c69d032cb39176c3ed0d6dfc3c6df8c4d6febc57 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 3b6b31fe067e570ffa8162f7fd677d912bc3433c..50930d0793e160633bb2cb501921a388408721c6 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 1ff5416356b08ae80fa7db5b3637f5f4052347fb..44198f8011dab10a5c7bf770bf13cdc49f06801f 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 a07f19643dbb05a7217f7caf2cc3166b1c0a04f4..481236610b768984d22351e35decda1ccf61135c 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 1282ff818d4a8ca238d34e82fad986ae0047613c..d0d398a23aa6e5f383cc732ffc56f68c3cceb191 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