調用setTitle設定標題 - Mobile Platform as a Service

此介面用於設定頁面的標題列，包括主標題、副標題以及標題功能表項目。

說明

由於蘋果的 ATS 限制，Image URL 必須為 HTTPS 連結或 Base64，而 HTTP 連結會被忽略。

setTitle 介面的使用方法

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)

入參

屬性	類型	描述	必填	預設值
title	string	主標題文案。	N	“”
subtitle	string	副標題文案。	N	“”
image	string	支援 URL 或者 Base64，請使用一張 3X 圖，如果設定了 image，則前兩個參數失效，並且不從 WebView 的回調中讀取 title。	N	“”

注意事項

在 Android 10.0.18 版本之前不支援設定空的 title，但是可以通過設定一個不可見的字串繞過這個限制，不過在 Android 10.0.20 版本中已經去掉了這個限制。

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