右側按鈕

setNavRightButton

通過呼叫 jkos.setNavRightButton 控制 Navigation bar 右側顯示的 icon、顏色與其對應的功能，每次只能顯示一個 icon。

使用方法​

jkos.setNavRightButton(data, callback);

提供以下按鈕類型，可依需求設定導航欄右側按鈕：

設定 分享按鈕  mode = 1​

• 當使用者點擊分享按鈕時，會開啟原生分享 module。
• 分享文字內容為：我在街口發現了有趣的東西！分享給你 [當前頁面網址連結]
• 使用者點擊網址後，會透過街口 App 開啟畫面。
  • 若使用者的裝置沒有安裝街口 App 則會導引至街口 App 的商店下載頁。

<button id="test">setNavRightButton</button> 

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

設定 我的按鈕  mode = 2​

• 開發者可指定該按鈕點擊後跳轉的頁面。
• 導轉網址的域名須與 WebView 當前頁面的域名一致。

<button id="test">setNavRightButton</button> 

<script> 
  document.querySelector('#test').addEventListener('click', () => {
    jkos.setNavRightButton({
      mode: "2",
      color: '#ffffff',
      url: 'http://xxxxxxxxxx',
      onClick: () => {
        // console.log('若 url 與 onClick 同時存在，onClick 會失效不會同時觸發');
      },
    }, (res) => {
      console.log(res.error)
      console.log(res.errorMessage)
    });
  });
</script>

設定 菜單按鈕  mode = 3​

• 提供開發者展示側邊欄。
• 設定成功後，當使用者點擊 menu icon 後，街口會回呼一次 onClick 事件。

<button id="test">setNavRightButton</button> 

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

入參說明​

必須 第一個參數：data

參數	必填	型態	說明	mode 支援度
mode	是	string	設定 Navbar 右上角模式: “1”：分享按鈕 “2”：我的按鈕 “3”：菜單列表按鈕
color	否	string	改變 Navbar 右上角 icon 的 顏色，使用 hex 色碼	1, 2, 3
url	mode 決定是否必填	string	改變 Navbar 右上角的 url (注意：只允許分享該網域的 url)	1(必填), 2必填)
onClick	否	string	點擊之後的回呼函式	3,2

非必須 第二個參數： callback

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

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

---

clearNavRightButton

通過呼叫 jkos.clearNavRightButton 移除 右上角 button

使用方法​

jkos.clearNavRightButton(callback);

<button id="test">clearNavRightButton</button> 

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

入參說明​

非必須 第一個參數： callback

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

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

錯誤碼回覆​

請參閱 錯誤代碼附錄。