左側按鈕

setNavLeftButton

通過呼叫 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

參數必填型態說明
typestring改變 Navbar 左上角按鈕 行為 與 UI :“1”向左箭頭的按鈕。返回前一頁“2”叉叉的按鈕。點擊後關閉 webview
colorstring改變 Navbar 左上角按鈕 顏色,使用 hex 色碼
confirmobject當點擊左上角按鈕時觸發彈窗,確定是否繼續操作 已定義的行為
confirm.contentobject定義 彈窗內容文字
Popup Message (Confirm Box)
  • 標題
    • 文案:確定要離開嗎?
  • 副標題
    • 預設文案:您所進行的操作可能不會保留。
    • 可透過 confirm.content 參數客製文案內容
  • 按鈕
    • 左:『取消』。點擊關閉彈窗
    • 右:『離開』。點擊離開此頁面

非必須 第二個參數: callback

參數型態說明
errornumber錯誤碼 – 詳情請參見錯誤碼說明
errorMessagestring此描述為相關錯誤的 ASCII 編碼可讀文字

錯誤碼回覆

請參閱 錯誤代碼附錄