此接口用于設置頁面的標題欄,包括主標題、副標題以及標題菜單項。
說明
由于蘋果的 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',
});
文檔內容是否對您有幫助?