Объекты XML

Flash Player 9 и более поздних версий, Adobe AIR 1.0 и более поздних версий

Объект XML может представлять элемент, атрибут, комментарий, оператор обработки или текстовый элемент.

Выделяют два класса объектов XML: с простым содержимым и со сложным содержимым . Объект XML, имеющий дочерние узлы, относится к классу с простым содержимым. Объект XML имеет простое содержимое, если он является одним из следующего: атрибутом, комментарием, оператором обработки или текстовым узлом.

Например, следующий объект XML содержит сложное содержимое, в том числе комментарий и инструкцию обработки: 

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>

Как видно из следующего примера, теперь для создания новых объектов XML, комментария и инструкции обработки можно использовать методы comments() и processingInstructions() : 

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

Свойства XML

Класс XML имеет пять статических свойств.

  • Свойства ignoreComments и ignoreProcessingInstructions определяют, что игнорируется при синтаксическом анализе объекта XML — комментарии или инструкции обработки.

  • Свойство ignoreWhitespace определяет необходимость игнорирования в тегах элемента символов пробела и внедрения выражений, разделенных только символами пробела.

  • Свойства prettyIndent и prettyPrinting используются для форматирования текста, возвращенного методами toString() и toXMLString() класса XML.

Дополнительные сведения об этих свойствах см. в справочнике ActionScript® 3.0 для платформы ® Flash® Platform .

Методы XML

Следующие методы позволяют работать с иерархической структурой объектов XML:

  • appendChild()

  • child()

  • childIndex()

  • children()

  • descendants()

  • elements()

  • insertChildAfter()

  • insertChildBefore()

  • parent()

  • prependChild()

Следующие методы позволяют работать с атрибутами объектов XML:

  • attribute()

  • attributes()

Следующие методы позволяют работать со свойствами объектов XML:

  • hasOwnProperty()

  • propertyIsEnumerable()

  • replace()

  • setChildren()

Следующие методы предназначены для работы с уточненными именами и пространствами имен:

  • addNamespace()

  • inScopeNamespaces()

  • localName()

  • name()

  • namespace()

  • namespaceDeclarations()

  • removeNamespace()

  • setLocalName()

  • setName()

  • setNamespace()

Следующие методы предназначены для работы с определенными типами XML-содержимого и для его определения:

  • comments()

  • hasComplexContent()

  • hasSimpleContent()

  • nodeKind()

  • processingInstructions()

  • text()

Следующие методы предназначены для преобразования в строки и для форматирования объектов XML:

  • defaultSettings()

  • setSettings()

  • settings()

  • normalize()

  • toString()

  • toXMLString()

Далее представлено несколько дополнительных методов:

  • contains()

  • copy()

  • valueOf()

  • length()

Дополнительные сведения об этих методах см. в cправочнике ActionScript® 3.0 для платформы Adobe® Flash® Platform .