HTMLLoader  - AS3

指定是 (true) 否 (false) 應針對這個物件所發出的 HTTP 要求處理驗證要求。如果為 false，則驗證挑戰會傳回 HTTP 錯誤。

預設值為 initialized from URLRequestDefaults.authenticate。

相關 API 元素

針對這個物件所發出的 HTTP 要求，指定是否應快取成功回應資料。設定為 true 時，HTMLLoader 物件會使用作業系統的 HTTP 快取。

預設值為 initialized from URLRequestDefaults.cacheResponse。

相關 API 元素

HTML 內容的高度，以像素為單位。這個屬性會隨著 HTMLLoader 物件尺寸變更而變更。例如，HTML 網頁通常會使用 HTMLLoader 物件的整個高度，而且如果您變更 HTMLLoader 物件的高度，contentHeight 屬性可能會變更。

HTML 內容的寬度，以像素為單位。這個屬性會隨著 HTMLLoader 物件尺寸變更而變更。例如，HTML 網頁通常會使用 HTMLLoader 物件的整個寬度，而且如果您變更 HTMLLoader 物件的寬度，contentWidth 屬性可能會變更。

指出 HTMLLoader 物件中的任何內容是否可取得焦點。

指定所呈現 HTML 畫布矩形的高度。此屬性值是 HTMLLoader 顯示物件的高度，以像素為單位。height 最大值為 4095 像素。變更這個屬性會使 HTMLLoader 物件重新顯示 HTML 文件。為了回應這個屬性變更，可能會傳送 htmlBoundsChanged 事件。

當您設定 HTMLLoader 物件的 width 或 height 屬性時，物件邊界會變更但內容不會縮放 (其他類型的顯示物件也是如此)。

操作記錄清單的整體長度，包括後退和前進項目。這個屬性與 HTML 網頁的 window.history.length JavaScript 屬性具有相同值。

相關 API 元素

操作記錄清單中目前的位置。操作記錄清單對應於 HTML 網頁的 window.history 物件。小於目前位置的項目是「後退」清單，大於項目是「前進」清單。嘗試超過結尾設定位置，會在結尾設定位置。

相關 API 元素

HTMLHost 物件，用來處理特定使用者介面元素 (如 HTMLLoader 物件的 window.document.title 屬性) 的變更。若要覆寫 HTMLLoader 物件的預設行為，請建立 HTMLHost 類別的子類別並覆寫它的成員函數，以處理 HTML 內容中的各種使用者介面變更。

相關 API 元素

指定由這個物件發出之 HTTP 要求的閒置逾時值 (以毫秒為單位)。

閒置逾時是指當建立連線後，在放棄要求之前，用戶端等候伺服器回應的時間 (毫秒)。

預設值為 initialized from URLRequestDefaults.idleTimeout。

相關 API 元素

指出用戶端系統是否支援 HTMLLoader 類別。

指出對應於上一個 load() 或 loadString() 方法呼叫的 JavaScript load 事件是否已傳送至 HTMLLoader 物件中的 HTML DOM。傳送 complete 事件之前，這個屬性為 true。這個屬性可能永遠不會變成 true。在絕不會傳送 complete 事件的相同案例中，會發生這種情況。

HTMLLoader 物件中所載入內容的 URL。

指定 HTTP 通訊協定堆疊是否應管理這個物件的 Cookie。如果為 true，則 Cookie 會加入要求而且會記住回應 Cookie。如果為 false，則 Cookie 不會加入要求而且不會記住回應 Cookie。

預設值為 initialized from URLRequestDefaults.manageCookies。

相關 API 元素

指定 HTML 內容根框架瀏覽 (例如，當使用者按一下連結時、在設定 window.location 屬性時，或在呼叫 window.open() 時) 會造成 HTMLLoader 物件中的瀏覽 (false) 或預設系統網頁瀏覽器中的瀏覽 (true)。如果您想要所有瀏覽都在系統網頁瀏覽器中發生 (而不是在 HTMLLoader 物件中)，請將這個屬性設定為 true。

預設值為 false。

指定 HTMLLoader 文件的背景是 (true) 否 (false) 為不透明白色。如果這個屬性設定為 false，HTMLLoader 物件會使用它的顯示物件容器做為 HTML 背景，而且也會使用顯示物件容器的不透明度 (alpha 值) 做為 HTML 背景。不過，如果 HTML 文件的 body 元素或其他元素有不透明背景顏色 (例如，由 style="background-color:gray" 指定)，則所顯示 HTML 的該部分會使用指定的不透明背景顏色。

使用者系統上的 PDF 支援類型，定義為整數碼值。只有在這個屬性評估為 PDFCapability.STATUS_OK 時，HTMLLoader 物件才能顯示 PDF 內容。PDFCapability 類別為 pdfCapability 屬性的可能值定義了常數，如下：

相關 API 元素

指定透過 loadString() 方法所載入的內容是放入應用程式安全執行程序中 (true)，或是放入非應用程式安全執行程序中 (false)。

當這個屬性設定為 false 時，透過 loadString() 方法所載入的內容就會放入具有下列特性的非應用程式安全執行程序中：

• 它具有從網路 (而非檔案系統) 載入內容的存取權。
• 它無法使用 XMLHttpRequest 來載入資料。
• window.location 屬性設定為 "about:blank"。
• 此內容無法存取 window.runtime 屬性 (如同任何非應用程式安全執行程序中的內容)。

當這個屬性設定為 true 時，透過 loadString() 方法所載入的內容就會放入具備 window.runtime 屬性和所有 AIR API 之存取權的應用程式安全執行程序中。您應該確定 loadString() 方法呼叫中使用之字串的資料來源受到信任。當這個屬性設定為 true 時，HTML 字串中的程式碼陳述式就會以完整應用程式權限執行。只有當您確定字串不可能包含有害的程式碼時，才應該將這個屬性設定為 true。

在使用 AIR 1.0 或 AIR 1.1 SDK 所編譯的應用程式中，透過 loadString() 方法所載入的內容會放入應用程式安全執行程序中。

預設值為 false。

相關 API 元素

HTML 頁面中 JavaScript window.runtime 物件所使用的應用程式網域。

如果為 null，或是如果 HTML 內容不是來自包含 HTMLLoader 物件之 SWF 內容的安全性網域，頁面就會將預設應用程式網域做為頁面網域使用。

相關 API 元素

HTMLLoader 物件中 HTML 內容的水平捲動位置。

HTMLLoader 物件中 HTML 內容的垂直捲動位置。

使用者系統上的 SWF 支援類型，定義為整數碼值。只有在這個屬性評估為 HTMLSWFCapability.STATUS_OK 時，HTMLLoader 物件才能顯示 SWF 內容。HTMLSWFCapability 類別為 swfCapability 屬性的可能值定義了常數，如下：

相關 API 元素

HTMLLoader 內容使用的字元編碼 (如果 HTML 網頁未指定字元編碼)。HTML 網頁會在 meta 標籤中指定字元編碼，如下所示：

<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">

值已定義在 IANA 的「有效字元集」清單中。

如果 HTML 網頁未指定編碼 (藉由使用 textEncodingFallback 屬性或 textEncodingOverride 屬性)，則 HTML 內容會使用 ISO-8859-1 編碼。

相關 API 元素

HTMLLoader 內容使用的字元編碼，覆寫 HTML 網頁中的任何設定。HTML 網頁會在 meta 標籤中指定字元編碼，如下所示：

<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">

這個設定也會覆寫 textEncodingFallback 屬性中的任何設定。

值已定義在 IANA 的「有效字元集」清單中。

在 HTML 內容載入之後設定 textEncodingOverride 屬性，可讓 AIR 使用指定的編碼來重新整理 HTML 內容。一旦 HTMLLoader 瀏覽至新頁面，如果您想要新頁面使用特定編碼，則必須重新設定屬性。

如果 HTML 網頁未指定編碼 (藉由使用 textEncodingFallback 屬性或 textEncodingOverride 屬性)，則 HTML 內容會使用 ISO-8859-1 編碼。

將 textEncodingOverride 屬性設定為 null 會還原預設行為。

相關 API 元素

在這個物件所發出的 HTTP 要求取得資料之前，指定是否應查閱本機快取。

預設值為 initialized from URLRequestDefaults.useCache。

相關 API 元素

來自這個 HTMLLoader 物件的任何即將發出內容要求中所使用的使用者代理字串。

若要設定使用者代理字串，請在呼叫 load() 方法之前先設定 HTMLLoader 物件的 userAgent 屬性。「不」使用傳遞給 load() 方法之 URLRequest 物件的 userAgent 屬性。

您可以藉由設定 URLRequestDefaults.userAgent 屬性，設定應用程式網域中所有 HTMLLoader 物件使用的預設使用者代理字串。如果未設定 HTMLLoader 物件的 userAgent 屬性 (或是如果此值設定為 null)，則使用者代理字串會設定為靜態 URLRequestDefaults.userAgent 屬性的值。

如果未設定 HTMLLoader 的 userAgent 屬性值，也未設定 URLRequestDefaults.userAgent 屬性值，則會使用預設值做為使用者代理字串。這個預設值根據執行階段作業系統 (如 Mac OS、Linux 或 Windows)、執行階段語言和執行階段版本而有所不同，如下列範例所示：

• "Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5"
• "Mozilla/5.0 (Windows; U; en) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5"
• "Mozilla/5.0 (X11; U; Linux i686; en-US) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5"

相關 API 元素

指定所呈現 HTML 畫布矩形的寬度。這是 HTMLLoader 顯示物件的寬度，以像素為單位。width 最大值為 4095 像素。變更這個屬性會使 HTMLLoader 物件重新顯示 HTML 文件。為了回應這個屬性變更，可能會傳送 htmlBoundsChange 事件。當您設定 HTMLLoader 物件的 width 和 height 屬性時，物件邊界會變更但內容不會縮放 (其他類型的顯示物件也是如此)。

HTML 控制項中所載入內容的全域 JavaScript 物件。

建立 HTMLLoader 物件。

取消進行中的任何載入作業。

建立一個包含 HTMLLoader 物件的新 NativeWindow 物件。使用由這個方法傳回的 HTMLLoader 物件，以載入 HTML 內容。

根據預設 (呼叫這個方法但未設定參數時)，新視窗會使用標準系統顏色並包含內容的捲軸控制項。您可以設定參數以變更新視窗的屬性。

在視窗載入內容並套用樣式表時，可能會發生小的圖形干擾。若要避免出現不連續的情況，請將 visible 參數設為 false。載入視窗且配置其內容後，請將 window.nativeWindow.visible 屬性設為 true，或呼叫 window.nativeWindow.activate() 方法以顯現它。

參數

在指定位置傳回操作記錄項目。

參數

相關 API 元素

如果可能，在瀏覽器操作記錄中向後瀏覽。

呼叫 HTMLLoader 物件的這個方法與呼叫 HTML 網頁中 JavaScript window.history 屬性的 back() 方法具有相同作用。

這個函數不會擲出錯誤。

相關 API 元素

如果可能，在瀏覽器操作記錄中向前瀏覽。

呼叫 HTMLLoader 物件的這個方法與呼叫 HTML 網頁中 JavaScript window.history 屬性的 forward() 方法具有相同作用。

這個函數不會擲出錯誤。

相關 API 元素

在瀏覽器操作記錄中瀏覽指定的步驟數。如果為正值則向前瀏覽，如果為負值則向後瀏覽。以零值瀏覽會強制重新載入。

這個方法相當於呼叫 HTML 網頁中 JavaScript window.history 屬性的 go() 方法。

這個函數不會擲出錯誤。

參數

相關 API 元素

使用 urlRequestToLoad 參數所指定網站中的資料來載入 HTMLLoader 物件。呼叫這個方法一開始會將 loaded 屬性設定為 false。這個方法會起始一個一定以非同步方式完成的作業。

以隱含方式呼叫這個方法會取消以這個方法或 loadString() 方法所起始、任何待處理的前一個載入作業。絕不會傳送前一個載入作業的 complete 事件。

可能永遠不會傳送 complete 事件。這發生於載入 HTMLLoader 物件中的任何 HTML 內容從未完整下載時。如果 HTML 內容參考無限重複產生內容之 CGI 指令碼的 URL，就會發生這種情況。

參數

相關 API 元素

使用 HTML 字串中包含的 HTML 內容來載入 HTMLLoader 物件。當字串中的 HTML 完成呈現時，會傳送 complete 事件。complete 事件一定是以非同步方式傳送。

以隱含方式呼叫這個方法會取消以這個方法或 load() 方法所起始、任何待處理的前一個載入作業。絕不會傳送前一個載入作業的 complete 事件。

如果字串中指定的 HTML 沒有外部資源的參考，這個方法就會以同步方式顯示 HTML。不過，仍會以非同步方式傳送 complete 事件。在呼叫這個函數之後，如果這個類別的 loaded 屬性為 true，則會以同步方式顯示 htmlContent 引數中指定的 HTML 內容。

可能永遠不會傳送 complete 事件。這發生於載入 HTMLLoader 物件中的任何 HTML 內容從未完整下載時。如果 HTML 內容參考無限重複產生內容之 CGI 指令碼的 URL，就會發生這種情況。

只有當 placeLoadStringContentInApplicationSandbox 屬性設定為 true 時，透過 loadString() 方法所載入的內容才會放入應用程式安全執行程序中。

參數

相關 API 元素

從目前位置重新載入頁面。

指出 loadString 或 load 方法所要求的最後一個載入作業已完成。當 JavaScript load 事件已在 HTMLLoader 物件的 HTML DOM 上觸發之後，就會傳送此事件。這個事件一定是以非同步方式傳送。這個事件的事件處理常式可以呼叫 HTMLLoader 物件的任何方法或存取其任何屬性。

這個事件具有下列屬性：

相關 API 元素

指出 HTMLLoader 物件的 contentWidth 和 contentHeight 屬性或兩者已變更。例如，新影像或其他內容載入可能產生變更。事件處理常式可以呼叫 HTMLLoader 物件的任何方法或存取其任何屬性。

HTMLLoader 物件可以在起始載入作業之後的任何時間傳送這個事件，甚至在此物件已經傳送 complete 事件之後。

這個事件具有下列屬性：

相關 API 元素

指出為了回應載入作業，已建立 HTML DOM。在傳送此事件時，HTMLLoader 物件的 load() 和 loadString() 方法會擲出例外。在傳送此事件時，如果設定或呼叫任何 JavaScript 物件的任何屬性或方法，而該 JavaScript 物件可從控制 HTMLLoader 物件中所載入 URL 之 HTMLLoader 物件的 window 屬性來進行存取，也會擲出例外。例如，透過設定 HTMLLoader 物件的 window 屬性來設定 window.location 會產生 JavaScript 例外。

這個事件具有下列屬性：

相關 API 元素

指出 HTMLLoader 物件中的內容顯示都是最新的。每當 HTML 內容發生任何呈現變更時，就會頻繁地傳送這個事件。例如，當使用者按一下連結之後顯示新內容，或當網頁中的 JavaScript 呈現 HTML 時，會傳送這個事件。事件偵聽程式可以呼叫 HTMLLoader 的任何方法或存取其任何屬性。

這個事件的處理常式應該檢查 HTMLLoader 物件的 contentWidth 和 contentHeight 屬性，以便更新與它相關聯的任何捲軸。

HTMLLoader 物件可以在起始載入作業之後的任何時間傳送這個事件，甚至在此物件已經傳送 complete 事件之後。

這個事件具有下列屬性：

指出 HTMLLoader 物件的 location 屬性已變更。這個事件的事件處理常式可以呼叫 HTMLLoader 物件的任何方法或存取其任何屬性。

LocationChangeEvent 類型的 locationChange 事件是由使用 AIR namespace 2.7 和更新版本之應用程式中的 HTMLLoader 所傳送。在舊版 AIR 中，傳送的事件物件是 Event 類別的實體。

相關 API 元素

指出 HTMLLoader 物件的 location 屬性已變更。這個事件的事件處理常式可以呼叫 HTMLLoader 物件的任何方法或存取其任何屬性。

Event 類型的 locationChange 事件是由使用 AIR 2.7 以前版本命名空間之應用程式中的 HTMLLoader 所傳送。在 AIR 2.7 和更新版本中，事件物件是 LocationChangeEvent 類別的實體，可提供其他設定為新頁面 URL 的 location 屬性。

這個事件具有下列屬性：

相關 API 元素

發出訊號，表示 HTMLLoader 物件的 location 屬性即將變更。

locationChanging 事件只會在透過使用者互動而使位置變更時傳送，例如當使用者按一下連結，或是由 HTMLLoader 內執行的程式碼傳送，例如用戶端重新導向。根據預設，新位置將顯示在此 HTMLLoader 物件中。您可以呼叫事件物件的 preventDefault() 方法，以取消預設行為。例如，您可以使用 flash.net.navigateToURL() 函數，根據事件物件的 location 屬性，在系統瀏覽器中開啟頁面。

當您呼叫下列方法時，不會傳送 locationChanging() 事件：

• load()
• loadString()
• reload()
• historyBack()
• historyForward()
• historyGo()

此外，當 navigateInSystemBrowser 屬性為 true 且目的地頁面在系統瀏覽器中開啟時，不會傳送此事件，因為 HTMLLoader 位置未變更。

package{
    import flash.display.Sprite;
    import flash.html.HTMLLoader;
    import flash.net.URLRequest;
    
    public class LocationChanging extends Sprite
    {
        var htmlLoader:HTMLLoader = new HTMLLoader();
        public function LocationChanging()
        {
            htmlLoader.width = stage.stageWidth;
            htmlLoader.height = stage.stageHeight;        
            htmlLoader.addEventListener( LocationChangeEvent.LOCATION_CHANGING, onLocationChanging );
            htmlLoader.load( new URLRequest( "http://www.adobe.com" ) );
            this.addChild( htmlLoader );
        }
    
        private function onLocationChanging( event:LocationChangeEvent ):void
        {
            trace( "Location changing: " + event.location );
        
            if ( event.location.indexOf( "http://www.adobe.com" ) < 0 ) 
            {
                event.preventDefault();
            }
        }
    }
}

指出 HTMLLoader 物件已變更 scrollH 或 scrollV 屬性。當 HTMLLoader 物件中執行的 JavaScript 叫用 window 物件的 scrollTo() 方法，而所需的位置尚未顯示時，HTMLLoader 物件就會傳送這個事件。當 ActionScript 程式碼變更 scrollH 或 scrollV 屬性時，不會傳送此事件。事件處理常式可以呼叫 HTMLLoader 物件的任何方法或存取其任何屬性。

這個事件的事件處理常式應該檢查 scrollH 和 scrollV 屬性，以更新與 HTMLLoader 物件關聯的任何捲軸。

HTMLLoader 物件可以在起始載入作業之後的任何時間傳送這個事件，甚至在此物件已經傳送 complete 事件之後。

這個事件具有下列屬性：

指出 HTMLLoader 物件中發生未捕捉的 JavaScript 例外。事件處理常式可以呼叫 HTMLLoader 物件的任何方法或存取其任何屬性。此事件是可以取消的，在 AIR 除錯啟動程式中執行時，預設行為是將 JavaScript 堆疊傳送至追蹤輸出。

這個事件具有下列屬性：

相關 API 元素