Skip to content

Commit 2a392a8

Browse files
jdkfxKentarouTakeda
jdkfx
and
KentarouTakeda
authored
[PHP 8.4] DOMNode::DOCUMENT_*定数とDOMNode::compareDocumentPositionに関する翻訳 (#189)
* DOMNode::DOCUMENT_*定数に関する変更履歴の翻訳 * DOMNode::compareDocumentPosition、DOMNode::DOCUMENT_の英文を追加 * Revisionを追加 * DOCUMENT_POSITION_*定数の翻訳 * EN-Revisionの変更 * DOMNode::compareDocumentPositionの翻訳 * インデントや改行を原文と揃える --------- Co-authored-by: 武田 憲太郎 <[email protected]>
1 parent 2db999a commit 2a392a8

File tree

2 files changed

+237
-3
lines changed

2 files changed

+237
-3
lines changed

‎reference/dom/domnode.xml

Lines changed: 139 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 89ae180a851621c308f0ea4604ff2e919aa57a7f Maintainer: takagi Status: ready -->
3-
<!-- Credits: mumumu -->
2+
<!-- EN-Revision: 4b6c8a5a9469b5c02585618d5a6e0774ca37530f Maintainer: takagi Status: ready -->
3+
<!-- Credits: mumumu,jdkfx -->
44
<reference xml:id="class.domnode" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
55
<title>DOMNode クラス</title>
66
<titleabbrev>DOMNode</titleabbrev>
@@ -25,6 +25,50 @@
2525
<classname>DOMNode</classname>
2626
</ooclass>
2727

28+
<classsynopsisinfo role="comment">&Constants;</classsynopsisinfo>
29+
<fieldsynopsis>
30+
<modifier>public</modifier>
31+
<modifier>const</modifier>
32+
<type>int</type>
33+
<varname linkend="domnode.constants.document-position-disconnected">DOMNode::DOCUMENT_POSITION_DISCONNECTED</varname>
34+
<initializer>1</initializer>
35+
</fieldsynopsis>
36+
<fieldsynopsis>
37+
<modifier>public</modifier>
38+
<modifier>const</modifier>
39+
<type>int</type>
40+
<varname linkend="domnode.constants.document-position-preceding">DOMNode::DOCUMENT_POSITION_PRECEDING</varname>
41+
<initializer>2</initializer>
42+
</fieldsynopsis>
43+
<fieldsynopsis>
44+
<modifier>public</modifier>
45+
<modifier>const</modifier>
46+
<type>int</type>
47+
<varname linkend="domnode.constants.document-position-following">DOMNode::DOCUMENT_POSITION_FOLLOWING</varname>
48+
<initializer>4</initializer>
49+
</fieldsynopsis>
50+
<fieldsynopsis>
51+
<modifier>public</modifier>
52+
<modifier>const</modifier>
53+
<type>int</type>
54+
<varname linkend="domnode.constants.document-position-contains">DOMNode::DOCUMENT_POSITION_CONTAINS</varname>
55+
<initializer>8</initializer>
56+
</fieldsynopsis>
57+
<fieldsynopsis>
58+
<modifier>public</modifier>
59+
<modifier>const</modifier>
60+
<type>int</type>
61+
<varname linkend="domnode.constants.document-position-contained-by">DOMNode::DOCUMENT_POSITION_CONTAINED_BY</varname>
62+
<initializer>16</initializer>
63+
</fieldsynopsis>
64+
<fieldsynopsis>
65+
<modifier>public</modifier>
66+
<modifier>const</modifier>
67+
<type>int</type>
68+
<varname linkend="domnode.constants.document-position-implementation-specific">DOMNode::DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC</varname>
69+
<initializer>32</initializer>
70+
</fieldsynopsis>
71+
2872
<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
2973
<fieldsynopsis>
3074
<modifier>public</modifier>
@@ -140,7 +184,74 @@
140184
<!-- }}} -->
141185

142186
</section>
143-
187+
188+
<section xml:id="domnode.constants">
189+
&reftitle.constants;
190+
<variablelist>
191+
<varlistentry xml:id="domnode.constants.document-position-disconnected">
192+
<term>
193+
<constant>DOMNode::DOCUMENT_POSITION_DISCONNECTED</constant>
194+
</term>
195+
<listitem>
196+
<simpara>
197+
もう一方のノードと参照ノードが同じツリー内にない場合に設定されます。
198+
</simpara>
199+
</listitem>
200+
</varlistentry>
201+
<varlistentry xml:id="domnode.constants.document-position-preceding">
202+
<term>
203+
<constant>DOMNode::DOCUMENT_POSITION_PRECEDING</constant>
204+
</term>
205+
<listitem>
206+
<simpara>
207+
もう一方のノードが参照ノードより前にある場合に設定されます。
208+
</simpara>
209+
</listitem>
210+
</varlistentry>
211+
<varlistentry xml:id="domnode.constants.document-position-following">
212+
<term>
213+
<constant>DOMNode::DOCUMENT_POSITION_FOLLOWING</constant>
214+
</term>
215+
<listitem>
216+
<simpara>
217+
もう一方のノードが参照ノードの後に続く場合に設定されます。
218+
</simpara>
219+
</listitem>
220+
</varlistentry>
221+
<varlistentry xml:id="domnode.constants.document-position-contains">
222+
<term>
223+
<constant>DOMNode::DOCUMENT_POSITION_CONTAINS</constant>
224+
</term>
225+
<listitem>
226+
<simpara>
227+
もう一方のノードが参照ノードの祖先である場合に設定されます。
228+
</simpara>
229+
</listitem>
230+
</varlistentry>
231+
<varlistentry xml:id="domnode.constants.document-position-contained-by">
232+
<term>
233+
<constant>DOMNode::DOCUMENT_POSITION_CONTAINED_BY</constant>
234+
</term>
235+
<listitem>
236+
<simpara>
237+
もう一方のノードが参照ノードの子孫である場合に設定されます。
238+
</simpara>
239+
</listitem>
240+
</varlistentry>
241+
<varlistentry xml:id="domnode.constants.document-position-implementation-specific">
242+
<term>
243+
<constant>DOMNode::DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC</constant>
244+
</term>
245+
<listitem>
246+
<simpara>
247+
結果が実装依存の動作に基づいており、移植性がない場合に設定されます。
248+
これは、同じツリー内にないノードや属性ノードの場合に発生する可能性があります。
249+
</simpara>
250+
</listitem>
251+
</varlistentry>
252+
</variablelist>
253+
</section>
254+
144255
<!-- {{{ DOMNode properties -->
145256
<section xml:id="domnode.props">
146257
&reftitle.properties;
@@ -292,6 +403,31 @@
292403
</row>
293404
</thead>
294405
<tbody>
406+
<row>
407+
<entry>8.4.0</entry>
408+
<entry>
409+
<methodname>DOMNode::compareDocumentPosition</methodname> メソッドが追加されました。
410+
</entry>
411+
</row>
412+
<row>
413+
<entry>8.4.0</entry>
414+
<entry>
415+
以下の定数が新たに追加されました。
416+
<constant>DOMNode::DOCUMENT_POSITION_DISCONNECTED</constant>、
417+
<constant>DOMNode::DOCUMENT_POSITION_PRECEDING</constant>、
418+
<constant>DOMNode::DOCUMENT_POSITION_FOLLOWING</constant>、
419+
<constant>DOMNode::DOCUMENT_POSITION_CONTAINS</constant>、
420+
<constant>DOMNode::DOCUMENT_POSITION_CONTAINED_BY</constant>、および
421+
<constant>DOMNode::DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC</constant>。
422+
</entry>
423+
</row>
424+
<row>
425+
<entry>8.3.0</entry>
426+
<entry>
427+
<methodname>DOMNode::contains</methodname> と、
428+
<methodname>DOMNode::isEqualNode</methodname> というメソッドが追加されました。
429+
</entry>
430+
</row>
295431
<row>
296432
<entry>8.3.0</entry>
297433
<entry>

‎reference/dom/domnode/compareDocumentPosition.xml

Lines changed: 98 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,98 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- $Revision$ -->
3+
<!-- EN-Revision: f1516b33abc82b59d0b8a52b973d64f4857939cc Maintainer: jdkfx Status: ready -->
4+
<!-- CREDITS: jdkfx -->
5+
<refentry xml:id="domnode.comparedocumentposition" xmlns="http://docbook.org/ns/docbook">
6+
<refnamediv>
7+
<refname>DOMNode::compareDocumentPosition</refname>
8+
<refpurpose>2つのノードの位置を比較します。</refpurpose>
9+
</refnamediv>
10+
11+
<refsect1 role="description">
12+
&reftitle.description;
13+
<methodsynopsis role="DOMNode">
14+
<modifier>public</modifier> <type>int</type><methodname>DOMNode::compareDocumentPosition</methodname>
15+
<methodparam><type>DOMNode</type><parameter>other</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>other</parameter></term>
27+
<listitem>
28+
<para>
29+
このノードに対して、位置を比較すべきノード。
30+
</para>
31+
</listitem>
32+
</varlistentry>
33+
</variablelist>
34+
</refsect1>
35+
36+
<refsect1 role="returnvalues">
37+
&reftitle.returnvalues;
38+
<simpara>
39+
<constant>DOMNode::DOCUMENT_POSITION_<replaceable>*</replaceable></constant> 定数のビットマスク。
40+
</simpara>
41+
</refsect1>
42+
43+
<refsect1 role="examples">
44+
&reftitle.examples;
45+
<example>
46+
<title><methodname>DOMNode::compareDocumentPosition</methodname> の例</title>
47+
<programlisting role="php">
48+
<![CDATA[
49+
<?php
50+
$xml = <<<XML
51+
<root>
52+
<child1/>
53+
<child2/>
54+
</root>
55+
XML;
56+
57+
$dom = new DOMDocument();
58+
$dom->loadXML($xml);
59+
60+
$root = $dom->documentElement;
61+
$child1 = $root->firstElementChild;
62+
$child2 = $child1->nextElementSibling;
63+
64+
var_dump($root->compareDocumentPosition($child1));
65+
var_dump($child2->compareDocumentPosition($child1));
66+
?>
67+
]]>
68+
</programlisting>
69+
&example.outputs;
70+
<screen>
71+
<![CDATA[
72+
int(20) // DOMNode::DOCUMENT_POSITION_CONTAINED_BY | DOMNode::DOCUMENT_POSITION_FOLLOWING 定数
73+
int(2) // DOMNode::DOCUMENT_POSITION_PRECEDING 定数
74+
]]>
75+
</screen>
76+
</example>
77+
</refsect1>
78+
</refentry>
79+
<!-- Keep this comment at the end of the file
80+
Local variables:
81+
mode: sgml
82+
sgml-omittag:t
83+
sgml-shorttag:t
84+
sgml-minimize-attributes:nil
85+
sgml-always-quote-attributes:t
86+
sgml-indent-step:1
87+
sgml-indent-data:t
88+
indent-tabs-mode:nil
89+
sgml-parent-document:nil
90+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
91+
sgml-exposed-tags:nil
92+
sgml-local-catalogs:nil
93+
sgml-local-ecat-files:nil
94+
End:
95+
vim600: syn=xml fen fdm=syntax fdl=2 si
96+
vim: et tw=78 syn=sgml
97+
vi: ts=1 sw=1
98+
-->

0 commit comments

Comments
 (0)