VladPolskiy/php-doc-ru
1
0
Fork 0
mirror of https://github.com/php/doc-ru.git synced 2025-07-30 12:57:40 +00:00
Code Issues Packages Projects Releases Wiki Activity

Добавление перевода

Browse Source
This commit is contained in:
Sergey Panteleev
2024-12-15 18:10:32 +03:00
parent 9476a4ffea
commit efb59de0e6
13 changed files with 1086 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

75
reference/dom/dom/attr/isid.xml Normal file
View File

@ -0,0 +1,75 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 2c9920402e11ecdc75f604e0d23c23fab1c75b74 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="dom-attr.isid" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<refnamediv>
<refname>Dom\Attr::isId</refname>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domattr.isid')/db:refnamediv/db:refpurpose)"/>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="Dom\\Attr">
<modifier>public</modifier> <type>bool</type><methodname>Dom\Attr::isId</methodname>
<void/>
</methodsynopsis>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domattr.isid')/db:refsect1[@role='description']/db:para[1])"/>
<simpara>
Согласно стандарту DOM, для этого требуется DTD, в котором атрибут ID определяется как тип ID.
Чтобы использовать метод, документ должен быть проверен во время разбора
путём передачи <constant>LIBXML_DTDVALID</constant> в качестве опции.
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>
<refsect1 role="returnvalues">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domattr.isid')/db:refsect1[@role='returnvalues']/*)">
<xi:fallback/>
</xi:include>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Пример использования Dom\Attr::isId()</title>
<programlisting role="php">
<![CDATA[
<?php
// Необходимо подтвердить документ, прежде чем ссылаться на id
$doc = Dom\XMLDocument::createFromFile('book.xml', LIBXML_DTDVALID);
// Получение атрибута id элемента chapter
$attr = $doc->getElementsByTagName('chapter')->item(0)->getAttributeNode('id');
var_dump($attr->isId()); // bool(true)
?>
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

174
reference/dom/dom/attr/rename.xml Normal file
View File

@ -0,0 +1,174 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 2c9920402e11ecdc75f604e0d23c23fab1c75b74 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="dom-attr.rename" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Dom\Attr::rename</refname>
<refpurpose>Изменяет квалифицированное имя или пространство имён атрибута</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="Dom\\Attr">
<modifier>public</modifier> <type>void</type><methodname>Dom\Attr::rename</methodname>
<methodparam><type class="union"><type>string</type><type>null</type></type><parameter>namespaceURI</parameter></methodparam>
<methodparam><type>string</type><parameter>qualifiedName</parameter></methodparam>
</methodsynopsis>
<simpara>
Метод изменяет квалифицированное имя или пространство имён атрибута
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
<term><parameter>namespaceURI</parameter></term>
<listitem>
<simpara>
Новое пространство имён атрибута <acronym>URI</acronym>.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>qualifiedName</parameter></term>
<listitem>
<simpara>
Новое квалифицированное имя атрибута.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
&return.void;
</simpara>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<variablelist>
<varlistentry>
<term><classname>DOMException</classname> с кодом <constant>Dom\NAMESPACE_ERR</constant></term>
<listitem>
<simpara>
Возникает в случае ошибки с пространством имён,
определяемым параметром <parameter>qualifiedName</parameter>.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><classname>DOMException</classname> с кодом <constant>Dom\INVALID_MODIFICATION_ERR</constant></term>
<listitem>
<simpara>
Возникает в случае если в элементе уже существует атрибут
с таким же квалифицированным именем.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example xml:id="dom-attr.rename.example.basic">
<title>Пример использования метода <methodname>Dom\Attr::rename</methodname>, чтобы изменить пространство имён и квалифицированное имя</title>
<simpara>
Это изменяет квалифицированное имя <literal>my-attr</literal> на <literal>my-new-attr</literal>,
а также изменяет его пространство имён на <literal>urn:my-ns</literal>.
</simpara>
<programlisting role="php">
<![CDATA[
<?php
$doc = Dom\XMLDocument::createFromString('<root my-attr="value"/>');
$root = $doc->documentElement;
$attribute = $root->attributes['my-attr'];
$attribute->rename('urn:my-ns', 'my-new-attr');
echo $doc->saveXml();
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<root xmlns:ns1="urn:my-ns" ns1:my-new-attr="value"/>
]]>
</screen>
</example>
<example xml:id="dom-attr.rename.example.only-name">
<title>Пример использования <methodname>Dom\Attr::rename</methodname>, чтобы изменить только квалифицированное имя</title>
<simpara>
При этом изменяется только квалифицированное имя <literal>my-attr</literal>,
а пространство имён <acronym>URI</acronym> остается прежним.
</simpara>
<programlisting role="php">
<![CDATA[
<?php
$doc = Dom\XMLDocument::createFromString('<root my-attr="value"/>');
$root = $doc->documentElement;
$attribute = $root->attributes['my-attr'];
$attribute->rename($attribute->namespaceURI, 'my-new-attr');
echo $doc->saveXml();
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<root my-new-attr="value"/>
]]>
</screen>
</example>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<simpara>
Иногда необходимо изменить квалифицированное имя и пространство имён <acronym>URI</acronym> в один приём,
чтобы не нарушить правила пространства имён.
</simpara>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><methodname>Dom\Element::rename</methodname></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

61
reference/dom/dom/dom-nodelist.xml Normal file
View File

@ -0,0 +1,61 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8008e101d6e725ad8050a09a02bbb4492dc2b9fe Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.dom-nodelist" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Класс <classname>Dom\NodeList</classname></title>
<titleabbrev>Dom\NodeList</titleabbrev>
<partintro>
<section xml:id="dom-nodelist.intro">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domnodelist.intro')/*)">
<xi:fallback/>
</xi:include>
<simpara>
Современный, соответствующий спецификации аналог класса
<classname>DOMNodeList</classname>.
</simpara>
</section>
<section xml:id="dom-nodelist.synopsis">
&reftitle.classsynopsis;
<classsynopsis class="class">
<ooclass>
<classname>Dom\NodeList</classname>
</ooclass>
<oointerface>
<modifier>implements</modifier>
<interfacename>IteratorAggregate</interfacename>
</oointerface>
<oointerface>
<interfacename>Countable</interfacename>
</oointerface>
<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type>int</type>
<varname linkend="dom-nodelist.props.length">length</varname>
</fieldsynopsis>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<classsynopsisinfo role="comment">Пока не документировано</classsynopsisinfo>
</classsynopsis>
</section>
<section xml:id="dom-nodelist.props">
&reftitle.properties;
<variablelist>
<varlistentry xml:id="dom-nodelist.props.length">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domnodelist.props.length')/*)">
<xi:fallback/>
</xi:include>
</varlistentry>
</variablelist>
</section>
</partintro>
</reference>

69
reference/dom/dom/dom-notation.xml Normal file
View File

@ -0,0 +1,69 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8008e101d6e725ad8050a09a02bbb4492dc2b9fe Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.dom-notation" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Класс Dom\Notation</title>
<titleabbrev>Dom\Notation</titleabbrev>
<partintro>
<section xml:id="dom-notation.synopsis">
&reftitle.classsynopsis;
<classsynopsis class="class">
<ooclass>
<classname>Dom\Notation</classname>
</ooclass>
<ooclass>
<modifier>extends</modifier>
<classname>Dom\Node</classname>
</ooclass>
<classsynopsisinfo role="comment">&InheritedConstants;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-node')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Constants;']]))">
<xi:fallback/>
</xi:include>
<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type>string</type>
<varname linkend="dom-notation.props.publicid">publicId</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type>string</type>
<varname linkend="dom-notation.props.systemid">systemId</varname>
</fieldsynopsis>
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-node')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
<xi:fallback/>
</xi:include>
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<classsynopsisinfo role="comment">Пока не документировано</classsynopsisinfo>
</classsynopsis>
</section>
<section xml:id="dom-notation.props">
&reftitle.properties;
<variablelist>
<varlistentry xml:id="dom-notation.props.publicid">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domnotation.props.publicid')/*)">
<xi:fallback/>
</xi:include>
</varlistentry>
<varlistentry xml:id="dom-notation.props.systemid">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domnotation.props.systemid')/*)">
<xi:fallback/>
</xi:include>
</varlistentry>
</variablelist>
</section>
</partintro>
</reference>

38
reference/dom/dom/dom-parentnode.xml Normal file
View File

@ -0,0 +1,38 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e64de8beed5f6e44e02cd36b907fba7aa38f1c84 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.dom-parentnode" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Интерфейс Dom\ParentNode</title>
<titleabbrev>Dom\ParentNode</titleabbrev>
<partintro>
<section xml:id="dom-parentnode.intro">
&reftitle.intro;
<simpara>
Современный, соответствующий спецификации аналог класса
<classname>DOMParentNode</classname>.
</simpara>
</section>
<section xml:id="dom-parentnode.synopsis">
&reftitle.interfacesynopsis;
<classsynopsis class="interface">
<oointerface>
<interfacename>Dom\ParentNode</interfacename>
</oointerface>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-parentnode')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Dom\\ParentNode'])">
<xi:fallback/>
</xi:include>
</classsynopsis>
</section>
</partintro>
&reference.dom.dom.entities.parentnode;
</reference>

75
reference/dom/dom/dom-processinginstruction.xml Normal file
View File

@ -0,0 +1,75 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8008e101d6e725ad8050a09a02bbb4492dc2b9fe Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.dom-processinginstruction" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Класс Dom\ProcessingInstruction</title>
<titleabbrev>Dom\ProcessingInstruction</titleabbrev>
<partintro>
<section xml:id="dom-processinginstruction.intro">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domprocessinginstruction.intro')/*)">
<xi:fallback/>
</xi:include>
<simpara>
Современный, соответствующий спецификации аналог класса
<classname>DOMProcessingInstruction</classname>.
</simpara>
</section>
<section xml:id="dom-processinginstruction.synopsis">
&reftitle.classsynopsis;
<classsynopsis class="class">
<ooclass>
<classname>Dom\ProcessingInstruction</classname>
</ooclass>
<ooclass>
<modifier>extends</modifier>
<classname>Dom\CharacterData</classname>
</ooclass>
<classsynopsisinfo role="comment">&InheritedConstants;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-node')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Constants;']]))">
<xi:fallback/>
</xi:include>
<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type>string</type>
<varname linkend="dom-processinginstruction.props.target">target</varname>
</fieldsynopsis>
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-characterdata')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-node')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
<xi:fallback/>
</xi:include>
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-characterdata')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Dom\\CharacterData'])">
<xi:fallback/>
</xi:include>
<classsynopsisinfo role="comment">Пока не документировано</classsynopsisinfo>
</classsynopsis>
</section>
<section xml:id="dom-processinginstruction.props">
&reftitle.properties;
<variablelist>
<varlistentry xml:id="dom-processinginstruction.props.target">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domprocessinginstruction.props.target')/*)">
<xi:fallback/>
</xi:include>
</varlistentry>
</variablelist>
</section>
</partintro>
</reference>

84
reference/dom/dom/dom-text.xml Normal file
View File

@ -0,0 +1,84 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8008e101d6e725ad8050a09a02bbb4492dc2b9fe Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.dom-text" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Класс Dom\Text</title>
<titleabbrev>Dom\Text</titleabbrev>
<partintro>
<section xml:id="dom-text.intro">
&reftitle.intro;
<simpara>
Класс <classname>Dom\Text</classname> наследует
класс <classname>Dom\CharacterData</classname> и представляет текстовый узел.
</simpara>
<simpara>
Современный, соответствующий спецификации аналог класса
<classname>DOMText</classname>.
</simpara>
</section>
<section xml:id="dom-text.synopsis">
&reftitle.classsynopsis;
<classsynopsis class="class">
<ooclass>
<classname>Dom\Text</classname>
</ooclass>
<ooclass>
<modifier>extends</modifier>
<classname>Dom\CharacterData</classname>
</ooclass>
<classsynopsisinfo role="comment">&InheritedConstants;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-node')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Constants;']]))">
<xi:fallback/>
</xi:include>
<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type>string</type>
<varname linkend="dom-text.props.wholetext">wholeText</varname>
</fieldsynopsis>
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-characterdata')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-node')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
<xi:fallback/>
</xi:include>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-text')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Dom\\Text'])">
<xi:fallback/>
</xi:include>
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-characterdata')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Dom\\CharacterData'])">
<xi:fallback/>
</xi:include>
<classsynopsisinfo role="comment">Пока не документировано</classsynopsisinfo>
</classsynopsis>
</section>
<section xml:id="dom-text.props">
&reftitle.properties;
<variablelist>
<varlistentry xml:id="dom-text.props.wholetext">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domtext.props.wholetext')/*)">
<xi:fallback/>
</xi:include>
</varlistentry>
</variablelist>
</section>
</partintro>
&reference.dom.dom.entities.text;
</reference>

78
reference/dom/dom/dom-tokenlist.xml Normal file
View File

@ -0,0 +1,78 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ebbc5bb97c8c063d31309725c0bb93d21213993b Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.dom-tokenlist" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Класс Dom\TokenList</title>
<titleabbrev>Dom\TokenList</titleabbrev>
<partintro>
<section xml:id="dom-tokenlist.intro">
&reftitle.intro;
<simpara>
Представляет собой набор лексем в атрибуте (например, имена классов).
</simpara>
</section>
<section xml:id="dom-tokenlist.synopsis">
&reftitle.classsynopsis;
<classsynopsis class="class">
<ooclass>
<modifier>final</modifier>
<classname>Dom\TokenList</classname>
</ooclass>
<oointerface>
<modifier>implements</modifier>
<interfacename>IteratorAggregate</interfacename>
</oointerface>
<oointerface>
<interfacename>Countable</interfacename>
</oointerface>
<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type>int</type>
<varname linkend="dom-tokenlist.props.length">length</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<type>string</type>
<varname linkend="dom-tokenlist.props.value">value</varname>
</fieldsynopsis>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<classsynopsisinfo role="comment">Пока не документировано</classsynopsisinfo>
</classsynopsis>
</section>
<section xml:id="dom-tokenlist.props">
&reftitle.properties;
<variablelist>
<varlistentry xml:id="dom-tokenlist.props.length">
<term><varname>length</varname></term>
<listitem>
<simpara>Количество токенов.</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="dom-tokenlist.props.value">
<term><varname>value</varname></term>
<listitem>
<simpara>Значение атрибута, связанного с этим объектом.</simpara>
</listitem>
</varlistentry>
</variablelist>
</section>
<section role="notes">
&reftitle.notes;
&dom.note.modern.utf8;
</section>
</partintro>
</reference>

117
reference/dom/dom/dom-xmldocument.xml Normal file
View File

@ -0,0 +1,117 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 5ddcf0969ce5f8f57fb169521a0b86a231c42b1c Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.dom-xmldocument" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Класс Dom\XMLDocument</title>
<titleabbrev>Dom\XMLDocument</titleabbrev>
<partintro>
<section xml:id="dom-xmldocument.intro">
&reftitle.intro;
<simpara>
Представляет документ <acronym>XML</acronym>.
</simpara>
</section>
<section xml:id="dom-xmldocument.synopsis">
&reftitle.classsynopsis;
<classsynopsis class="class">
<ooclass>
<modifier>final</modifier>
<classname>Dom\XMLDocument</classname>
</ooclass>
<ooclass>
<modifier>extends</modifier>
<classname>Dom\Document</classname>
</ooclass>
<classsynopsisinfo role="comment">&InheritedConstants;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-node')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Constants;']]))">
<xi:fallback/>
</xi:include>
<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type>string</type>
<varname linkend="dom-xmldocument.props.xmlencoding">xmlEncoding</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<type>bool</type>
<varname linkend="dom-xmldocument.props.xmlstandalone">xmlStandalone</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<type>string</type>
<varname linkend="dom-xmldocument.props.xmlversion">xmlVersion</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<type>bool</type>
<varname linkend="dom-xmldocument.props.formatoutput">formatOutput</varname>
</fieldsynopsis>
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-document')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-node')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
<xi:fallback/>
</xi:include>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<classsynopsisinfo role="comment">Пока не документировано</classsynopsisinfo>
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<classsynopsisinfo role="comment">Пока не документировано</classsynopsisinfo>
</classsynopsis>
</section>
<section xml:id="dom-xmldocument.props">
&reftitle.properties;
<note>
<simpara>
В то время как класс <classname>DOMDocument</classname> позволяет
задавать определённые свойства для влияния на поведение парсера,
этот класс использует только констант
<constant>LIBXML_<replaceable>*</replaceable></constant> для настройки парсера.
</simpara>
</note>
<variablelist>
<varlistentry xml:id="dom-xmldocument.props.xmlencoding">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domdocument.props.xmlencoding')/*)">
<xi:fallback/>
</xi:include>
</varlistentry>
<varlistentry xml:id="dom-xmldocument.props.xmlstandalone">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domdocument.props.xmlstandalone')/*)">
<xi:fallback/>
</xi:include>
</varlistentry>
<varlistentry xml:id="dom-xmldocument.props.xmlversion">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domdocument.props.xmlversion')/*)">
<xi:fallback/>
</xi:include>
</varlistentry>
<varlistentry xml:id="dom-xmldocument.props.formatoutput">
<term><varname>formatOutput</varname></term>
<listitem>
<simpara>Прекрасно форматирует вывод с отступами и дополнительными пробелами.</simpara>
</listitem>
</varlistentry>
</variablelist>
</section>
<section role="notes">
&reftitle.notes;
&dom.note.modern.utf8;
</section>
</partintro>
</reference>

65
reference/dom/dom/dom-xpath.xml Normal file
View File

@ -0,0 +1,65 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8008e101d6e725ad8050a09a02bbb4492dc2b9fe Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.dom-xpath" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Класс Dom\XPath</title>
<titleabbrev>Dom\XPath</titleabbrev>
<partintro>
<section xml:id="dom-xpath.intro">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domxpath.intro')/*)">
<xi:fallback/>
</xi:include>
<simpara>
Современный, соответствующий спецификации аналог класса
<classname>DOMXPath</classname>.
</simpara>
</section>
<section xml:id="dom-xpath.synopsis">
&reftitle.classsynopsis;
<classsynopsis class="class">
<ooclass>
<modifier>final</modifier>
<classname>Dom\XPath</classname>
</ooclass>
<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type>Dom\Document</type>
<varname linkend="dom-xpath.props.document">document</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<type>bool</type>
<varname linkend="dom-xpath.props.registernodenamespaces">registerNodeNamespaces</varname>
</fieldsynopsis>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<classsynopsisinfo role="comment">Пока не документировано</classsynopsisinfo>
</classsynopsis>
</section>
<section xml:id="dom-xpath.props">
&reftitle.properties;
<variablelist>
<varlistentry xml:id="dom-xpath.props.document">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domxpath.props.document')/*)">
<xi:fallback/>
</xi:include>
</varlistentry>
<varlistentry xml:id="dom-xpath.props.registernodenamespaces">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domxpath.props.registernodenamespaces')/*)">
<xi:fallback/>
</xi:include>
</varlistentry>
</variablelist>
</section>
</partintro>
</reference>

61
reference/dom/dom/parentnode/queryselectorall.xml Normal file
View File

@ -0,0 +1,61 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e64de8beed5f6e44e02cd36b907fba7aa38f1c84 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="dom-parentnode.queryselectorall" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
<refnamediv>
<refname>Dom\ParentNode::querySelectorAll</refname>
<refpurpose>Возвращает коллекцию элементов, соответствующих селекторам CSS</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="Dom\\ParentNode">
<modifier>public</modifier> <type>Dom\NodeList</type><methodname>Dom\ParentNode::querySelectorAll</methodname>
<methodparam><type>string</type><parameter>selectors</parameter></methodparam>
</methodsynopsis>
<simpara>
Возвращает коллекцию элементов, соответствующих CSS-селекторам, указанным
в параметре <parameter>selectors</parameter>.
</simpara>
</refsect1>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('dom-parentnode.queryselector')/db:refsect1[@role='parameters'])" />
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
Возвращает статическую коллекцию элементов, которые соответствуют CSS-селекторам,
указанным в параметре <parameter>selectors</parameter>.
</simpara>
</refsect1>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('dom-parentnode.queryselector')/db:refsect1[@role='errors'])" />
<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><methodname>Dom\ParentNode::querySelector</methodname></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

94
reference/dom/functions/dom-ns-import-simplexml.xml Normal file
View File

@ -0,0 +1,94 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c82f29b65c2cf108e7ade2c5558af0de5cc64b53 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.dom-ns-import-simplexml" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
<refnamediv>
<refname>Dom\import_simplexml</refname>
<refpurpose>
Получает объект класса <classname>Dom\Attr</classname> или <classname>Dom\Element</classname>
из объекта <classname>SimpleXMLElement</classname>
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>Dom\Attr</type><type>Dom\Element</type></type><methodname>Dom\import_simplexml</methodname>
<methodparam><type>object</type><parameter>node</parameter></methodparam>
</methodsynopsis>
<simpara>
Функция принимает заданный атрибут или элемент <parameter>node</parameter>
(экземпляр <classname>SimpleXMLElement</classname>) и создаёт узел <classname>Dom\Attr</classname>
или <classname>Dom\Element</classname>, соответственно.
Новый узел <classname>Dom\Node</classname> ссылается на тот же базовый узел XML,
что и <classname>SimpleXMLElement</classname>.
</simpara>
</refsect1>
<refsect1 role="parameters">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.dom-import-simplexml')/db:refsect1[@role='parameters']/*)">
<xi:fallback/>
</xi:include>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
Функция возвращает объект класса <classname>Dom\Attr</classname> или <classname>Dom\Element</classname>.
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Импорт SimpleXML в DOM и изменение SimpleXML с помощью DOM</title>
<simpara>
Обработка ошибок опущена для краткости.
</simpara>
<programlisting role="php">
<![CDATA[
<?php
$sxe = simplexml_load_string('<books><book><title>blah</title></book></books>');
$elt = Dom\import_simplexml($sxe);
$elt->setAttribute("foo", "bar");
echo $sxe->asXML();
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
<?xml version="1.0"?>
<books foo="bar"><book><title>blah</title></book></books>
]]>
</screen>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><function>simplexml_import_dom</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->