標題與顏色

setNavTitle

開發者可自行設定 Navigation bar 的背景顏色、標題文字與顏色,以配合品牌視覺色呈現。

建議使用相同的背景和標題顏色,維持一致性。

通過呼叫 jkos.setNavTitle 設定 Navigation bar 的 標題 與 標題顏色

  • 設定一次標題顏色即可套用至所有頁面,若無設定則預設顯示白色。
  • 可針對單一頁面設定標題顯示內容,若無指定顏色則預設抓取該頁面標題 <title>

使用方法

jkos.setNavTitle(data, callback);
<button id="test">setNavTitle</button> 

<script> 
  document.querySelector('#test').addEventListener('click', () => {
    jkos.setNavTitle({
      title :  `string` ,
      color :  `#ffffff`, 
    }, (res) => {
      console.log(res.error)
      console.log(res.errorMessage)
    });
  });
</script>

入參說明

必須 第一個參數:data

參數必填型態說明
titlestring提供開發者改變 Navbar title 文字
colorstring提供開發者改變 Navbar title 文字的顏色,使用 hex 色碼

非必須 第二個參數: callback

返回設定函式成功與否,也可使用 async/await 取代 callback

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

setNavBackground

通過呼叫 jkos.setNavBackground 設定 Navigation bar 背景 屬性

  • 設定一次導覽列的背景顏色即可套用至所有頁面,若無指定顏色則預設顯示街口品牌紅色。

使用方法

jkos.setNavBackground(data, callback);
<button id="test">setNavBackground</button> 

<script> 
  document.querySelector('#test').addEventListener('click', () => {
    jkos.setNavBackground({
      color: '#ffffff',
    }, (res) => {
      console.log(res.error)
      console.log(res.errorMessage)
    });
  });
</script>

入參說明

必須 第一個參數:data

參數必填型態說明
colorstring提供開發者改變 Navbar 背景顏色,使用 hex 色碼

非必須 第二個參數: callback

參數型態說明
errornumber錯誤碼 – 詳情請參見錯誤碼說明
errorMessagestring此描述為相關錯誤的 ASCII 編碼可讀文字
參數必填型態說明mode 支援度
modestring設定 Navbar 右上角模式:
“1”:分享按鈕
“2”:我的按鈕
“3”:菜單列表按鈕
colorstring改變 Navbar 右上角 icon 的 顏色,使用 hex 色碼123
urlmode 決定是否必填string改變 Navbar 右上角的 url (注意:只允許分享該網域的 url)1(必填)2必填)
onClickstring點擊之後的回呼函式3,2

非必須 第二個參數: callback

返回設定函式成功與否,也可使用 async/await 取代 callback

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

錯誤碼回覆

代碼說明
15系統不支援
16格式錯誤