App Inventor 2 指令中文化 Web 元件

Web 網路

非可視元件,可提供 HTTP GET, POST, PUT 以及 DELETE 等功能。


屬性

AllowCookies
設定是否可儲存網頁回應的 cookies,並用於後續的網路要求。只有 Android 2.3 版以後才支援 cookie。.



RequestHeaders
Request header 為一個包含兩個子清單的清單。

每個子清單的第二個元素則是該 request header 的欄位名稱;第二個元素則是該 request header 的欄位值,可能是單一值或是一個包含多值的清單。



ResponseFileName
用來儲存網頁回應的檔案名稱。如果 SaveResponse 欄位設訂為 true 但未指定 ResponseFileName 的話,就會自動產生新的檔名。



SaveResponse
設定是否要將網頁回應存在檔案中。



Url
網路要求的 URL 路徑。




事件

GotFile(text url, number responseCode, text responseType, text fileName)
執行完一次網路取得檔案之後,呼叫本事件。



GotText(text url, number responseCode, text responseType, text responseContent)
執行完一次網路取得文字檔案之後,呼叫本事件。




方法

text BuildRequestData(list list)
將一個包含兩個子清單的清單(一對對的[名稱/值])轉為像onverts a list of two-element sublists, representing name and value pairs, to a string formatted as application/x-www-form-urlencoded media type,可用來傳給 PostText。



ClearCookies()
清除本 Web 元件的所有 cookies。



Delete()
執行一次 HTTP DELETE 要求,須設定 Url 屬性之後才能取得回應。如果 SaveResponse 屬性為 true,回應會存在某個檔案之中並呼叫 GotFile 事件。

ResponseFileName 屬性可用來指定該檔案檔名。如果 SaveResponse 屬性為 false,就會呼叫 GotText 事件。


Get()
執行一次 HTTP GET 要求,須設定 Url 屬性之後才能取得回應。如果 SaveResponse 屬性為 true,回應會存在某個檔案之中並呼叫 GotFile 事件。

ResponseFileName 屬性可用來指定該檔案檔名。如果 SaveResponse 屬性為 false,就會呼叫 GotText 事件。


HtmlTextDecode(text htmlText)
對指定 HTML 文字進行解碼。像&amp;、&lt;、&gt;、&apos; 以及 &quot; 這樣的 HTML字元會被解析為 &, <, >, ', 與 "。像 &#xhhhh 與 &#nnnn 會被解析為對應的字元。



JsonTextDecode(text jsonText)
解碼指定的 JSON 物件以產生對應的 AppInventor 值。一個 JSON 清單 [x, y, z] 會被解碼為 (x y z) 這樣的清單。

具有 name A 與 value B 的 JSON物件,例如 {name:123},會被解碼為會被解碼為 ((name 123)) 這樣的清單,也就是一個包含一個二元素清單 (name 123) 的清單。



PostFile(text path)
執行一次 HTTP POST 要求,須設定 Url 屬性與指定檔案的路徑資料。如果 SaveResponse 屬性為 true,回應會存在某個檔案之中並呼叫 GotFile 事件。

ResponseFileName 屬性可用來指定該檔案檔名。如果 SaveResponse 屬性為 false,就會呼叫 GotText 事件。



PostText(text text)
執行一次 HTTP POST 要求,須設定 Url 屬性與指定文字。文字字元會以 UTF-8 進行編碼。如果 SaveResponse 屬性為 true,回應會存在某個檔案之中並呼叫 GotFile 事件。

ResponseFileName 屬性可用來指定該檔案檔名。如果 SaveResponse 屬性為 false,就會呼叫 GotText 事件。



PostTextWithEncoding(text text, text encoding)
執行一次 HTTP POST 要求,需設定 Url 屬性與指定文字。文字字元會以指定格式來進行編碼。如果 SaveResponse 屬性為 true,回應會存在某個檔案之中並呼叫 GotFile 事件。

ResponseFileName 屬性可用來指定該檔案檔名。如果 SaveResponse 屬性為 false,就會呼叫 GotText 事件。



PutFile(text path)
執行一次 HTTP PUT 要求,須設定 Url 屬性與指定檔案的路徑資料。如果 SaveResponse 屬性為 true,回應會存在某個檔案之中並呼叫 GotFile 事件。

ResponseFileName 屬性可用來指定該檔案檔名。如果 SaveResponse 屬性為 false,就會呼叫 GotText 事件。



PutText(text text)
執行一次 HTTP PUT 要求,須設定 Url 屬性與指定文字。文字字元會以 UTF-8 進行編碼。如果 SaveResponse 屬性為 true,回應會存在某個檔案之中並呼叫 GotFile 事件。

ResponseFileName 屬性可用來指定該檔案檔名。如果 SaveResponse property 為 false,就會呼叫 GotText 事件。



PutTextWithEncoding(text text, text encoding)
執行一次 HTTP PUT request using the Url property and the specified text.文字中的字員會以指定編碼格式來進行編碼。如果 SaveResponse 屬性為 true,回應會存在某個檔案之中並呼叫 GotFile 事件。

ResponseFileName 屬性可用來指定該檔案檔名。如果 SaveResponse 屬性為 false,就會呼叫 GotText 事件。



text UriEncode(text text)
將指定文字進行編碼,讓它可用在 URL之中。