洪平水 發表於 2021-3-17 17:13:00

uni-app 两种方式导航跳转和传参

<h2 id="声明式跳转">声明式跳转</h2>
<h3 id="navigator">navigator</h3>
<p>页面跳转。</p>
<p>该组件类似HTML中的<code>&lt;a&gt;</code>组件，但只能跳转本地页面。目标页面必须在<code>pages.json</code>中注册。</p>
<p>该组件的功能有API方式，另见：https://uniapp.dcloud.io/api/router?id=navigateto</p>
<h4 id="属性说明"><strong>属性说明</strong></h4>
<table>
<thead>
<tr>
<th style="text-align: left">属性名</th>
<th style="text-align: left">类型</th>
<th style="text-align: left">默认值</th>
<th style="text-align: left">说明</th>
<th style="text-align: left">平台差异说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left">url</td>
<td style="text-align: left">String</td>
<td style="text-align: left"></td>
<td style="text-align: left">应用内的跳转链接，值为相对路径或绝对路径，如："../first/first"，"/pages/first/first"，注意不能加 <code>.vue</code> 后缀</td>
<td style="text-align: left"></td>
</tr>
<tr>
<td style="text-align: left">open-type</td>
<td style="text-align: left">String</td>
<td style="text-align: left">navigate</td>
<td style="text-align: left">跳转方式</td>
<td style="text-align: left"></td>
</tr>
<tr>
<td style="text-align: left">delta</td>
<td style="text-align: left">Number</td>
<td style="text-align: left"></td>
<td style="text-align: left">当 open-type 为 'navigateBack' 时有效，表示回退的层数</td>
<td style="text-align: left"></td>
</tr>
<tr>
<td style="text-align: left">animation-type</td>
<td style="text-align: left">String</td>
<td style="text-align: left">pop-in/out</td>
<td style="text-align: left">当 open-type 为 navigate、navigateBack 时有效，窗口的显示/关闭动画效果，详见：窗口动画</td>
<td style="text-align: left">App</td>
</tr>
<tr>
<td style="text-align: left">animation-duration</td>
<td style="text-align: left">Number</td>
<td style="text-align: left">300</td>
<td style="text-align: left">当 open-type 为 navigate、navigateBack 时有效，窗口显示/关闭动画的持续时间。</td>
<td style="text-align: left">App</td>
</tr>
<tr>
<td style="text-align: left">hover-class</td>
<td style="text-align: left">String</td>
<td style="text-align: left">navigator-hover</td>
<td style="text-align: left">指定点击时的样式类，当hover-class="none"时，没有点击态效果</td>
<td style="text-align: left"></td>
</tr>
<tr>
<td style="text-align: left">hover-stop-propagation</td>
<td style="text-align: left">Boolean</td>
<td style="text-align: left">false</td>
<td style="text-align: left">指定是否阻止本节点的祖先节点出现点击态</td>
<td style="text-align: left">微信小程序</td>
</tr>
<tr>
<td style="text-align: left">hover-start-time</td>
<td style="text-align: left">Number</td>
<td style="text-align: left">50</td>
<td style="text-align: left">按住后多久出现点击态，单位毫秒</td>
<td style="text-align: left"></td>
</tr>
<tr>
<td style="text-align: left">hover-stay-time</td>
<td style="text-align: left">Number</td>
<td style="text-align: left">600</td>
<td style="text-align: left">手指松开后点击态保留时间，单位毫秒</td>
<td style="text-align: left"></td>
</tr>
<tr>
<td style="text-align: left">target</td>
<td style="text-align: left">String</td>
<td style="text-align: left">self</td>
<td style="text-align: left">在哪个小程序目标上发生跳转，默认当前小程序，值域self/miniProgram</td>
<td style="text-align: left">微信2.0.7+、百度2.5.2+、QQ</td>
</tr>
</tbody>
</table>
<h4 id="open-type-有效值"><strong>open-type 有效值</strong></h4>
<table>
<thead>
<tr>
<th style="text-align: left">值</th>
<th style="text-align: left">说明</th>
<th style="text-align: left">平台差异说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left">navigate</td>
<td style="text-align: left">对应 uni.navigateTo 的功能</td>
<td style="text-align: left"></td>
</tr>
<tr>
<td style="text-align: left">redirect</td>
<td style="text-align: left">对应 uni.redirectTo 的功能</td>
<td style="text-align: left"></td>
</tr>
<tr>
<td style="text-align: left">switchTab</td>
<td style="text-align: left">对应 uni.switchTab 的功能</td>
<td style="text-align: left"></td>
</tr>
<tr>
<td style="text-align: left">reLaunch</td>
<td style="text-align: left">对应 uni.reLaunch 的功能</td>
<td style="text-align: left">字节跳动小程序不支持</td>
</tr>
<tr>
<td style="text-align: left">navigateBack</td>
<td style="text-align: left">对应 uni.navigateBack 的功能</td>
<td style="text-align: left"></td>
</tr>
<tr>
<td style="text-align: left">exit</td>
<td style="text-align: left">退出小程序，target="miniProgram"时生效</td>
<td style="text-align: left">微信2.1.0+、百度2.5.2+、QQ1.4.7+</td>
</tr>
</tbody>
</table>
<h4 id="注意"><strong>注意</strong></h4>
<ul>
<li>跳转tabbar页面，必须设置open-type="switchTab"</li>
<li>navigator-hover 默认为 {background-color: rgba(0, 0, 0, 0.1); opacity: 0.7;}, <code>&lt;navigator&gt;</code> 的子节点背景色应为透明色。</li>
<li>app-nvue 平台只有纯nvue项目（render为native）才支持 <code>&lt;navigator&gt;</code>。非render为native的情况下，nvue暂不支持navigator组件，请使用API跳转。</li>
<li>app下退出应用，Android平台可以使用plus.runtime.quit。iOS没有退出应用的概念。</li>
<li>uLink组件是navigator组件的增强版，样式上自带下划线，功能上支持打开在线网页、其他App的schema、mailto发邮件、tel打电话。</li>
</ul>
<h3 id="示例">示例</h3>
<pre><code>&lt;template&gt;
        &lt;view&gt;
                &lt;view&gt;导航跳转的学习&lt;/view&gt;
                &lt;!-- 普通跳转，左上角有返回 --&gt;
                &lt;navigator url="/pages/detail/detail"&gt;跳转至详情页&lt;/navigator&gt;
                &lt;!-- tabbar 页面跳转 --&gt;
                &lt;navigator url="/pages/message/message" open-type="switchTab"&gt;跳转至信息页&lt;/navigator&gt;
                &lt;!-- 重定向跳转关闭当前页面再跳转，不能返回 --&gt;
                &lt;navigator url="/pages/detail/detail" open-type="redirect"&gt;跳转至详情页&lt;/navigator&gt;

        &lt;/view&gt;
&lt;/template&gt;

&lt;script&gt;
&lt;/script&gt;

&lt;style&gt;
&lt;/style&gt;

</code></pre>
<p><img src="https://img2020.cnblogs.com/blog/1652001/202103/1652001-20210317171316839-1344948083.png" alt="image-20210317165745427" loading="lazy"></p>
<p><img src="https://img2020.cnblogs.com/blog/1652001/202103/1652001-20210317171316850-1171059036.png" alt="image-20210317165805110" loading="lazy"></p>
<p><img src="https://img2020.cnblogs.com/blog/1652001/202103/1652001-20210317171316846-1526603214.png" alt="image-20210317165817018" loading="lazy"></p>
<p><img src="https://img2020.cnblogs.com/blog/1652001/202103/1652001-20210317171316838-932654553.png" alt="image-20210317165830720" loading="lazy"></p>
<h2 id="编程式跳转">编程式跳转</h2>
<h3 id="uninavigatetoobject">uni.navigateTo(OBJECT)</h3>
<p>保留当前页面，跳转到应用内的某个页面，使用<code>uni.navigateBack</code>可以返回到原页面。</p>
<p><strong>OBJECT参数说明</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left">参数</th>
<th style="text-align: left">类型</th>
<th style="text-align: left">必填</th>
<th style="text-align: left">默认值</th>
<th style="text-align: left">说明</th>
<th style="text-align: left">平台差异说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left">url</td>
<td style="text-align: left">String</td>
<td style="text-align: left">是</td>
<td style="text-align: left"></td>
<td style="text-align: left">需要跳转的应用内非 tabBar 的页面的路径 , 路径后可以带参数。参数与路径之间使用?分隔，参数键与参数值用=相连，不同参数用&amp;分隔；如 'path?key=value&amp;key2=value2'，path为下一个页面的路径，下一个页面的onLoad函数可得到传递的参数</td>
<td style="text-align: left"></td>
</tr>
<tr>
<td style="text-align: left">animationType</td>
<td style="text-align: left">String</td>
<td style="text-align: left">否</td>
<td style="text-align: left">pop-in</td>
<td style="text-align: left">窗口显示的动画效果，详见：窗口动画</td>
<td style="text-align: left">App</td>
</tr>
<tr>
<td style="text-align: left">animationDuration</td>
<td style="text-align: left">Number</td>
<td style="text-align: left">否</td>
<td style="text-align: left">300</td>
<td style="text-align: left">窗口动画持续时间，单位为 ms</td>
<td style="text-align: left">App</td>
</tr>
<tr>
<td style="text-align: left">events</td>
<td style="text-align: left">Object</td>
<td style="text-align: left">否</td>
<td style="text-align: left"></td>
<td style="text-align: left">页面间通信接口，用于监听被打开页面发送到当前页面的数据。2.8.9+ 开始支持。</td>
<td style="text-align: left"></td>
</tr>
<tr>
<td style="text-align: left">success</td>
<td style="text-align: left">Function</td>
<td style="text-align: left">否</td>
<td style="text-align: left"></td>
<td style="text-align: left">接口调用成功的回调函数</td>
<td style="text-align: left"></td>
</tr>
<tr>
<td style="text-align: left">fail</td>
<td style="text-align: left">Function</td>
<td style="text-align: left">否</td>
<td style="text-align: left"></td>
<td style="text-align: left">接口调用失败的回调函数</td>
<td style="text-align: left"></td>
</tr>
<tr>
<td style="text-align: left">complete</td>
<td style="text-align: left">Function</td>
<td style="text-align: left">否</td>
<td style="text-align: left"></td>
<td style="text-align: left">接口调用结束的回调函数（调用成功、失败都会执行）</td>
<td style="text-align: left"></td>
</tr>
</tbody>
</table>
<p><strong>object.success 回调函数</strong></p>
<p><strong>参数</strong></p>
<p><strong>Object res</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left">属性</th>
<th style="text-align: left">类型</th>
<th style="text-align: left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left">eventChannel</td>
<td style="text-align: left">EventChannel</td>
<td style="text-align: left">和被打开页面进行通信</td>
</tr>
</tbody>
</table>
<p><strong>示例</strong></p>
<pre><code class="language-javascript">//在起始页面跳转到test.vue页面并传递参数
uni.navigateTo({
    url: 'test?id=1&amp;name=uniapp'
});
// 在test.vue页面接受参数
export default {
    onLoad: function (option) { //option为object类型，会序列化上个页面传递的参数
      console.log(option.id); //打印出上个页面传递的参数。
      console.log(option.name); //打印出上个页面传递的参数。
    }
}
// 2.8.9+ 支持
uni.navigateTo({
url: 'pages/test?id=1',
events: {
    // 为指定事件添加一个监听器，获取被打开页面传送到当前页面的数据
    acceptDataFromOpenedPage: function(data) {
      console.log(data)
    },
    someEvent: function(data) {
      console.log(data)
    }
    ...
},
success: function(res) {
    // 通过eventChannel向被打开页面传送数据
    res.eventChannel.emit('acceptDataFromOpenerPage', { data: 'test' })
}
})

// uni.navigateTo 目标页面 pages/test.vue
onLoad: function(option) {
console.log(option.query)
const eventChannel = this.getOpenerEventChannel()
eventChannel.emit('acceptDataFromOpenedPage', {data: 'test'});
eventChannel.emit('someEvent', {data: 'test'});
// 监听acceptDataFromOpenerPage事件，获取上一页面通过eventChannel传送到当前页面的数据
eventChannel.on('acceptDataFromOpenerPage', function(data) {
    console.log(data)
})
}
</code></pre>
<p>url有长度限制，太长的字符串会传递失败，可改用窗体通信、全局变量，另外参数中出现空格等特殊字符时需要对参数进行编码，如下为使用<code>encodeURIComponent</code>对参数进行编码的示例。</p>
<pre><code class="language-html">&lt;navigator :url="'/pages/test/test?item='+ encodeURIComponent(JSON.stringify(item))"&gt;&lt;/navigator&gt;
// 在test.vue页面接受参数
onLoad: function (option) {
    const item = JSON.parse(decodeURIComponent(option.item));
}
</code></pre>
<p><strong>注意：</strong></p>
<ul>
<li>页面跳转路径有层级限制，不能无限制跳转新页面</li>
<li>跳转到 tabBar 页面只能使用 switchTab 跳转</li>
<li>路由API的目标页面必须是在pages.json里注册的vue页面。如果想打开web url，在App平台可以使用 plus.runtime.openURL或web-view组件；H5平台使用 window.open；小程序平台使用web-view组件（url需在小程序的联网白名单中）。在hello uni-app中有个组件ulink.vue已对多端进行封装，可参考。</li>
</ul>
<h3 id="uniredirecttoobject">uni.redirectTo(OBJECT)</h3>
<p>关闭当前页面，跳转到应用内的某个页面。</p>
<p><strong>OBJECT参数说明</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left">参数</th>
<th style="text-align: left">类型</th>
<th style="text-align: left">必填</th>
<th style="text-align: left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left">url</td>
<td style="text-align: left">String</td>
<td style="text-align: left">是</td>
<td style="text-align: left">需要跳转的应用内非 tabBar 的页面的路径，路径后可以带参数。参数与路径之间使用?分隔，参数键与参数值用=相连，不同参数用&amp;分隔；如 'path?key=value&amp;key2=value2'</td>
</tr>
<tr>
<td style="text-align: left">success</td>
<td style="text-align: left">Function</td>
<td style="text-align: left">否</td>
<td style="text-align: left">接口调用成功的回调函数</td>
</tr>
<tr>
<td style="text-align: left">fail</td>
<td style="text-align: left">Function</td>
<td style="text-align: left">否</td>
<td style="text-align: left">接口调用失败的回调函数</td>
</tr>
<tr>
<td style="text-align: left">complete</td>
<td style="text-align: left">Function</td>
<td style="text-align: left">否</td>
<td style="text-align: left">接口调用结束的回调函数（调用成功、失败都会执行）</td>
</tr>
</tbody>
</table>
<p><strong>示例</strong></p>
<pre><code class="language-javascript">uni.redirectTo({
    url: 'test?id=1'
});
</code></pre>
<p><strong>注意：</strong></p>
<ul>
<li>跳转到 tabBar 页面只能使用 switchTab 跳转</li>
</ul>
<h3 id="unirelaunchobject">uni.reLaunch(OBJECT)</h3>
<p>关闭所有页面，打开到应用内的某个页面。</p>
<p><strong>注意：</strong> 如果调用了 uni.preloadPage(OBJECT) 不会关闭，仅触发生命周期 <code>onHide</code></p>
<p><strong>OBJECT参数说明</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left">参数</th>
<th style="text-align: left">类型</th>
<th style="text-align: left">必填</th>
<th style="text-align: left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left">url</td>
<td style="text-align: left">String</td>
<td style="text-align: left">是</td>
<td style="text-align: left">需要跳转的应用内页面路径 , 路径后可以带参数。参数与路径之间使用?分隔，参数键与参数值用=相连，不同参数用&amp;分隔；如 'path?key=value&amp;key2=value2'，如果跳转的页面路径是 tabBar 页面则不能带参数</td>
</tr>
<tr>
<td style="text-align: left">success</td>
<td style="text-align: left">Function</td>
<td style="text-align: left">否</td>
<td style="text-align: left">接口调用成功的回调函数</td>
</tr>
<tr>
<td style="text-align: left">fail</td>
<td style="text-align: left">Function</td>
<td style="text-align: left">否</td>
<td style="text-align: left">接口调用失败的回调函数</td>
</tr>
<tr>
<td style="text-align: left">complete</td>
<td style="text-align: left">Function</td>
<td style="text-align: left">否</td>
<td style="text-align: left">接口调用结束的回调函数（调用成功、失败都会执行）</td>
</tr>
</tbody>
</table>
<p><strong>示例</strong></p>
<pre><code class="language-javascript">uni.reLaunch({
    url: 'test?id=1'
});
export default {
    onLoad: function (option) {
      console.log(option.id);
    }
}
</code></pre>
<p>Tips：</p>
<ul>
<li>H5端调用<code>uni.reLaunch</code>之后之前页面栈会销毁，但是无法清空浏览器之前的历史记录，此时<code>navigateBack</code>不能返回，如果存在历史记录的话点击浏览器的返回按钮或者调用<code>history.back()</code>仍然可以导航到浏览器的其他历史记录。</li>
</ul>
<h3 id="uniswitchtabobject">uni.switchTab(OBJECT)</h3>
<p>跳转到 tabBar 页面，并关闭其他所有非 tabBar 页面。</p>
<p><strong>注意：</strong> 如果调用了 uni.preloadPage(OBJECT) 不会关闭，仅触发生命周期 <code>onHide</code></p>
<p><strong>OBJECT参数说明</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left">参数</th>
<th style="text-align: left">类型</th>
<th style="text-align: left">必填</th>
<th style="text-align: left">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left">url</td>
<td style="text-align: left">String</td>
<td style="text-align: left">是</td>
<td style="text-align: left">需要跳转的 tabBar 页面的路径（需在 pages.json 的 tabBar 字段定义的页面），路径后不能带参数</td>
</tr>
<tr>
<td style="text-align: left">success</td>
<td style="text-align: left">Function</td>
<td style="text-align: left">否</td>
<td style="text-align: left">接口调用成功的回调函数</td>
</tr>
<tr>
<td style="text-align: left">fail</td>
<td style="text-align: left">Function</td>
<td style="text-align: left">否</td>
<td style="text-align: left">接口调用失败的回调函数</td>
</tr>
<tr>
<td style="text-align: left">complete</td>
<td style="text-align: left">Function</td>
<td style="text-align: left">否</td>
<td style="text-align: left">接口调用结束的回调函数（调用成功、失败都会执行）</td>
</tr>
</tbody>
</table>
<p><strong>示例</strong></p>
<p>pages.json</p>
<pre><code class="language-javascript">{
"tabBar": {
    "list": [{
      "pagePath": "pages/index/index",
      "text": "首页"
    },{
      "pagePath": "pages/other/other",
      "text": "其他"
    }]
}
}
</code></pre>
<p>other.vue</p>
<pre><code class="language-javascript">uni.switchTab({
    url: '/pages/index/index'
});
</code></pre>
<h3 id="uninavigatebackobject">uni.navigateBack(OBJECT)</h3>
<p>关闭当前页面，返回上一页面或多级页面。可通过 <code>getCurrentPages()</code> 获取当前的页面栈，决定需要返回几层。</p>
<p><strong>OBJECT参数说明</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left">参数</th>
<th style="text-align: left">类型</th>
<th style="text-align: left">必填</th>
<th style="text-align: left">默认值</th>
<th style="text-align: left">说明</th>
<th style="text-align: left">平台差异说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left">delta</td>
<td style="text-align: left">Number</td>
<td style="text-align: left">否</td>
<td style="text-align: left">1</td>
<td style="text-align: left">返回的页面数，如果 delta 大于现有页面数，则返回到首页。</td>
<td style="text-align: left"></td>
</tr>
<tr>
<td style="text-align: left">animationType</td>
<td style="text-align: left">String</td>
<td style="text-align: left">否</td>
<td style="text-align: left">pop-out</td>
<td style="text-align: left">窗口关闭的动画效果，详见：窗口动画</td>
<td style="text-align: left">App</td>
</tr>
<tr>
<td style="text-align: left">animationDuration</td>
<td style="text-align: left">Number</td>
<td style="text-align: left">否</td>
<td style="text-align: left">300</td>
<td style="text-align: left">窗口关闭动画的持续时间，单位为 ms</td>
<td style="text-align: left">App</td>
</tr>
</tbody>
</table>
<p><strong>示例</strong></p>
<pre><code class="language-javascript">// 注意：调用 navigateTo 跳转时，调用该方法的页面会被加入堆栈，而 redirectTo 方法则不会。见下方示例代码

// 此处是A页面
uni.navigateTo({
    url: 'B?id=1'
});

// 此处是B页面
uni.navigateTo({
    url: 'C?id=1'
});

// 在C页面内 navigateBack，将返回A页面
uni.navigateBack({
    delta: 2
});
</code></pre>
<h3 id="示例-1">示例</h3>
<pre><code>&lt;template&gt;
        &lt;view&gt;
                &lt;view&gt;导航跳转的学习&lt;/view&gt;
                &lt;button @click="goDetail"&gt;跳转之详情页&lt;/button&gt;
                &lt;button @click="goMessage"&gt;跳转至信息页&lt;/button&gt;
                &lt;button type="primary" @click="redirectDetail()"&gt;跳转到详情页并关闭当前页面&lt;/button&gt;
        &lt;/view&gt;
&lt;/template&gt;

&lt;script&gt;
        export default {
                methods: {
                        goDetail() {
                                //普通跳转，左上角有返回
                                uni.navigateTo({
                                        url: '/pages/detail/detail?id=80&amp;age=19'
                                })
                        },
                        goMessage() {
                                //tabbar 页面跳转
                                uni.switchTab({
                                        url: '/pages/message/message'
                                })
                        },
                        redirectDetail() {
                                //重定向跳转关闭当前页面再跳转，不能返回
                                uni.redirectTo({
                                        url: '/pages/detail/detail'
                                });
                        }
                }
        }
&lt;/script&gt;

&lt;style&gt;
&lt;/style&gt;
</code></pre>
<p><img src="https://img2020.cnblogs.com/blog/1652001/202103/1652001-20210317171316848-2025609555.png" alt="image-20210317170703635" loading="lazy"></p>
<h2 id="两种方式的传参">两种方式的传参</h2>
<pre><code>&lt;template&gt;
        &lt;view&gt;
                &lt;view&gt;导航跳转的学习&lt;/view&gt;
                &lt;!-- 普通跳转，左上角有返回 --&gt;
                &lt;navigator url="/pages/detail/detail?id=18&amp;name='声明式跳转"&gt;跳转至详情页&lt;/navigator&gt;
               

                &lt;button @click="goDetail"&gt;跳转之详情页&lt;/button&gt;
               
        &lt;/view&gt;
&lt;/template&gt;

&lt;script&gt;
        export default {
                methods: {
                        goDetail() {
                                //普通跳转，左上角有返回
                                uni.navigateTo({
                                        url: "/pages/detail/detail?id=20&amp;name='编程式跳转'"
                                })
                        }
                }
        }
&lt;/script&gt;

&lt;style&gt;
&lt;/style&gt;
</code></pre>
<p>页面接收</p>
<pre><code>&lt;template&gt;
        &lt;view&gt;这是详情页&lt;/view&gt;
&lt;/template&gt;

&lt;script&gt;
        export default{
                onLoad(options){
                        console.log(options);
                }
        }
&lt;/script&gt;

&lt;style&gt;
&lt;/style&gt;
</code></pre>
<p><img src="https://img2020.cnblogs.com/blog/1652001/202103/1652001-20210317171316874-1493342199.png" alt="image-20210317171257400" loading="lazy"></p><br><br>
来源：https://www.cnblogs.com/makalochen/p/14550534.html
頁: [1]
查看完整版本: uni-app 两种方式导航跳转和传参