Navigator 导航

API 调用

QN.navigator.push(options)

QN.navigator.go(options)

打开/跳转页面

API 调用入参

API 响应结果

调用示例

QN.navigator.push({
    url: 'http://www.taobao.com',
    title: '新开页面标题~~',
    query: { x: 1, y: 2 },
    settings: {
        animate: true,
        request: true,
    }
    success(result) {
        console.log(result);
    },
    error(error) {
        console.log(error);
    }
}).then(result => {
    console.log(result);
}, error => {
    console.log(error);
});

QN.navigator.pop(options)

QN.navigator.back(options)

关闭页面/后退

API 调用入参

API 响应结果

调用示例

QN.navigator.pop({
    query: {
        data: {}
    },
    settings: {
        animate: true,
    }
    success(result) {
        console.log(result);
    },
    error(error) {
        console.log(error);
    }
}).then(result => {
    console.log(result);
}, error => {
    console.log(error);
});

QN.navigator.reload(options);

刷新当前页面

API 调用入参

API 响应结果

调用示例

QN.navigator.reload();

QN.navigator.reload({
    success(result) {
        console.log(result);
    },
    error(error) {
        console.log(error);
    }
}).then(result => {
    console.log(result);
}, error => {
    console.log(error);
});

QN.navigator.close(options);

关闭整个插件应用

API 调用入参

API 响应结果

调用示例

QN.navigator.close();

QN.navigator.close({
    success(result) {
        console.log(result);
    },
    error(error) {
        console.log(error);
    }
}).then(result => {
    console.log(result);
}, error => {
    console.log(error);
});

QN.navigator.setTitle(options)

设置标题

API 调用入参

API 响应结果

调用示例

QN.navigator.setTitle({
    query: {
        title: '我是标题'
    },
    success(result) {
        console.log(result);
    },
    error(error) {
        console.log(error);
    }
}).then(result => {
    console.log(result);
}, error => {
    console.log(error);
});

QN.navigator.showTitle(options)

显示标题

API 调用入参

API 响应结果

调用示例

QN.navigator.showTitle({
    success(result) {
        console.log(result);
    },
    error(error) {
        console.log(error);
    }
}).then(result => {
    console.log(result);
}, error => {
    console.log(error);
});

QN.navigator.hideTitle(options)

隐藏标题

API 调用入参

API 响应结果

调用示例

QN.navigator.hideTitle({
    success(result) {
        console.log(result);
    },
    error(error) {
        console.log(error);
    }
}).then(result => {
    console.log(result);
}, error => {
    console.log(error);
});

QN.navigator.addButton(options)

添加导航栏自定义按钮

API 调用入参

iconImg 示例：

API 响应结果

调用示例

QN.navigator.addButton({
    query: {
        iconName: 'share',
        text: '分享',
        tapEvent: 'Page.share', // 或 `share`
    },
    success(result) {
        console.log(result);
    },
    error(error) {
        console.log(error);
    }
}).then(result => {
    console.log(result);
}, error => {
    console.log(error);
});

QN.navigator.removeButton(options)

移除导航栏自定义按钮

API 调用入参

API 响应结果

调用示例

QN.navigator.removeButton({
    query: {
        tapEvent: 'Page.share', // 或 `share`
    },
    success(result) {
        console.log(result);
    },
    error(error) {
        console.log(error);
    }
}).then(result => {
    console.log(result);
}, error => {
    console.log(error);
});

QN.navigator.clearButtons(options)

清除导航栏自定义按钮

API 调用入参

API 响应结果

调用示例

QN.navigator.clearButtons();

QN.navigator.clearButtons({
    success(result) {
        console.log(result);
    },
    error(error) {
        console.log(error);
    }
}).then(result => {
    console.log(result);
}, error => {
    console.log(error);
});

QN.navigator.addMenuItem(options)

添加导航栏菜单列表中自定义菜单项

API 调用入参

iconImg 示例：

API 响应结果

调用示例

QN.navigator.addMenuItem({
    query: {
        iconName: 'share',
        text: '分享',
        tapEvent: 'Page.share', // 或 `share`
    },
    success(result) {
        console.log(result);
    },
    error(error) {
        console.log(error);
    }
}).then(result => {
    console.log(result);
}, error => {
    console.log(error);
});

QN.navigator.removeMenuItem(options)

移除导航栏菜单列表中自定义菜单项

API 调用入参

API 响应结果

调用示例

QN.navigator.removeMenuItem({
    query: {
        tapEvent: 'Page.share', // 或 `share`
    },
    success(result) {
        console.log(result);
    },
    error(error) {
        console.log(error);
    }
}).then(result => {
    console.log(result);
}, error => {
    console.log(error);
});

QN.navigator.clearMenuItems(options)

清除导航栏菜单列表中自定义菜单项

API 调用入参

API 响应结果

调用示例

QN.navigator.clearMenuItems();

QN.navigator.clearMenuItems({
    success(result) {
        console.log(result);
    },
    error(error) {
        console.log(error);
    }
}).then(result => {
    console.log(result);
}, error => {
    console.log(error);
});

QN.navigator.setSwipeBack(options)

启用/禁用iOS下页面的左滑返回，页面加载时默认为启用。

API 调用入参

API 响应结果

调用示例

// 禁止左滑返回
QN.navigator.setSwipeBack({
    query: {enable: false},
    success(result) {
        console.log(result);
    },
    error(error) {
        console.log(error);
    }
}).then(result => {
    console.log(result);
}, error => {
    console.log(error);
});

导航栏预置事件

当用户操作时，预置事件由千牛客户端触发，你可以监听这些事件并拦截这些按钮的默认行为：

QN.on('Page.back', function(data) {
    // 进行一些处理
    doSomeStuff();
    // 监听事件后，默认行为被拦截，因此要手动调用返回
    QN.navigator.pop();
});

附录

内置 icon 列表