google.script.url
是非同步的用戶端 JavaScript API,可查詢網址來取得目前的網址參數和片段。這個 API 支援 google.script.history
API。只能用於使用 IFRAME
的網頁應用程式。不適用於在外掛程式或容器指令碼內容中,與側欄和對話方塊搭配使用。詳情請參閱在網頁應用程式中使用瀏覽器歷史記錄的指南。
方法
方法 | 傳回類型 | 簡短說明 |
---|---|---|
getLocation(function) |
void |
取得網址位置物件,並傳遞至指定的回呼函式。 |
內容詳盡的說明文件
getLocation(function)
取得網址位置物件,並傳遞至指定的回呼函式 (做為唯一的引數)。
Index.html
google.script.url.getLocation(function(location) { console.log(location.parameters); console.log(location.hash); });
參數
名稱 | 類型 | 說明 |
---|---|---|
function | Function | 要執行的用戶端回呼函式,使用位置物件做為唯一的引數。 |
位置物件
下表舉例說明系統查詢以下網址時,可能會指定的位置元素:http://www.example.com?n=1&name=alice&n=2#headingAnchor
欄位 | |
---|---|
location.hash |
headingAnchor |
location.parameter |
與網址要求參數相對應的鍵/值組合物件。如果參數有多個值,系統只會傳回第一個值。如果沒有參數,這個物件會是空白的物件。 {"name": "alice", "n": "1"} |
location.parameters |
與 {"name": ["alice"], "n": ["1", "2"]} |