.. _functional-page-navigator:

:wx_comp:`functional-page-navigator`
=========================================

.. versionadded:: 2.1.0 低版本需做 :ref:`compatibility` 。

仅在插件中有效，用于跳转到插件功能页。

+-------------+--------------+---------+------+------------------------------------------------------------+----------+
|    属性     |     类型     | 默认值  | 必填 |                            说明                            | 最低版本 |
+=============+==============+=========+======+============================================================+==========+
| version     | string       | release | 否   | 跳转到的小程序版本，线上版本必须设置为 release             | 2.1.0    |
+-------------+--------------+---------+------+------------------------------------------------------------+----------+
| name        | string       |         | 否   | 要跳转到的功能页                                           | 2.1.0    |
+-------------+--------------+---------+------+------------------------------------------------------------+----------+
| args        | object       |         | 否   | 功能页参数，参数格式与具体功能页相关                       | 2.1.0    |
+-------------+--------------+---------+------+------------------------------------------------------------+----------+
| bindsuccess | eventhandler |         | 否   | 功能页返回，且操作成功时触发， detail 格式与具体功能页相关 | 2.1.0    |
+-------------+--------------+---------+------+------------------------------------------------------------+----------+
| bindfail    | eventhandler |         | 否   | 功能页返回，且操作失败时触发， detail 格式与具体功能页相关 | 2.1.0    |
+-------------+--------------+---------+------+------------------------------------------------------------+----------+

version 的合法值

+---------+--------+
|   值    |  说明  |
+=========+========+
| develop | 开发版 |
+---------+--------+
| trial   | 体验版 |
+---------+--------+
| release | 正式版 |
+---------+--------+


name 的合法值

+---------------------+----------------+----------+
|         值          |      说明      | 最低版本 |
+=====================+================+==========+
| loginAndGetUserInfo | 用户信息功能页 | 2.1.0    |
+---------------------+----------------+----------+
| requestPayment      | 支付功能页     | 2.1.0    |
+---------------------+----------------+----------+

.. tip:: 功能页是插件所有者小程序中的一个特殊页面，开发者不能自定义这个页面的外观。

.. tip:: 在功能页展示时，一些与界面展示相关的接口将被禁用（接口调用返回 fail ）。

.. tip:: 这个组件本身可以在开发者工具中使用，但功能页的跳转目前不支持在开发者工具中调试，请在真机上测试。

示例代码

.. code:: html

  <!-- sample.wxml -->
  <functional-page-navigator
    name="loginAndGetUserInfo"
    bind:success="loginSuccess"
  >
    <button>登录到插件</button>
  </functional-page-navigator>

.. code:: js

  // redirect.js navigator.js
  Component({
    methods: {
      loginSuccess(e) {
        console.log(e.detail.code) // wx.login 的 code
        console.log(e.detail.userInfo) // wx.getUserInfo 的 userInfo
      }
    }
  })