Update navigator.md

e1538c3c · DCloud_Heavensoft · 5c4ff6c7 · e1538c3c
隐藏空白更改
内联并排

Showing with 90 addition and 89 deletion

docs/component/navigator.md docs/component/navigator.md +90 -89

未找到文件。
--- a/docs/component/navigator.md
+++ b/docs/component/navigator.md
-#### navigator
-
-页面跳转。
-
-该组件类似HTML中的`<a>`组件，但只能跳转本地页面。目标页面必须在pages.json中注册。
-
-该组件的功能有API方式，另见：[https://uniapp.dcloud.io/api/router?id=navigateto](https://uniapp.dcloud.io/api/router?id=navigateto)
-
-**属性说明**
-
-|属性名|类型|默认值|说明|平台差异说明|
-|:-|:-|:-|:-|:-|
-|url|String||应用内的跳转链接，值为相对路径或绝对路径，如："../first/first"，"/pages/first/first"，注意不能加 ``.vue`` 后缀||
-|open-type|String|navigate|跳转方式||
-|delta|Number||当 open-type 为 'navigateBack' 时有效，表示回退的层数||
-|animation-type|String|pop-in/out|当 open-type 为 navigate、navigateBack 时有效，窗口的显示/关闭动画效果，详见：[窗口动画](/api/router?id=animation)|App|
-|animation-duration|Number|300|当 open-type 为 navigate、navigateBack 时有效，窗口显示/关闭动画的持续时间。|App|
-|hover-class|String|navigator-hover|指定点击时的样式类，当hover-class="none"时，没有点击态效果||
-|hover-stop-propagation|Boolean|false|指定是否阻止本节点的祖先节点出现点击态|微信小程序|
-|hover-start-time|Number|50|按住后多久出现点击态，单位毫秒||
-|hover-stay-time|Number|600|手指松开后点击态保留时间，单位毫秒|&nbsp;|
-|target|String|self|在哪个小程序目标上发生跳转，默认当前小程序，值域self/miniProgram|微信2.0.7+、百度2.5.2+、QQ|
-
-**open-type 有效值**
-
-|值|说明|平台差异说明|
-|:-|:-|:-|
-|navigate|对应 uni.navigateTo 的功能||
-|redirect|对应 uni.redirectTo 的功能||
-|switchTab|对应 uni.switchTab 的功能||
-|reLaunch|对应 uni.reLaunch 的功能|抖音小程序与飞书小程序不支持|
-|navigateBack|对应 uni.navigateBack 的功能||
-|exit|退出小程序，target="miniProgram"时生效|微信2.1.0+、百度2.5.2+、QQ1.4.7+|
-
-
-**注意**
- 跳转tabbar页面，必须设置open-type="switchTab"
- navigator-hover 默认为 {background-color: rgba(0, 0, 0, 0.1); opacity: 0.7;}, ``<navigator>`` 的子节点背景色应为透明色。
- navigator-`open-type`属性 如果使用对应的值，则对应值的功能会高于对应跳转路径。
- app-nvue 平台只有纯nvue项目（render为native）才支持 `<navigator>`。非render为native的情况下，nvue暂不支持navigator组件，请使用API跳转。
- app下退出应用，Android平台可以使用[plus.runtime.quit](https://www.html5plus.org/doc/zh_cn/runtime.html#plus.runtime.quit)。iOS没有退出应用的概念。
- [uLink组件](https://ext.dcloud.net.cn/plugin?id=1182)是navigator组件的增强版，样式上自带下划线，功能上支持打开在线网页、其他App的schema、mailto发邮件、tel打电话。
- Vue3 项目因 SSR 需要，H5 端会在外层嵌套 a 标签
-
-**示例** [查看示例](https://hellouniapp.dcloud.net.cn/pages/component/navigator/navigator)
- 
-::: preview https://hellouniapp.dcloud.net.cn/pages/component/navigator/navigator
-
-```html
-<template>
-	<view>
-		<view class="page-body">
-			<view class="btn-area">
-				<navigator url="navigate/navigate?title=navigate" hover-class="navigator-hover">
-					<button type="default">跳转到新页面</button>
-				</navigator>
-				<navigator url="redirect/redirect?title=redirect" open-type="redirect" hover-class="other-navigator-hover">
-					<button type="default">在当前页打开</button>
-				</navigator>
-				<navigator url="/pages/tabBar/extUI/extUI" open-type="switchTab" hover-class="other-navigator-hover">
-					<button type="default">跳转tab页面</button>
-				</navigator>
-			</view>
-		</view>
-	</view>
-</template>
-<script>
-// navigate.vue页面接受参数
-export default {
-	onLoad: function (option) { //option为object类型，会序列化上个页面传递的参数
-		console.log(option.id); //打印出上个页面传递的参数。
-		console.log(option.name); //打印出上个页面传递的参数。
-	}
-}
-</script>
-```
-:::
-
-url有长度限制，太长的字符串会传递失败，可使用[窗体通信](https://uniapp.dcloud.io/tutorial/page.html#emit)、[全局变量](https://ask.dcloud.net.cn/article/35021)，或`encodeURIComponent`等多种方式解决，如下为`encodeURIComponent`示例。
-```html
-<navigator :url="'/pages/navigate/navigate?item='+ encodeURIComponent(JSON.stringify(item))"></navigator>
-```
-```javascript
-// navigate.vue页面接受参数
-onLoad: function (option) {
-	const item = JSON.parse(decodeURIComponent(option.item));
-}
-```
-
+#### navigator
+
+页面跳转。
+
+该组件类似HTML中的`<a>`组件，但只能跳转本地页面。目标页面必须在pages.json中注册。
+
+除了组件方式，API方式也可以实现页面跳转，另见：[https://uniapp.dcloud.io/api/router?id=navigateto](https://uniapp.dcloud.io/api/router?id=navigateto)
+
+**属性说明**
+
+|属性名|类型|默认值|说明|平台差异说明|
+|:-|:-|:-|:-|:-|
+|url|String||应用内的跳转链接，值为相对路径或绝对路径，如："../first/first"，"/pages/first/first"，注意不能加 ``.vue`` 后缀||
+|open-type|String|navigate|跳转方式||
+|delta|Number||当 open-type 为 'navigateBack' 时有效，表示回退的层数||
+|animation-type|String|pop-in/out|当 open-type 为 navigate、navigateBack 时有效，窗口的显示/关闭动画效果，详见：[窗口动画](/api/router?id=animation)|App|
+|animation-duration|Number|300|当 open-type 为 navigate、navigateBack 时有效，窗口显示/关闭动画的持续时间。|App|
+|hover-class|String|navigator-hover|指定点击时的样式类，当hover-class="none"时，没有点击态效果||
+|hover-stop-propagation|Boolean|false|指定是否阻止本节点的祖先节点出现点击态|微信小程序|
+|hover-start-time|Number|50|按住后多久出现点击态，单位毫秒||
+|hover-stay-time|Number|600|手指松开后点击态保留时间，单位毫秒|&nbsp;|
+|target|String|self|在哪个小程序目标上发生跳转，默认当前小程序，值域self/miniProgram|微信2.0.7+、百度2.5.2+、QQ|
+
+**open-type 有效值**
+
+|值|说明|平台差异说明|
+|:-|:-|:-|
+|navigate|对应 uni.navigateTo 的功能||
+|redirect|对应 uni.redirectTo 的功能||
+|switchTab|对应 uni.switchTab 的功能||
+|reLaunch|对应 uni.reLaunch 的功能|抖音小程序与飞书小程序不支持|
+|navigateBack|对应 uni.navigateBack 的功能||
+|exit|退出小程序，target="miniProgram"时生效|微信2.1.0+、百度2.5.2+、QQ1.4.7+|
+
+这些细节可在[页面路由API文档](https://uniapp.dcloud.io/api/router?id=navigateto)查阅。
+
+**注意**
+- 跳转tabbar页面，必须设置open-type="switchTab"
+- navigator-hover 默认为 {background-color: rgba(0, 0, 0, 0.1); opacity: 0.7;}, ``<navigator>`` 的子节点背景色应为透明色。
+- navigator-`open-type`属性 如果使用对应的值，则对应值的功能会高于对应跳转路径。
+- app-nvue 平台只有纯nvue项目（render为native）才支持 `<navigator>`。非render为native的情况下，nvue暂不支持navigator组件，请使用API跳转。
+- app下退出应用，Android平台可以使用[plus.runtime.quit](https://www.html5plus.org/doc/zh_cn/runtime.html#plus.runtime.quit)。iOS没有退出应用的概念。
+- [uLink组件](https://ext.dcloud.net.cn/plugin?id=1182)是navigator组件的增强版，样式上自带下划线，功能上支持打开在线网页、其他App的schema、mailto发邮件、tel打电话。
+- Vue3 项目因 SSR 需要，H5 端会在外层嵌套 a 标签
+
+**示例** [查看示例](https://hellouniapp.dcloud.net.cn/pages/component/navigator/navigator)
+ 
+::: preview https://hellouniapp.dcloud.net.cn/pages/component/navigator/navigator
+
+```html
+<template>
+	<view>
+		<view class="page-body">
+			<view class="btn-area">
+				<navigator url="navigate/navigate?title=navigate" hover-class="navigator-hover">
+					<button type="default">跳转到新页面</button>
+				</navigator>
+				<navigator url="redirect/redirect?title=redirect" open-type="redirect" hover-class="other-navigator-hover">
+					<button type="default">在当前页打开</button>
+				</navigator>
+				<navigator url="/pages/tabBar/extUI/extUI" open-type="switchTab" hover-class="other-navigator-hover">
+					<button type="default">跳转tab页面</button>
+				</navigator>
+			</view>
+		</view>
+	</view>
+</template>
+<script>
+// navigate.vue页面接受参数
+export default {
+	onLoad: function (option) { //option为object类型，会序列化上个页面传递的参数
+		console.log(option.id); //打印出上个页面传递的参数。
+		console.log(option.name); //打印出上个页面传递的参数。
+	}
+}
+</script>
+```
+:::
+
+url有长度限制，太长的字符串会传递失败，可使用[窗体通信](https://uniapp.dcloud.io/tutorial/page.html#emit)、[全局变量](https://ask.dcloud.net.cn/article/35021)，或`encodeURIComponent`等多种方式解决，如下为`encodeURIComponent`示例。
+```html
+<navigator :url="'/pages/navigate/navigate?item='+ encodeURIComponent(JSON.stringify(item))"></navigator>
+```
+```javascript
+// navigate.vue页面接受参数
+onLoad: function (option) {
+	const item = JSON.parse(decodeURIComponent(option.item));
+}
+```
+