JSAPI

Since 8.0

setTitle

设置页面的标题栏，包括主标题，副标题以及标题菜单项

注意：由于苹果的ATS限制，image URL必须为https链接或base64，http链接会被忽略

使用方法

AlipayJSBridge.call('setTitle', {
  title: '标题',
});

代码演示

设置各种类型的标题栏

<h1>点击以下按钮看不同效果</h1>
<a href="javascript:void(0)" class="btn title">只设置标题</a>
<a href="javascript:void(0)" class="btn subTitle">标题+副标题</a>
<a href="javascript:void(0)" class="btn clear">清空标题</a>

<script>
function ready(callback) {
  // 如果jsbridge已经注入则直接调用
  if (window.AlipayJSBridge) {
    callback && callback();
  } else {
    // 如果没有注入则监听注入的事件
    document.addEventListener('AlipayJSBridgeReady', callback, false);
  }
}
ready(function(){
  document.querySelector('.title').addEventListener('click', function() {
    AlipayJSBridge.call('setTitle', {
      title: '标题'
    });
  });

  document.querySelector('.subTitle').addEventListener('click', function() {
    AlipayJSBridge.call('setTitle', {
      title: '标题',
      subtitle: '副标题'
    });
  });

  document.querySelector('.clear').addEventListener('click', function() {
    AlipayJSBridge.call('setTitle', {
      title: ' ',
      subtitle: ' ',
    });
  });
});
</script>
查看演示
扫码查看
用支付宝扫码运行

API

AlipayJSBridge.call('setTitle',{
  title, subtitle, image
}, fn)

入参

名称类型描述必选默认值版本
titlestring主标题文案N
subtitlestring副标题文案N
imagestring支持url或者base64，请使用一张3X图，如果设置了image，则前两个参数失效，并且不从webview的回调中读取titleN9.9.5

注意

安卓10.0.18版本之前不支持设置空的title，可以通过设置一个不可见字符串绕过去，10.0.20版本已经去掉这个限制

AlipayJSBridge.call('setTitle', {
  title: '\u200b',
});