HTMLLoader  - AS3

Anger om autentiseringsbegäranden ska hanteras (true) eller inte (false) för HTTP-begäranden som utfärdas av det här objektet. Om värdet är false returnerar autentiseringskrav ett HTTP-fel.

Standardvärdet är initialized from URLRequestDefaults.authenticate.

Relaterade API-element

Anger huruvida data för lyckade svar ska cachelagras för HTTP-begäranden som utfärdas av det här objektet. När värdet är true använder HTMLLoader-objektet operativsystemets HTTP-cache.

Standardvärdet är initialized from URLRequestDefaults.cacheResponse.

Relaterade API-element

Höjden i pixlar för HTML-innehållet. Den här egenskapen kan ändras när dimensionerna för HTMLLoader-objektet ändras. Exempelvis använder en HTML-sida ofta hela höjden för HTMLLoader-objektet, och egenskapen contentHeight kan ändras om du ändrar höjden på HTMLLoader-objektet.

Bredden i pixlar för HTML-innehållet. Den här egenskapen kan ändras när dimensionerna för HTMLLoader-objektet ändras. Exempelvis använder en HTML-sida ofta hela bredden för HTMLLoader-objektet, och egenskapen contentWidth kan ändras om du ändrar bredden på HTMLLoader-objektet.

Anger om något innehåll i HTMLLoader-objektet går att fokusera.

Anger höjden på rektangeln för den HTML-arbetsyta som återges. Egenskapsvärdet är höjden på HTMLLoader-visningsobjektet i antal pixlar. Maxvärdet för height är 4 095 pixlar. Om den här egenskapen ändras återger HTMLLoader HTML-dokumentet på nytt. htmlBoundsChanged-händelser kan skickas som svar på att den här egenskapen ändras.

När du anger egenskapen width eller height för ett HTMLLoader-objekt ändras objektets gränser, men innehållet skalas inte (vilket skulle inträffa med andra typer av visningsobjekt).

Den sammanlagda längden på historiklistan, inklusive poster för bakåt och framåt. Den här egenskapen har samma värde som JavaScript-egenskapen window.history.length för HTML-sidan.

Relaterade API-element

Den aktuella positionen i historiklistan. Historiklistan motsvarar HTML-sidans window.history-objekt. Poster som är mindre än den aktuella positionen är positioner "bakåt" i listan och poster som är större är "framåt". Vid försök att ange positionen efter slutet anges positionen till slutet.

Relaterade API-element

Det HTMLHost-objekt som används för att hantera ändringar till vissa element i användargränssnittet, till exempel egenskapen window.document.title för HTMLLoader-objektet. Om du vill åsidosätta standardbeteenden för HTMLLoader-objekt skapar du en underklass till klassen HTMLHost och åsidosätter dess medlemsfunktioner för att hantera olika ändringar av användargränssnittet i HTML-innehållet.

Relaterade API-element

Anger tidsgränsen för inaktivitet (i millisekunder) för HTTP-begäranden från det här objektet.

Tidsgränsen för inaktivitet är den tid som klienten väntar på ett svar från servern, efter att anslutningen har skapats, innan den överger begäran.

Standardvärdet är initialized from URLRequestDefaults.idleTimeout.

Relaterade API-element

Anger om klassen HTMLLoader stöds på klientsystemet.

Anger om JavaScript-händelsen load som motsvarar föregående anrop till metoden load() eller loadString() har levererats till HTML DOM i HTMLLoader-objektet. Den här egenskapen är true innan complete-händelsen skickas. Det är möjligt att den här egenskapen aldrig får värdet true. Detta inträffar i de fall då complete-händelsen aldrig skickas.

URL:en för det innehåll som har lästs in i HTMLLoader-objektet.

Anger huruvida HTTP-protokollstacken ska hantera cookies för det här objektet. Om värdet är true läggs cookies till i begäran och cookies i svar registreras. När värdet är false läggs cookies inte till i begäran och cookies i svar registreras inte.

Standardvärdet är initialized from URLRequestDefaults.manageCookies.

Relaterade API-element

Anger om navigering i HTML-innehållets rotram (till exempel när användaren klickar på en länk, när egenskapen window.location anges eller när window.open() anropas) resulterar i navigering i HTMLLoader-objektet (false) eller i systemets standardwebbläsare (true). Ange den här egenskapen till true om du vill att all navigering ska utföras i systemets webbläsare (och inte i HTMLLoader-objektet).

Standardvärdet är false.

Bestämmer om bakgrunden i HTMLLoader-dokumentet är ogenomskinligt vit (true) eller inte (false). Om den här egenskapen har värdet false använder HTMLLoader-objektet visningsobjektsbehållaren som bakgrund för HTML-innehållet och ogenomskinligheten (alpha-värdet) för visningsobjektsbehållaren som HTML-bakgrund. Om body-elementet eller något annat element i HTML-dokumentet däremot har en ogenomskinlig bakgrundsfärg (angiven med style="background-color:gray", till exempel), använder den delen av det återgivna HTML-innehållet den angivna ogenomskinliga bakgrundsfärgen.

Typen av PDF-stöd i användarens system, angett som ett heltalskodvärde. Ett HTMLLoader-objekt kan endast visa PDF-innehåll om den här egenskapen utvärderas som PDFCapability.STATUS_OK. Klassen PDFCapability definierar konstanter för möjliga värden för egenskapen pdfCapability, enligt följande:

Relaterade API-element

Specificerar om innehåll som lästs in via metoden loadString() placeras i programsandlådan (true) eller i en icke-programsandlåda (false).

När den här egenskapen ställs in på false placeras innehåll som läses in via metoden loadString() i en icke-programsandlåda med följande egenskaper:

• Den har tillgång till inläst innehåll från nätverket (men inte från filsystemet).
• Den kan inte läsa in data med hjälp av XMLHttpRequest.
• Egenskapen window.location ställs in på "about:blank".
• Innehållet har inte tillgång till egenskapen window.runtime (liksom innehåll i icke-programsandlådor).

När den här egenskapen ställs in på true placeras innehåll som läses in via metoden loadString() i programsandlådan, med tillgång till egenskapen window.runtime och alla AIR-API:er. Se till att datakällan för en sträng som används i ett anrop till metoden loadString() är betrodd. Kodprogramsatserna i HTML-strängen körs med fullständig programbehörighet när den här egenskapen ställs in på true. Du bör bara ställa in den här egenskapen på true när du är säker på att strängen inte kan innehålla skadlig kod.

I program som kompileras med AIR 1.0- eller AIR 1.1-SDK:er placeras innehåll som läses in via metoden loadString() i programsandlådan.

Standardvärdet är false.

Relaterade API-element

Den programdomän som ska användas för window.runtime-objektet i JavaScript-kod på HTML-sidan.

Om värdet är null, eller om HTML-innehållet kommer från en annan säkerhetsdomän än det SWF-innehåll som innehåller HTMLLoader-objektet, använder sidan en standardprogramdomän som domän.

Relaterade API-element

Den vågräta rullningspositionen för HTML-innehållet i HTMLLoader-objektet.

Den lodräta rullningspositionen för HTML-innehållet i HTMLLoader-objektet.

Typen av SWF-stöd på användarens system, angett som ett heltalskodvärde. Ett HTMLLoader-objekt kan endast visa SWF-innehåll om den här egenskapen utvärderas som HTMLSWFCapability.STATUS_OK. Klassen HTMLSWFCapability definierar konstanter för möjliga värden för egenskapen swfCapability, enligt följande:

Relaterade API-element

Den teckenkodning som används av HTMLLoader-innehållet om ingen teckenkodning anges på en HTML-sida. En HTML-sida anger en teckenkodning i en meta-tagg, som i följande exempel:

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

Värdena definieras i IANA-listan över giltiga teckenuppsättningar.

Om ingen kodning anges på HTML-sidan, av egenskapen textEncodingFallback eller av egenskapen textEncodingOverride, används ISO-8859-1-kodning av HTML-innehållet.

Relaterade API-element

Den teckenkodning som används i HTMLLoader-innehållet. Denna åsidosätter alla inställningar på HTML-sidan. En HTML-sida anger en teckenkodning i en meta-tagg, som i följande exempel:

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

Den här inställningen åsidosätter även en eventuell inställning i egenskapen textEncodingFallback.

Värdena definieras i IANA-listan över giltiga teckenuppsättningar.

Ange egenskapen textEncodingOverride efter att HTML-innehållet har lästs in, så att AIR kan uppdatera HTML-innehållet med den angivna kodningen. När HTMLLoader navigerar till en ny sida måste du ange egenskapen igen, om du vill att den nya sidan ska använda en viss kodning.

Om ingen kodning anges på HTML-sidan, av egenskapen textEncodingFallback eller av egenskapen textEncodingOverride, används ISO-8859-1-kodning av HTML-innehållet.

Om egenskapen textEncodingOverride anges till null återställs standardbeteendet.

Relaterade API-element

Anger huruvida den lokala cachen ska genomsökas innan HTTP-begäranden som utfärdas av det här objektet hämtar data.

Standardvärdet är initialized from URLRequestDefaults.useCache.

Relaterade API-element

Den användaragentsträng som ska användas i kommande innehållsbegäranden från det här HTMLLoader-objektet.

Ange användaragentsträngen genom att ange egenskapen userAgent för HTMLLoader-objektet innan metoden load() anropas. Egenskapen userAgent för det URLRequest-objekt som skickas till metoden load() används inte.

Du kan ange den standardinställda användaragentsträng som ska användas av alla HTMLLoader-objekt i en programdomän genom att ange egenskapen URLRequestDefaults.userAgent. Om inget värde anges för egenskapen userAgent för HTMLLoader (eller om värdet anges till null) anges användaragentsträngen till värdet för den statiska egenskapen URLRequestDefaults.userAgent.

Om inget värde anges, varken för egenskapen userAgent för HTMLLoader eller för URLRequestDefaults.userAgent, används ett standardvärde som användaragentsträng. Det här standardvärdet varierar beroende på körningsmiljöns operativsystem (till exempel Mac OS, Linux eller Windows), körningsmiljöns språk och körningsmiljöns version, som i följande exempel:

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

Relaterade API-element

Anger bredden på rektangeln för den HTML-arbetsyta som återges. Detta anger bredden på HTMLLoader visningsobjekt i pixlar. Maxvärdet för width är 4 095 pixlar. Om den här egenskapen ändras återger HTMLLoader HTML-dokumentet på nytt. htmlBoundsChange-händelser kan skickas som svar på att den här egenskapen ändras. När du anger egenskaperna width och height för ett HTMLLoader-objekt ändras objektets gränser, men innehållet skalas inte (vilket skulle inträffa med andra typer av visningsobjekt).

Det globala JavaScript-objektet för innehållet som läses in i HTML-kontrollen.

Skapar ett HTMLLoader-objekt.

Avbryter alla pågående inläsningar.

Skapar ett nytt NativeWindow-objekt som innehåller ett HTMLLoader-objekt. Använd det HTMLLoader-objekt som returneras av den här metoden för att läsa in HTML-innehåll.

Som standard (om du inte anger några parametrar när den här metoden anropas) använder det nya fönstret standardsystemfärg och innehåller rullningslister för innehållet. Du kan ange parametrarna för att ändra det nya fönstrets egenskaper.

När innehållet läses in till fönstret och formateras kan mindre grafikfel uppstå. Om du vill undvika att sådan brister syns anger du parametern visible som false. När allt innehåll har hämtats till fönstret och ritats upp kan du visa det genom att ange egenskapen window.nativeWindow.visible som true eller anropa metoden window.nativeWindow.activate().

Parametrar

Returnerar historikposten vid den angivna positionen.

Parametrar

Relaterade API-element

Navigerar bakåt i webbläsarhistoriken, om det är möjligt.

Att anropa den här metoden för HTMLLoader-objektet har samma effekt som att anropa metoden back() för egenskapen window.history i JavaScript-kod på HTML-sidan.

Den här funktionen genererar inga felmeddelanden.

Relaterade API-element

Navigerar framåt i webbläsarhistoriken, om det är möjligt.

Att anropa den här metoden för HTMLLoader-objektet har samma effekt som att anropa metoden forward() för egenskapen window.history i JavaScript-kod på HTML-sidan.

Den här funktionen genererar inga felmeddelanden.

Relaterade API-element

Navigerar angivet antal steg i webbläsarhistoriken. Navigerar framåt om värdet är positivt och bakåt om värdet är negativt. Navigering med värdet noll tvingar fram en ny inläsning.

Den här metoden motsvarar att anropa metoden go() för egenskapen window.history i JavaScript-kod på HTML-sidan.

Den här funktionen genererar inga felmeddelanden.

Parametrar

Relaterade API-element

Läser in HTMLLoader-objektet med data från den plats som anges av parametern urlRequestToLoad. Om den här metoden anropas initialt anges egenskapen loaded till false. Den här metoden initierar en åtgärd som alltid slutförs asynkront.

Ett anrop till den här metoden avbryter implicit alla tidigare väntande inläsningar som har initierats med den här metoden eller metoden loadString(). complete-händelsen för den tidigare inläsningen levereras aldrig.

Det är möjligt att complete-händelsen aldrig levereras. Detta inträffar om någon del av det HTML-innehåll som läses in i HTMLLoader-objektet aldrig laddas ned helt. Det kan inträffa om HTML-innehållet refererar till en URL till ett CGI-skript som hela tiden genererar nytt innehåll.

Parametrar

Relaterade API-element

Läser in HTMLLoader-objektet med HTML-innehållet som finns i HTML-strängen. När återgivningen av HTML-innehållet i strängen har slutförts skickas complete-händelsen. complete-händelsen skickas alltid asynkront.

Ett anrop till den här metoden avbryter implicit alla tidigare väntande inläsningar som har initierats med den här metoden eller metoden load(). complete-händelsen för den tidigare inläsningen levereras aldrig.

Om HTML-innehållet som anges i strängen saknar referenser till externa resurser återger den här metoden HTML-innehållet synkront. Däremot skickas complete-händelsen fortfarande asynkront. Om egenskapen loaded för den här klassen har värdet true omedelbart efter ett anrop till den här funktionen, återgavs HTML-innehållet som hade angetts i argumentet htmlContent synkront.

Det är möjligt att complete-händelsen aldrig levereras. Detta inträffar om någon del av det HTML-innehåll som läses in i HTMLLoader-objektet aldrig laddas ned helt. Det kan inträffa om HTML-innehållet refererar till en URL till ett CGI-skript som hela tiden genererar nytt innehåll.

Innehåll som läses in via metoden loadString() placeras bara i programmets säkerhetssandlåda om egenskapen placeLoadStringContentInApplicationSandbox ställs in på true.

Parametrar

Relaterade API-element

Läser in sidan från den aktuella platsen på nytt.

Signalerar att den senaste inläsningen som begärdes av loadString- eller load-metoden har slutförts. Den här händelsen skickas efter att JavaScript-händelsen load har utlösts för HTML DOM i HTMLLoader-objektet. Den här händelsen skickas alltid asynkront. Händelsehanteraren för den här händelsen kan anropa alla metoder och komma åt alla egenskaper för HTMLLoader-objektet.

Den här händelsen har följande egenskaper:

Relaterade API-element

Signalerar att den ena eller båda contentWidth och contentHeight-egenskaperna i ett TMLLoader-objekt har ändrats. Detta kan vara ett resultat av exempelvis inläsning av en ny bild eller annat innehåll. Händelsehanterare kan anropa alla metoder och komma åt alla egenskaper för HTMLLoader-objektet.

HTMLLoader-objektet kan skicka den här händelsen när som helst efter att en load-åtgärd har initierats, även efter att complete-händelsen har skickats.

Den här händelsen har följande egenskaper:

Relaterade API-element

Signalerar att HTML DOM har skapats som svar på en inläsning. Metoderna load() och loadString() för HTMLLoader-objektet genererar ett undantag när den här händelsen skickas. Ett undantag genereras av alla egenskaper och metoder för alla JavaScript-objekt som går att komma åt från egenskapen window för det HTMLLoader-objekt som styr vilken URL som läses in i HTMLLoader-objektet, om de anges eller anropas när den här händelsen skickas. Exempelvis genereras ett JavaScript-undantag om window.location anges genom att ställa in egenskapen window för HTMLLoader-objektet.

Den här händelsen har följande egenskaper:

Relaterade API-element

Signalerar att återgivningen av innehåll i HTMLLoader-objektet är helt uppdaterad. Den här händelsen kan skickas ganska ofta – varje gång en ändring i återgivningen av HTML-innehållet görs. Exempelvis skickas den här händelsen när nytt innehåll visas till följd av att en användare klickar på en länk eller när JavaScript på sidan återger HTML. Händelselyssnare kan anropa alla metoder och komma åt alla egenskaper för HTMLLoader-objektet.

Hanterare för den här händelsen ska kontrollera egenskaperna contentWidth och contentHeight för HTMLLoader för att uppdatera eventuella rullningslister som har associerats med den.

HTMLLoader-objektet kan skicka den här händelsen när som helst efter att en load-åtgärd har initierats, även efter att complete-händelsen har skickats.

Den här händelsen har följande egenskaper:

Signalerar att egenskapen location för HTMLLoader-objektet har ändrats. Händelsehanteraren för den här händelsen kan anropa alla metoder och komma åt alla egenskaper för HTMLLoader-objektet.

En locationChange-händelse med typen LocationChangeEvent skickas av HTMLLoader i program som använder namnutrymmen för AIR 2.7 och senare. I tidigare AIR-versioner är det skickade händelseobjektet en instans av Event-klassen.

Relaterade API-element

Signalerar att egenskapen location för HTMLLoader-objektet har ändrats. Händelsehanteraren för den här händelsen kan anropa alla metoder och komma åt alla egenskaper för HTMLLoader-objektet.

En locationChange-händelse med typen Event skickas av HTMLLoader i program där ett namnutrymme före AIR 2.7 används. I AIR 2.7 och senare är händelseobjektet en instans av LocationChangeEvent-klassen, som ger ytterligare en location-egenskap inställd för den nya URL-sidan.

Den här händelsen har följande egenskaper:

Relaterade API-element

Signalerar att egenskapen location för HTMLLoader-objektet är på väg att ändras.

En locationChanging-händelse skickas endast när platsen initieras genom en användarinteraktion, som exempelvis när användaren klickar på en länk eller när kod körs i HTMLLoader, som exempelvis vid en omdirigering på klientsidan. Den nya platsen visas som standard i det här HTMLLoader-objektet. Du kan anropa metoden preventDefault() för händelseobjektet om du vill avbryta standardbeteendet. Du kan till exempel använda funktionen flash.net.navigateToURL() för att öppna sidan i systemets webbläsare baserat på egenskapen location för händelseobjektet..

En locationChanging()-händelse skickas inte när du anropar följande metoder:

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

Dessutom skickas inte denna händelse när egenskapen navigateInSystemBrowser är true och destinationssidan är öppen i systemets webbläsare eftersom HTMLLoader-platsen inte ändras.

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();
            }
        }
    }
}

Signalerar att egenskapen scrollH eller scrollV har ändrats av HTMLLoader-objektet. HTMLLoader-objektet skickar den här händelsen när JavaScript som körs i HTMLLoader-objektet anropar metoden scrollTo() för window-objektet och den önskade platsen inte redan är synlig. Händelsen skickas inte när ActionScript-koden ändrar egenskapen scrollH eller scrollV. Händelsehanterare kan anropa alla metoder och komma åt alla egenskaper för HTMLLoader-objektet.

Händelsehanterare för den här händelsen ska kontrollera egenskaperna scrollH och scrollV för att uppdatera eventuella rullningslister som har associerats med HTMLLoader-objektet.

HTMLLoader-objektet kan skicka den här händelsen när som helst efter att en load-åtgärd har initierats, även efter att complete-händelsen har skickats.

Den här händelsen har följande egenskaper:

Signalerar att ett ohanterat JavaScript-undantag har inträffat i HTMLLoader-objektet. Händelsehanterare kan anropa alla metoder och komma åt alla egenskaper för HTMLLoader-objektet. Händelsen kan avbrytas och standardbeteendet när den körs i ADL (AIR Debug Launcher) är att skicka JavaScript-stacken till trace-utdata.

Den här händelsen har följande egenskaper:

Relaterade API-element