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图,尺寸450*90,如果设置了image,则前两个参数失效,并且不从webview的回调中读取titleN9.9.5

    注意

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

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