spec-ja/data/documents.dat

#pattern
<span class=secno>* </span>Semantics and structure of HTML
   documents
#ja
<span class=secno>$1 </span>HTML 文書の意味と構造

#pattern
<span class=secno>* </span>Documents
#ja
<span class=secno>$1 </span>文書

#en
Every XML and HTML document in an HTML UA is represented by a
   <code>Document</code> object. <a href="#refsDOM3CORE">[DOM3CORE]</a>
#ja
HTML 利用者エージェントにおけるすべての XML や HTML の文書は
<code>Document</code> オブジェクトにより表現されます。 <a href="#refsDOM3CORE">[DOM3CORE]</a>

#pattern
<span class=secno>* </span>Documents in the DOM
#ja
<span class=secno>$1 </span>DOM 中の文書

#en
<code>Document</code> objects are assumed to be <dfn
   id=xml-documents>XML documents</dfn> unless they are flagged as being <dfn
   id=html->HTML documents</dfn> when they are created. Whether a document is
   an <a href="#html-" title="HTML documents">HTML document</a> or an <a
   href="#xml-documents" title="XML documents">XML document</a> affects the
   behavior of certain APIs, as well as a few CSS rendering rules. <a
   href="#refsCSS21">[CSS21]</a>
#ja
<code>Document</code> オブジェクトは、作成された時に
<dfn
   id=html->HTML 文書</dfn>であると旗付けされていなければ、 <dfn
   id=xml-documents>XML 文書</dfn>であると見なします。
文書が <a href="#html-" title="HTML documents">HTML 文書</a>であるか <a
   href="#xml-documents" title="XML documents">XML 文書</a>であるかは、
いくつかの API の動作や CSS のレンダリング規則の一部に影響します。 <a
   href="#refsCSS21">[CSS21]</a>

#en
A <code>Document</code> object created by the <code
   title="">createDocument()</code> API on the <code>DOMImplementation</code>
   object is initially an <a href="#xml-documents" title="XML documents">XML
   document</a>, but can be made into an <a href="#html-" title="HTML
   documents">HTML document</a> by calling <code title=dom-document-open><a
   href="#open">document.open()</a></code> on it.
#ja
<code>DOMImplementation</code> 上の <code
   title="">createDocument()</code> API により作成された <code>Document</code>
オブジェクトははじめ <a href="#xml-documents" title="XML documents">XML
   文書</a>ですが、 <code title=dom-document-open><a
   href="#open">document.open()</a></code>
を呼び出すことにより <a href="#html-" title="HTML
   documents">HTML 文書</a>にすることができます。

#en
All <code>Document</code> objects (in user agents implementing this
   specification) must also implement the <code><a
   href="#htmldocument">HTMLDocument</a></code> interface, available using
   binding-specific methods. (This is the case whether or not the document in
   question is an <a href="#html-" title="HTML documents">HTML document</a>
   or indeed whether it contains any <a href="#html-elements">HTML
   elements</a> at all.) <code>Document</code> objects must also implement
   the document-level interface of any other namespaces found in the document
   that the UA supports. For example, if an HTML implementation also supports
   SVG, then the <code>Document</code> object must implement <code><a
   href="#htmldocument">HTMLDocument</a></code> and <code>SVGDocument</code>.
#ja
(この仕様書を実装する利用書エージェントにおける) すべての
<code>Document</code>
オブジェクトは、 <code><a
   href="#htmldocument">HTMLDocument</a></code> 界面をも実装し、
束縛規定の方式により利用可能としなければ[[MUST:なりません]]。
(これは当該文書が <a href="#html-" title="HTML documents">HTML 文書</a>であるか否かや、
そもそも <a href="#html-elements">HTML
   要素</a>を含んでいるか否かによらずのことです。)
<code>Document</code> オブジェクトは、文書中に現れ、利用者エージェントが対応している、
他の名前空間の文書水準の界面をも実装しなければ[[MUST:なりません]]。
例えば、 HTML 実装が SVG にも対応している場合、 <code>Document</code>
オブジェクトは <code><a
   href="#htmldocument">HTMLDocument</a></code> と
<code>SVGDocument</code> を実装しなければなりません<!-- 例示なので MUST でなく must -->。

#en
Because the <code><a
   href="#htmldocument">HTMLDocument</a></code> interface is now obtained
   using binding-specific casting methods instead of simply being the primary
   interface of the document object, it is no longer defined as inheriting
   from <code>Document</code>.
#ja
<code><a
   href="#htmldocument">HTMLDocument</a></code> 
界面は現在では単純に文書オブジェクトの主たる界面であるとするのではなく、
束縛規定の型変換方式を使って得るものとしているので、
最早 <code>Document</code> から継承するとは定義していません。

#en
Since the <code><a href="#htmldocument">HTMLDocument</a></code>
   interface holds methods and attributes related to a number of disparate
   features, the members of this interface are described in various different
   sections.
#ja
<code><a href="#htmldocument">HTMLDocument</a></code>
界面は色々な機能に関係するメソッドや属性を持っていますので、
この界面の構成員はそれぞれの節で説明します。

#en
User agents must raise a <a href="#security10">security exception</a>
   whenever any of the members of an <code><a
   href="#htmldocument">HTMLDocument</a></code> object are accessed by
   scripts whose <a href="#effective3">effective script origin</a> is not the
   <a href="#same-origin" title="same origin">same</a> as the
   <code>Document</code>'s <a href="#effective3">effective script origin</a>.
#ja
利用者エージェントは、 <code><a
   href="#htmldocument">HTMLDocument</a></code>
オブジェクトの構成員のいずれかが、
<a href="#effective3">実効スクリプト起源</a>が <code>Document</code>
の<a href="#effective3">実効スクリプト起源</a>と<a href="#same-origin" title="same origin">同じ</a>ではないスクリプトからアクセスされる場合に、
常に、
<a href="#security10">保安性例外</a>を発生させなければ[[MUST:なりません]]。

#pattern
<span class=secno>* </span><dfn id=resource0>Resource
   metadata management</dfn>
#ja
<span class=secno>$1 </span><dfn id=resource0>資源メタデータ管理</dfn>

#en
The <dfn id=url0 title=dom-document-URL><code>URL</code></dfn> attribute
   must return <span>the document's address</span><!--
  XXXDOCURL xref -->.
#ja
<dfn id=url0 title=dom-document-URL><code>URL</code></dfn>
属性は<span>文書の番地</span><!--
  XXXDOCURL xref -->を返さなければ[[MUST:なりません]]。

#en
The <dfn id=referrer
   title=dom-document-referrer><code>referrer</code></dfn> attribute must
   return either the <span title="the document's
   address">address</span><!-- XXXDOXURL xref --> of the <a
   href="#active">active document</a> of the <a href="#source0">source
   browsing context</a> at the time the navigation was started (that is, the
   page which <a href="#navigate" title=navigate>navigated</a> the <a
   href="#browsing1">browsing context</a> to the current document), or the
   empty string if there is no such originating page, or if the UA has been
   configured not to report referrers in this case, or if the navigation was
   initiated for a <a href="#hyperlinks">hyperlink</a> with a <code
   title=rel-noreferrer><a href="#noreferrer">noreferrer</a></code> keyword.
#ja
<dfn id=referrer
   title=dom-document-referrer><code>referrer</code></dfn> 
属性は、操縦が開始された時点での<a href="#source0">原始閲覧文脈</a>の<a
   href="#active">活性文書</a>
(<a
   href="#browsing1">閲覧文脈</a>を現在の文書に<a href="#navigate" title=navigate>操縦</a>した頁)
の<span title="the document's
   address">番地</span><!-- XXXDOXURL xref -->か、
または、そのような元々の頁がない場合、利用者エージェントがこの場合に参照子を報告しないように設定されている場合、
操縦が <code
   title=rel-noreferrer><a href="#noreferrer">noreferrer</a></code>
キーワードのある<a href="#hyperlinks">ハイパーリンク</a>について初期化された場合には空文字列、
このいずれかを返さなければ[[MUST:なりません]]。


#en
In the case of HTTP, the <code title=dom-document-referrer><a
   href="#referrer">referrer</a></code> DOM attribute will match the <code
   title="">Referer</code> (sic) header that was sent when <a href="#fetch"
   title=fetch>fetching</a> the current page.
#ja
HTTP の場合、 <code title=dom-document-referrer><a
   href="#referrer">referrer</a></code> DOM 属性は現在の頁を<a href="#fetch"
   title=fetch>取ってくる</a>時に送られた <code
   title="">Referer</code> (ママ) 頭部と一致します。

#en
Typically user agents are configured to not report referrers
   in the case where the referrer uses an encrypted protocol and the current
   page does not (e.g. when navigating from an <code title="">https:</code>
   page to an <code title="">http:</code> page).
#ja
通常、利用者エージェントは、参照子が暗号化プロトコルを使っており、
現在の頁がそうではない場合 (例えば <code title="">https:</code>
頁から <code title="">http:</code> 頁へと操縦した時)
には参照子を報告しないように設定されています。

#en
The <dfn id=cookie0 title=dom-document-cookie><code>cookie</code></dfn>
   attribute represents the cookies of the resource.
#ja
<dfn id=cookie0 title=dom-document-cookie><code>cookie</code></dfn>
属性は、資源のクッキーを表します。

#en
On getting, if the <a href="#sandboxed2">sandboxed
   origin browsing context flag</a> is set on the <a
   href="#browsing1">browsing context</a> of the document, the user agent
   must raise a <a href="#security10">security exception</a>. Otherwise, it
   must return the same string as the value of the <code
   title="">Cookie</code> HTTP header it would include if <a href="#fetch"
   title=fetch>fetching</a> the resource indicated by <span>the document's
   address</span><!-- XXXDOCURL --> over HTTP, as per RFC 2109 section 4.3.4
   or later specifications. <a href="#refsRFC2109">[RFC2109]</a> <a
   href="#refsRFC2965">[RFC2965]</a>
#ja
取得時、<a href="#sandboxed2">砂箱起源閲覧文脈旗</a>が文書の<a
   href="#browsing1">閲覧文脈</a>に設定されている場合には、
利用者エージェントは<a href="#security10">保安性例外</a>を発生させなければ[[MUST:なりません]]。
そうでない場合、<span>文書の番地</span><!-- XXXDOCURL -->で示される資源を HTTP
によって<a href="#fetch"
   title=fetch>取ってくる</a>場合に RFC 2109
4.3.4 節やより新しい仕様書に従って含まれるであろう <code
   title="">Cookie</code> HTTP 頭部の値と同じ文字列を返さなければ[[MUST:なりません]]。 <a href="#refsRFC2109">[RFC2109]</a> <a
   href="#refsRFC2965">[RFC2965]</a>

#en
On setting, if the <a href="#sandboxed2">sandboxed origin browsing
   context flag</a> is set on the <a href="#browsing1">browsing context</a>
   of the document, the user agent must raise a <a
   href="#security10">security exception</a>. Otherwise, the user agent must
   act as it would when processing cookies if it had just attempted to <a
   href="#fetch">fetch</a> <span>the document's address</span><!-- XXXDOCURL
  -->
   over HTTP, and had received a response with a <code>Set-Cookie</code>
   header whose value was the specified value, as per RFC 2109 sections
   4.3.1, 4.3.2, and 4.3.3 or later specifications. <a
   href="#refsRFC2109">[RFC2109]</a> <a href="#refsRFC2965">[RFC2965]</a>
#ja
設定時、<a href="#sandboxed2">砂箱起源閲覧文脈旗</a>が文書の<a
   href="#browsing1">閲覧文脈</a>に設定されている場合には、
利用者エージェントは<a href="#security10">保安性例外</a>を発生させなければ[[MUST:なりません]]。
そうでない場合、利用者エージェントは、
<span>文書の番地</span><!-- XXXDOCURL -->で示される資源を HTTP
によって<a href="#fetch"
   title=fetch>取ってこよう</a>とし、
値が指定された値である <code>Set-Cookie</code>
頭部がある応答を受信した場合にクッキーを処理する時と同じように、
RFC 2109 4.3.1 節、4.3.2 節、4.3.3. 節やより新しい仕様書に従い作用しなければ[[MUST:なりません]]。 <a href="#refsRFC2109">[RFC2109]</a> <a
   href="#refsRFC2965">[RFC2965]</a>

#en
Since the <code title=dom-document-cookie><a
   href="#cookie0">cookie</a></code> attribute is accessible across frames,
   the path restrictions on cookies are only a tool to help manage which
   cookies are sent to which parts of the site, and are not in any way a
   security feature.
#ja
<code title=dom-document-cookie><a
   href="#cookie0">cookie</a></code> 属性はフレームをまたいでアクセス可能ですので、
クッキーの経路制限はクッキーがサイト上のどの部分に送られるかを管理することを助けるための道具に過ぎず、
保安性のための機能では決してありません。

#en
The <dfn id=lastmodified
   title=dom-document-lastModified><code>lastModified</code></dfn> attribute,
   on getting, must return the date and time of the <code>Document</code>'s
   source file's last modification, in the user's local timezone, in the
   following format:
#ja
<dfn id=lastmodified
   title=dom-document-lastModified><code>lastModified</code></dfn> 
属性は、取得時、 <code>Document</code> の原始ファイルの最終修正の日時を、
利用者の地方時において、次の書式で返さなければ[[MUST:なりません]]。

#en
The month component of the date.
#ja
日付の月の部品。

#en
A U+002F SOLIDUS character ('/').
#ja
U+002F SOLIDUS 文字 ('/')。

#en
The day component of the date.
#ja
日付の日の部品。

#en
The year component of the date.
#ja
日付の年の部品。

#en
A U+0020 SPACE character.
#ja
U+0020 SPACE 文字。

#en
The hours component of the time.
#ja
時刻の時の部品。

#en
A U+003A COLON character (':').
#ja
U+003A COLON 文字 (':')。

#en
The minutes component of the time.
#ja
時刻の分の部品。

#en
The seconds component of the time.
#ja
時刻の秒の部品。

#en
All the numeric components above, other than the year, must be given as
   two digits in the range U+0030 DIGIT ZERO to U+0039 DIGIT NINE
   representing the number in base ten, zero-padded if necessary.
#ja
前述の数値の部品のうち年以外のすべては、範囲 U+0030 DIGIT ZERO ～
U+0039 DIGIT NINE の2つの数字によって十進数を表す、
必要なら零埋めしたものとして与えなければ[[MUST:なりません]]。

#en
The <code>Document</code>'s source file's last modification date and
   time must be derived from relevant features of the networking protocols
   used, e.g. from the value of the HTTP <code title="">Last-Modified</code>
   header of the document, or from metadata in the file system for local
   files. If the last modification date and time are not known, the attribute
   must return the string <code title="">01/01/1970 00:00:00</code>.
#ja
<code>Document</code> の原始ファイルの最終修正日時は、
使用されているネットワークのプロトコルの関係する機能、例えば文書の HTTP <code title="">Last-Modified</code> 頭部から、または局所ファイルのファイル・システムのメタデータから得たものでなければ[[MUST:なりません]]。
最終修正日時がわからない場合は、この属性は文字列 <code title="">01/01/1970 00:00:00</code>
を返さなければ[[MUST:なりません]]。

#en
The <code>Document</code>'s source file's last modification date and
   time must be derived from relevant features of the networking protocols
   used, e.g. from the value of the HTTP <code title="">Last-Modified</code>
   header of the document, or from metadata in the file system for local
   files. If the last modification date and time are not known, the attribute
   must return the string <code title="">01/01/1970 00:00:00</code>.
#ja
<code>Document</code> の原始ファイルの最終修正日時は、
使用されているネットワークのプロトコルの関係する機能、例えば文書の HTTP <code title="">Last-Modified</code> 頭部から、または局所ファイルのファイル・システムのメタデータから得たものでなければ[[MUST:なりません]]。
最終修正日時がわからない場合は、この属性は文字列 <code title="">01/01/1970 00:00:00</code>
を返さなければ[[MUST:なりません]]。

#en
A <code>Document</code> is always set to one of three modes: <dfn
   id=no-quirks>no quirks mode</dfn>, the default; <dfn id=quirks>quirks
   mode</dfn>, used typically for legacy documents; and <dfn
   id=limited1>limited quirks mode</dfn>, also known as "almost standards"
   mode. The mode is only ever changed from the default by the <a
   href="#html-0">HTML parser</a>, based on the presence, absence, or value
   of the DOCTYPE string.
#ja
<code>Document</code> は常に3つのモードのいずれかに設定されています。<dfn
   id=no-quirks>無奇癖モード</dfn>は既定値です。<dfn id=quirks>奇癖モード</dfn>は、
普通、遺物文書に使われます。<dfn
   id=limited1>制限奇癖モード</dfn>は、「ほぼ標準」モードとも呼ばれます。
このモードは
<a
   href="#html-0">HTML 構文解析器</a>によってのみ、
DOCTYPE 文字列が存在するか存在しないかやその値に基づいて既定値から変更されます。

#en
The <dfn id=compatmode
   title=dom-document-compatMode><code>compatMode</code></dfn> DOM attribute
   must return the literal string "<code title="">CSS1Compat</code>" unless
   the document has been set to <a href="#quirks">quirks mode</a> by the <a
   href="#html-0">HTML parser</a>, in which case it must instead return the
   literal string "<code title="">BackCompat</code>".
#ja
<dfn id=compatmode
   title=dom-document-compatMode><code>compatMode</code></dfn> DOM 
属性は、生の文字列「<code title="">CSS1Compat</code>」を返さなければ[[MUST:なりません]]。
ただし、文書が <a
   href="#html-0">HTML 構文解析器</a>により<a href="#quirks">奇癖モード</a>に設定されている場合には、
代わりに名前の文字列「<code title="">BackCompat</code>」を返さなければ[[MUST:なりません]]。

#en
Documents have an associated <dfn id=character3 title="document's
   character encoding">character encoding</dfn>. When a <code>Document</code>
   object is created, the <a href="#character3">document's character
   encoding</a> must be initialized to UTF-16. Various algorithms during page
   loading affect this value, as does the <code title=dom-document-charset><a
   href="#charset0">charset</a></code> setter. <a
   href="#refsIANACHARSET">[IANACHARSET]</a> <!-- XXX
  http://www.iana.org/assignments/character-sets -->
#ja
文書は<dfn id=character3 title="document's
   character encoding">文字符号化</dfn>と関連付けられています。
<code>Document</code> オブジェクトが作成された時、<a href="#character3">文書の文字符号化</a>は
UTF-16 に初期化されなければ[[MUST:なりません]]。
頁の読み込みの間の色々な算法や <code title=dom-document-charset><a
   href="#charset0">charset</a></code> 設定子がこの値を変化させます。 <a
   href="#refsIANACHARSET">[IANACHARSET]</a> <!-- XXX
  http://www.iana.org/assignments/character-sets -->

#en
The <dfn id=charset0
   title=dom-document-charset><code>charset</code></dfn> DOM attribute must,
   on getting, return the preferred MIME name of the <a
   href="#character3">document's character encoding</a>. On setting, if the
   new value is an IANA-registered alias for a character encoding, the <a
   href="#character3">document's character encoding</a> must be set to that
   character encoding. (Otherwise, nothing happens.)
#ja
<dfn id=charset0
   title=dom-document-charset><code>charset</code></dfn> DOM
属性は、取得時、<a
   href="#character3">文書の文字符号化</a>の優先 MIME
名を返さなければ[[MUST:なりません]]。設定時、
新しい値がある文字符号化の IANA に登録された別名である場合、<a
   href="#character3">文書の文字符号化</a>をその文字符号化に設定しなければ[[MUST:なりません]]。
(それ以外の場合、何も起きません。)

#en
The <dfn id=characterset
   title=dom-document-characterSet><code>characterSet</code></dfn> DOM
   attribute must, on getting, return the preferred MIME name of the <a
   href="#character3">document's character encoding</a>.
#ja
<dfn id=characterset
   title=dom-document-characterSet><code>characterSet</code></dfn> DOM
属性は、取得時、<a
   href="#character3">文書の文字符号化</a>の優先 MIME 名を返さなければ[[MUST:なりません]]。

#en
The <dfn id=defaultcharset
   title=dom-document-defaultCharset><code>defaultCharset</code></dfn> DOM
   attribute must, on getting, return the preferred MIME name of a character
   encoding, possibly the user's default encoding, or an encoding associated
   with the user's current geographical location, or any arbitrary encoding
   name.
#ja
<dfn id=defaultcharset
   title=dom-document-defaultCharset><code>defaultCharset</code></dfn>
DOM 属性は、取得時、文字符号化の優先 MIME 名を返さなければ[[MUST:なりません]]。
この文字符号化は利用者の既定の符号化でもいいですし、
利用者の現在の地理的位置に関連付けられた符号化でもいいですし、
その他任意の符号化名でもあり得ます。

#pattern
<span class=secno>* </span><dfn id=dom-tree0>DOM tree
   accessors</dfn>
#ja
<span class=secno>$1 </span><dfn id=dom-tree0>DOM 木アクセス器</dfn>

#en
<dfn id=the-html0>The <code>html</code> element</dfn> of a document is
   the document's root element, if there is one and it's an <code><a
   href="#html">html</a></code> element, or null otherwise.
#ja
文書の<dfn id=the-html0>文書 <code>html</code> 要素</dfn>は、
その文書の根要素があり、それが <code><a
   href="#html">html</a></code> 要素である場合はその要素、それ以外の場合には
null です。

#en
<dfn id=the-head0>The <code>head</code> element</dfn> of a document is
   the first <code><a href="#head">head</a></code> element that is a child of
   <a href="#the-html0">the <code>html</code> element</a>, if there is one,
   or null otherwise.
#ja
文書の<dfn id=the-head0>文書 <code>head</code> 要素</dfn>は、
<a href="#the-html0">文書 <code>html</code> 要素</a>の子供である最初の
<code><a href="#head">head</a></code> 要素がある場合はその要素、
そうでない場合は null です。


#en
<dfn id=the-title1>The <code>title</code> element</dfn> of a document is
   the first <code><a href="#title1">title</a></code> element in the document
   (in tree order), if there is one, or null otherwise.
#ja
文書の<dfn id=the-title1>文書 <code>title</code> 要素</dfn>は文書の (木順で)
最初の <code><a href="#title1">title</a></code> 要素がある場合はその要素、
そうでない場合は null です。