Obiekty XML

Flash Player 9 i nowsze wersje, Adobe AIR 1.0 i nowsze wersje

Obiekt XML może reprezentować element XML, atrybut, komentarz, instrukcję przetwarzania lub element tekstowy.

Obiekt XML może zawierać treść prostą albo treść złożoną . Obiekt XML, który ma węzły podrzędne, jest sklasyfikowany jako mający treść złożoną. Obiekt XML ma treść prostą, jeśli jest jednym z następujących obiektów: atrybutem, komentarzem, instrukcją przetwarzania lub węzłem tekstowym.

Na przykład poniższy obiekt XML zawiera treść złożoną, w tym komentarz i instrukcję przetwarzania: 

XML.ignoreComments = false; 
XML.ignoreProcessingInstructions = false; 
var x1:XML =  
    <order> 
        <!--This is a comment. --> 
        <?PROC_INSTR sample ?> 
        <item id='1'> 
            <menuName>burger</menuName> 
            <price>3.95</price> 
        </item> 
        <item id='2'> 
            <menuName>fries</menuName> 
            <price>1.45</price> 
        </item> 
    </order>

Jak widzimy w poniższym przykładzie, można teraz użyć metod comments() i processingInstructions() do utworzenia nowych obiektów XML — komentarza i instrukcji przetwarzania: 

var x2:XML = x1.comments()[0]; 
var x3:XML = x1.processingInstructions()[0];

Właściwości XML

Klasa XML ma pięć właściwości statycznych:

  • Właściwości ignoreComments oraz ignoreProcessingInstructions określają, czy podczas analizowania obiektu XML mają być ignorowane komentarze i/lub instrukcje przetwarzania.

  • Właściwość ignoreWhitespace określa, czy w znacznikach elementów oraz wyrażeniach osadzonych rozdzielonych tylko białymi spacjami mają być ignorowane znaki białych spacji.

  • Właściwości prettyIndent i prettyPrinting służą do formatowania tekstu zwracanego przez metody toString() i toXMLString() klasy XML.

Szczegółowe informacje o tych właściwościach zawiera Skorowidz języka ActionScript 3.0 dla platformy Adobe Flash .

Metody XML

Poniższe metody umożliwiają operowanie na hierarchicznej strukturze obiektów XML:

  • appendChild()

  • child()

  • childIndex()

  • children()

  • descendants()

  • elements()

  • insertChildAfter()

  • insertChildBefore()

  • parent()

  • prependChild()

Poniższe metody umożliwiają operowanie na atrybutach obiektu XML:

  • attribute()

  • attributes()

Poniższe metody umożliwiają operowanie na właściwościach obiektu XML:

  • hasOwnProperty()

  • propertyIsEnumerable()

  • replace()

  • setChildren()

Poniższe metody służą do pracy z nazwami kwalifikowanymi i przestrzeniami nazw:

  • addNamespace()

  • inScopeNamespaces()

  • localName()

  • name()

  • namespace()

  • namespaceDeclarations()

  • removeNamespace()

  • setLocalName()

  • setName()

  • setNamespace()

Poniższe metody służą do operowania na określonych typach treści XML i rozpoznawania ich:

  • comments()

  • hasComplexContent()

  • hasSimpleContent()

  • nodeKind()

  • processingInstructions()

  • text()

Poniższe metody służą do konwertowania danych na ciągi znaków i formatowania obiektów XML:

  • defaultSettings()

  • setSettings()

  • settings()

  • normalize()

  • toString()

  • toXMLString()

Istnieje też kilka dodatkowych metod:

  • contains()

  • copy()

  • valueOf()

  • length()

Szczegółowe informacje o tych metodach zawiera Skorowidz języka ActionScript 3.0 dla platformy Adobe Flash .