左側按鈕
通過呼叫 jkos.setNavLeftButton 控制 Navigation bar 左側顯示返回 (<) 或是關閉 (X) icon 以及其對應的行為和顏色。
- 設定一次按鈕顏色即可套用至所有頁面,若無指定顏色則預設顯示白色。
- 建議開發者將首頁設定為 X (type=2),並在離開首頁時設為 < (type=1) 以確保使用者從任何頁面回到首頁時都能將 webview 畫面關閉。
- 可在使用者點擊按鈕時,喚起原生的 popup 視窗,阻擋其操作行為。您可以使用這個功能來設計『確定要離開嗎?』類型的詢問視窗。
當開發者未設定時,預設行為是
- 開啟的第一個畫面導覽列左方 icon 將會顯示關閉鈕 X。
- 其他頁面則視為內頁,皆會顯示返回鍵 <。
使用方法
jkos.setNavLeftButton(data, callback);
<button id="test">setNavLeftButton</button>
<script>
document.querySelector ('#test'). addEventListener ('click', () => {
jkos.setNavLeftButton({
type : `1` ,
color : `#ffffff`,
confirm: {
content: 'string'
}
}, (res) => {
console.log(res.error)
console.log(res.errorMessage)
});
});
</script>
入參說明
必須 第一個參數:data
參數 | 必填 | 型態 | 說明 |
---|---|---|---|
type | 否 | string | 改變 Navbar 左上角按鈕 行為 與 UI :“1”向左箭頭的按鈕。返回前一頁“2”叉叉的按鈕。點擊後關閉 webview |
color | 否 | string | 改變 Navbar 左上角按鈕 顏色,使用 hex 色碼 |
confirm | 否 | object | 當點擊左上角按鈕時觸發彈窗,確定是否繼續操作 已定義的行為 |
confirm.content | 否 | object | 定義 彈窗內容文字 |
Popup Message (Confirm Box)
- 標題
- 文案:確定要離開嗎?
- 副標題
- 預設文案:您所進行的操作可能不會保留。
- 可透過 confirm.content 參數客製文案內容
- 按鈕
- 左:『取消』。點擊關閉彈窗
- 右:『離開』。點擊離開此頁面
非必須 第二個參數: callback
參數 | 型態 | 說明 |
---|---|---|
error | number | 錯誤碼 – 詳情請參見錯誤碼說明 |
errorMessage | string | 此描述為相關錯誤的 ASCII 編碼可讀文字 |
錯誤碼回覆
代碼 | 說明 |
---|---|
15 | 系統不支援 |
16 | 格式錯誤 |