Skip to content

Commit 7fda166

Browse files
mumumumumumu
committed
[PHP 8.4] Added the Dom namespace with new classes
既存のドキュメントからのリンクはまだ貼っていないので注意。 そのため、マニュアルからはまだ見えません。
1 parent 0523ba2 commit 7fda166

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

71 files changed

+6143
-0
lines changed

‎reference/dom/dom/attr/isid.xml

Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- $Revision$ -->
3+
<!-- EN-Revision: c1f37a6c270aadbbb3da56a3973ffd62197adf2b Maintainer: mumumu Status: ready -->
4+
<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">
5+
<refnamediv>
6+
<refname>Dom\Attr::isId</refname>
7+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domattr.isid')/db:refnamediv/db:refpurpose)"/>
8+
</refnamediv>
9+
10+
<refsect1 role="description">
11+
&reftitle.description;
12+
<methodsynopsis role="Dom\\Attr">
13+
<modifier>public</modifier> <type>bool</type><methodname>Dom\Attr::isId</methodname>
14+
<void/>
15+
</methodsynopsis>
16+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domattr.isid')/db:refsect1[@role='description']/db:para[1])"/>
17+
<simpara>
18+
DOM 標準によれば、属性IDをID型として定義するDTDが必要です。
19+
このメソッドを利用するには、
20+
オプションとして<constant>LIBXML_DTDVALID</constant>を渡して、
21+
解析時にドキュメントを検証する必要があります。
22+
</simpara>
23+
</refsect1>
24+
25+
<refsect1 role="parameters">
26+
&reftitle.parameters;
27+
&no.function.parameters;
28+
</refsect1>
29+
30+
<refsect1 role="returnvalues">
31+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domattr.isid')/db:refsect1[@role='returnvalues']/*)">
32+
<xi:fallback/>
33+
</xi:include>
34+
</refsect1>
35+
36+
<refsect1 role="examples">
37+
&reftitle.examples;
38+
<example>
39+
<title>Dom\Attr::isId() の例</title>
40+
<programlisting role="php">
41+
<![CDATA[
42+
<?php
43+
44+
// idを参照する前にドキュメントを検証する必要があります
45+
$doc = Dom\XMLDocument::createFromFile('examples/book-docbook.xml', LIBXML_DTDVALID);
46+
47+
// chapter要素のidという名前の属性を取得します
48+
$attr = $doc->getElementsByTagName('chapter')->item(0)->getAttributeNode('id');
49+
50+
var_dump($attr->isId()); // bool(true)
51+
52+
?>
53+
]]>
54+
</programlisting>
55+
</example>
56+
</refsect1>
57+
</refentry>
58+
<!-- Keep this comment at the end of the file
59+
Local variables:
60+
mode: sgml
61+
sgml-omittag:t
62+
sgml-shorttag:t
63+
sgml-minimize-attributes:nil
64+
sgml-always-quote-attributes:t
65+
sgml-indent-step:1
66+
sgml-indent-data:t
67+
indent-tabs-mode:nil
68+
sgml-parent-document:nil
69+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
70+
sgml-exposed-tags:nil
71+
sgml-local-catalogs:nil
72+
sgml-local-ecat-files:nil
73+
End:
74+
vim600: syn=xml fen fdm=syntax fdl=2 si
75+
vim: et tw=78 syn=sgml
76+
vi: ts=1 sw=1
77+
-->

‎reference/dom/dom/attr/rename.xml

Lines changed: 171 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,171 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- $Revision$ -->
3+
<!-- EN-Revision: 2c9920402e11ecdc75f604e0d23c23fab1c75b74 Maintainer: mumumu Status: ready -->
4+
<refentry xml:id="dom-attr.rename" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
5+
<refnamediv>
6+
<refname>Dom\Attr::rename</refname>
7+
<refpurpose>属性の修飾名または名前空間を変更します</refpurpose>
8+
</refnamediv>
9+
10+
<refsect1 role="description">
11+
&reftitle.description;
12+
<methodsynopsis role="Dom\\Attr">
13+
<modifier>public</modifier> <type>void</type><methodname>Dom\Attr::rename</methodname>
14+
<methodparam><type class="union"><type>string</type><type>null</type></type><parameter>namespaceURI</parameter></methodparam>
15+
<methodparam><type>string</type><parameter>qualifiedName</parameter></methodparam>
16+
</methodsynopsis>
17+
<simpara>
18+
このメソッドは、属性の修飾名または名前空間を変更します。
19+
</simpara>
20+
</refsect1>
21+
22+
<refsect1 role="parameters">
23+
&reftitle.parameters;
24+
<variablelist>
25+
<varlistentry>
26+
<term><parameter>namespaceURI</parameter></term>
27+
<listitem>
28+
<simpara>
29+
属性の新しい名前空間 <acronym>URI</acronym> です。
30+
</simpara>
31+
</listitem>
32+
</varlistentry>
33+
<varlistentry>
34+
<term><parameter>qualifiedName</parameter></term>
35+
<listitem>
36+
<simpara>
37+
属性の新しい修飾名です。
38+
</simpara>
39+
</listitem>
40+
</varlistentry>
41+
</variablelist>
42+
</refsect1>
43+
44+
<refsect1 role="returnvalues">
45+
&reftitle.returnvalues;
46+
<simpara>
47+
&return.void;
48+
</simpara>
49+
</refsect1>
50+
51+
<refsect1 role="errors">
52+
&reftitle.errors;
53+
<variablelist>
54+
<varlistentry>
55+
<term><constant>Dom\NAMESPACE_ERR</constant> 付きで <classname>DOMException</classname> が発生する場合</term>
56+
<listitem>
57+
<simpara>
58+
<parameter>qualifiedName</parameter> によって決定される名前空間にエラーがある場合に発生します。
59+
</simpara>
60+
</listitem>
61+
</varlistentry>
62+
<varlistentry>
63+
<term><constant>Dom\INVALID_MODIFICATION_ERR</constant> 付きで <classname>DOMException</classname> が発生する場合</term>
64+
<listitem>
65+
<simpara>
66+
同じ修飾名を持つ属性が要素にすでに存在する場合に発生します。
67+
</simpara>
68+
</listitem>
69+
</varlistentry>
70+
</variablelist>
71+
</refsect1>
72+
73+
<refsect1 role="examples">
74+
&reftitle.examples;
75+
<example xml:id="dom-attr.rename.example.basic">
76+
<title><methodname>Dom\Attr::rename</methodname> の例：名前空間と修飾名の両方を変更する</title>
77+
<simpara>
78+
これにより、<literal>my-attr</literal> の修飾名が
79+
<literal>my-new-attr</literal> に変更され、
80+
その名前空間も <literal>urn:my-ns</literal> に変更されます。
81+
</simpara>
82+
<programlisting role="php">
83+
<![CDATA[
84+
<?php
85+
86+
$doc = Dom\XMLDocument::createFromString('<root my-attr="value"/>');
87+
88+
$root = $doc->documentElement;
89+
$attribute = $root->attributes['my-attr'];
90+
$attribute->rename('urn:my-ns', 'my-new-attr');
91+
92+
echo $doc->saveXml();
93+
94+
?>
95+
]]>
96+
</programlisting>
97+
&example.outputs;
98+
<screen>
99+
<![CDATA[
100+
<?xml version="1.0" encoding="UTF-8"?>
101+
<root xmlns:ns1="urn:my-ns" ns1:my-new-attr="value"/>
102+
]]>
103+
</screen>
104+
</example>
105+
<example xml:id="dom-attr.rename.example.only-name">
106+
<title><methodname>Dom\Attr::rename</methodname> の例：修飾名のみを変更する</title>
107+
<simpara>
108+
これにより、<literal>my-attr</literal> の修飾名のみが変更され、名前空間 <acronym>URI</acronym> はそのままになります。
109+
</simpara>
110+
<programlisting role="php">
111+
<![CDATA[
112+
<?php
113+
114+
$doc = Dom\XMLDocument::createFromString('<root my-attr="value"/>');
115+
116+
$root = $doc->documentElement;
117+
$attribute = $root->attributes['my-attr'];
118+
$attribute->rename($attribute->namespaceURI, 'my-new-attr');
119+
120+
echo $doc->saveXml();
121+
122+
?>
123+
]]>
124+
</programlisting>
125+
&example.outputs;
126+
<screen>
127+
<![CDATA[
128+
<?xml version="1.0" encoding="UTF-8"?>
129+
<root my-new-attr="value"/>
130+
]]>
131+
</screen>
132+
</example>
133+
</refsect1>
134+
135+
<refsect1 role="notes">
136+
&reftitle.notes;
137+
<note>
138+
<simpara>
139+
名前空間の規則を壊さないように、修飾名と名前空間 <acronym>URI</acronym> を一度にまとめて変更する必要がある場合があります。
140+
</simpara>
141+
</note>
142+
</refsect1>
143+
144+
<refsect1 role="seealso">
145+
&reftitle.seealso;
146+
<simplelist>
147+
<member><methodname>Dom\Element::rename</methodname></member>
148+
</simplelist>
149+
</refsect1>
150+
151+
</refentry>
152+
<!-- Keep this comment at the end of the file
153+
Local variables:
154+
mode: sgml
155+
sgml-omittag:t
156+
sgml-shorttag:t
157+
sgml-minimize-attributes:nil
158+
sgml-always-quote-attributes:t
159+
sgml-indent-step:1
160+
sgml-indent-data:t
161+
indent-tabs-mode:nil
162+
sgml-parent-document:nil
163+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
164+
sgml-exposed-tags:nil
165+
sgml-local-catalogs:nil
166+
sgml-local-ecat-files:nil
167+
End:
168+
vim600: syn=xml fen fdm=syntax fdl=2 si
169+
vim: et tw=78 syn=sgml
170+
vi: ts=1 sw=1
171+
-->

‎reference/dom/dom/characterdata/after.xml

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- $Revision$ -->
3+
<!-- EN-Revision: 8c0d111851c38647956dc6a4527746787dd606eb Maintainer: mumumu Status: ready -->
4+
<refentry xml:id="dom-characterdata.after" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
5+
<refnamediv>
6+
<refname>Dom\CharacterData::after</refname>
7+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domcharacterdata.after')/db:refnamediv/db:refpurpose)"/>
8+
</refnamediv>
9+
10+
<refsect1 role="description">
11+
&reftitle.description;
12+
<methodsynopsis role="Dom\\CharacterData">
13+
<modifier>public</modifier> <type>void</type><methodname>Dom\CharacterData::after</methodname>
14+
<methodparam rep="repeat"><type class="union"><type>Dom\Node</type><type>string</type></type><parameter>nodes</parameter></methodparam>
15+
</methodsynopsis>
16+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domcharacterdata.after')/db:refsect1[@role='description']/db:para[1])"/>
17+
</refsect1>
18+
19+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domchildnode.after')/db:refsect1[@role='parameters'])" />
20+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domchildnode.after')/db:refsect1[@role='returnvalues'])" />
21+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domchildnode.after')/db:refsect1[@role='errors'])" />
22+
23+
<refsect1 role="examples">
24+
&reftitle.examples;
25+
<example xml:id="dom-characterdata.after.example.basic">
26+
<title><methodname>Dom\CharacterData::after</methodname> の例</title>
27+
<simpara>
28+
文字データの後にノードを追加します。
29+
</simpara>
30+
<programlisting role="php">
31+
<![CDATA[
32+
<?php
33+
$doc = Dom\XMLDocument::createFromString("<container><![CDATA[hello]]]]><![CDATA[></container>");
34+
$cdata = $doc->documentElement->firstChild;
35+
36+
$cdata->after("beautiful", $doc->createElement("world"));
37+
38+
echo $doc->saveXML();
39+
?>
40+
]]>
41+
</programlisting>
42+
&example.outputs;
43+
<screen>
44+
<![CDATA[
45+
<?xml version="1.0" encoding="UTF-8"?>
46+
<container><![CDATA[hello]]]]><![CDATA[>beautiful<world/></container>
47+
]]>
48+
</screen>
49+
</example>
50+
</refsect1>
51+
52+
<refsect1 role="seealso">
53+
&reftitle.seealso;
54+
<simplelist>
55+
<member><methodname>Dom\ChildNode::after</methodname></member>
56+
<member><methodname>Dom\CharacterData::before</methodname></member>
57+
</simplelist>
58+
</refsect1>
59+
60+
</refentry>
61+
<!-- Keep this comment at the end of the file
62+
Local variables:
63+
mode: sgml
64+
sgml-omittag:t
65+
sgml-shorttag:t
66+
sgml-minimize-attributes:nil
67+
sgml-always-quote-attributes:t
68+
sgml-indent-step:1
69+
sgml-indent-data:t
70+
indent-tabs-mode:nil
71+
sgml-parent-document:nil
72+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
73+
sgml-exposed-tags:nil
74+
sgml-local-catalogs:nil
75+
sgml-local-ecat-files:nil
76+
End:
77+
vim600: syn=xml fen fdm=syntax fdl=2 si
78+
vim: et tw=78 syn=sgml
79+
vi: ts=1 sw=1
80+
-->

‎reference/dom/dom/characterdata/appenddata.xml

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- $Revision$ -->
3+
<!-- EN-Revision: 8c0d111851c38647956dc6a4527746787dd606eb Maintainer: mumumu Status: ready -->
4+
<refentry xml:id="dom-characterdata.appenddata" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
5+
<refnamediv>
6+
<refname>Dom\CharacterData::appendData</refname>
7+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domcharacterdata.appenddata')/db:refnamediv/db:refpurpose)"/>
8+
</refnamediv>
9+
10+
<refsect1 role="description">
11+
&reftitle.description;
12+
<methodsynopsis role="Dom\\CharacterData">
13+
<modifier>public</modifier> <type>void</type><methodname>Dom\CharacterData::appendData</methodname>
14+
<methodparam><type>string</type><parameter>data</parameter></methodparam>
15+
</methodsynopsis>
16+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domcharacterdata.appenddata')/db:refsect1[@role='description']/db:para[1])"/>
17+
</refsect1>
18+
19+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domcharacterdata.appenddata')/db:refsect1[@role='parameters'])" />
20+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domcharacterdata.appenddata')/db:refsect1[@role='returnvalues'])" />
21+
22+
<refsect1 role="seealso">
23+
&reftitle.seealso;
24+
<simplelist>
25+
<member><methodname>Dom\CharacterData::deleteData</methodname></member>
26+
<member><methodname>Dom\CharacterData::insertData</methodname></member>
27+
<member><methodname>Dom\CharacterData::replaceData</methodname></member>
28+
<member><methodname>Dom\CharacterData::substringData</methodname></member>
29+
</simplelist>
30+
</refsect1>
31+
32+
</refentry>
33+
<!-- Keep this comment at the end of the file
34+
Local variables:
35+
mode: sgml
36+
sgml-omittag:t
37+
sgml-shorttag:t
38+
sgml-minimize-attributes:nil
39+
sgml-always-quote-attributes:t
40+
sgml-indent-step:1
41+
sgml-indent-data:t
42+
indent-tabs-mode:nil
43+
sgml-parent-document:nil
44+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
45+
sgml-exposed-tags:nil
46+
sgml-local-catalogs:nil
47+
sgml-local-ecat-files:nil
48+
End:
49+
vim600: syn=xml fen fdm=syntax fdl=2 si
50+
vim: et tw=78 syn=sgml
51+
vi: ts=1 sw=1
52+
-->

0 commit comments

Comments
 (0)