Edit

Page

Page title:

Page body:

[70] [DFN[[RUBYB[コメント]@en[comment]]]]は、
[[内容]]でも[[マーク付け]]でもないデータ
([[著者]]自身のための補足情報など) を [[HTML]] や [[XML]]
の[[文書]]中に埋め込む構文・[[節点]]です。

* [CODE(DOMi)@en[Comment]] インターフェイス (DOM)

[43] [[DOM]] では、[RUBYB[注釈節] [[CODE(DOM)[Comment]] node]]はどんな種類の子[[節]]も持つことは出来ません。

[44] 注釈節は [[HTML]] ([[SGML]]) 及び [[XML]]
の[[注釈宣言]]に対応しています。

[45] [CODE(DOM)[[[CharacterData]]]] を継承しています。
追加の属性等はありません。

[46] DOM の規定では、「[CODE(XML)[]] で始まるその間が注釈だ、
だけどこれは XML の話で、 HTML 解析器は完全な SGML
の注釈を解釈できるかもねん☆」となっていますが、
その 「SGML の注釈」がどう扱われるのかは書かれていません。

例えば、 [SAMP(HTML)[<!--comment 1-- -- comment 2 -- >]]
はどう解釈されるのでしょう。 [CODE(DOM)[[[nodeValue]]]]
は [SAMP(HTML)[comment 1 comment 2 ]]
でしょうか、それとも [SAMP(HTML)[comment 1-- -- comment 2 ]]
でしょうか。はたまたその他でしょうか。

また、 SGML 的に不正な、
[SAMP(HTML)[]]
のような注釈を、著者の意図したように解釈する HTML
解析器は少なくありませんが、そのような場合はどうなるのでしょう。

[REFS[
- [DOM1] ''Document Object Model (Core) Level 1'' <http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#ID-1728279322>
- [DOM2] ''Document Object Model Core'' <http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-1728279322>
]REFS]

* 例

- [7] [SAMP(SGML)[]]
(XML でも OK)
- [8] [SAMP(SGML)[]]
(XML でも OK)
- [9] [SAMP(SGML)[]]
- [11] [SAMP(SGML)[<!>]]
- [12] [SAMP(SGML)[]]

[[#comment]]

不正な例:
- [10] [SAMP(SGML)[]]

** 不正な注釈の実例

[75] 
[CITE[Ethiopic Viewer for X-Windows]], [TIME[2003-09-15T20:18:44.000Z]], [TIME[2024-10-06T05:13:41.452Z]] <https://www.africa.upenn.edu/Software/Ethiopic_Viewer_17981.html>

* 拡張点としての注釈

[57] [[HTMLにおける他言語統合点]]を参照。

* 歴史

[71] [[HTML]] と [[XML]] の[[コメント]]は、どちらも [[SGML]] に由来するものでした。

** コメント、コメント宣言 (SGML)

[2]

>
:[RUBYB[注釈宣言][comment declaration]]:
[[注釈]]だけを含む[[マーク宣言]]。
[SRC[[[JIS X 4151]]‐1992 3. (167)]]

- [3] [CODE(ABNF)[[DFN[注釈宣言]] := [CODE(SGML)[[[mdo]]]] '''['''注釈 *([[s]] / 注釈)''']''' [CODE(SGML)[[[mdc]]]] ;; (91)]]

[4] 空の注釈宣言 [CODE(SGML)[<!>]] は、
見易さのために空行を入れたいものの、
[[短縮参照]]を使っているので[[記録開始]]・[[記録終了]]を迂闊に使えない時に有用です。 
(JIS X 4151‐1992 参考3 5.2.1 参照。)

[5] [WEAK[規格参照区切子で]]注釈を使うときは、途中で [CODE[--]] 
を使わないことにするのはもちろん、一番最後に [CODE[-]] 
を使わないようにも注意しないといけません。 ([CODE(SGML)[--->]] 
で、最初の [SAMP(SGML)[--]] と謎の [SAMP[->]] に誤認されます。)

[14]
>>3 マーク宣言だけど [CODE(SGML)[[[ps]]]] ではなく [CODE(SGML)[[[s]]]] なんだ。

[23] >>14 [[引数実体参照]]を認めると面倒くさいからでしょうね。

[24] コメント:
> [[文書]]を使う人を補助する説明又は留意事項を含む[[マーク宣言]]の一部。 Comment。 [INS[([[JISX4151]]‐1992 3. (165))]]

- [25] [CODE(ABNF)[[DFN[注釈]] := [CODE(SGML)[[[com]]]] *[[SGML文字]] [CODE(SGML)[com]] ;; (92)]]

[26] 注釈内では、終端区切子 [CODE(SGML)[com]] 以外の[[マーク]]は認知しません。 (9.3 参照。)

*** ISO/IEC 10744 Conventional Comment

[27] [[conventional comment]]

** [CODE[--]] 問題

[67] 
[[HTML4]] の適合性の項も参照。

[15]
[[HTML 4]] では注釈宣言に注釈は1つしか入れることができないという説があるようで、
その元凶は
''Another HTML-lint : Explanation : コメント中に `--` を書くことはできません。'' <http://openlab.ring.gr.jp/k16/htmllint/explain.html#excluded-w-hyphens-in-comment>
なのではないかと思われます。

> HTML4.01(J)では、コメント中に 2個以上連なったハイフンは書かないように、とされています。XML(J)でも禁止です。つまり、上の例 [INS[(引用者注: 複数ハイフンの例)]] はすべて誤りです。

と説明していますが、 HTML 4 は [Q[should avoid]] としか言っていません。
ですから、[Q[誤り]]には ([Q[誤り]]が incorrect にせよ error にせよ)
なりません。 (仮に禁止してしまうと、 HTML 4 が SGML に適合しません。)

[FIG(quote)[
[FIGCAPTION[
[64] [CITE[]]
([TIME[2016-04-16 23:31:49 +09:00]])
<http://www.tohoho-web.com/html/comments.htm>
]FIGCAPTION]

> HTML2.0 では、<! と > の間に複数の -- コメント -- を記述することができるという仕様でした。下記の○の個所にコメントを記述することができます。(△の個所には記述できません。)
> 
> これは、HTML の元になった SGML という規格が以下のような文法で記述され、この定義部を取り除いたものが HTML のコメントとして採用されていることに由来します。
> <!定義部  --コメント--
>   定義部  --コメント-->
> しかし、HTML4.0 では、 の間に 2個以上の連続したハイフンを用いることは避けねばならないと説明されています。よく、下記のようなコメントを見ますが、HTML4.0 に正確に従うのであれば、このような使用法は避けた方がよいでしょう。
> 
> また、HTML4.0に正確に従うのであれば、JavaScriptの中で -- 演算子を使用する際も注意が必要です。
> <script type="text/javascript">
> 
> </script>

]FIG]

[66] 
[[SGML]] の[[マーク付け宣言]]が [[HTML]] の[[注釈宣言]]になったようなことが書いてあるが、
[[注釈宣言]]は [[SGML]] にもちゃんとある。そもそも [[HTML4]] は [[SGML応用]]と主張しているのだから、
[[HTML]] と [[SGML]] は別物であるかのような説明はおかしい。

[65] [[HTML4]] には [[JavaScript]] で [CODE[--]] を使うなとは (たぶん) 書いてない。
少なくても、 [CITE@en[Scripts in HTML documents]] ([TIME[1999-12-25 08:25:53 +09:00]]) <https://www.w3.org/TR/html4/interact/scripts.html#idx-user_agent>
にはそんなこと書いてない。 [[HTML4]] に従うなら [CODE(HTMLe)@en[script]]
[[要素]]の[[内容]]は [CODE[CDATA]] なので、 [CODE[<!--]] は[[注釈宣言]]ではなく[[文字データ]]。
[CODE[--]] が禁止される根拠はない。

** [CODE[!--]] タグ

[31] コメントタグ。[[不思議マーク付け]]の世界で、囲んだ部分を表示しなくする[[タグ]]。[[開始タグ]]は [SAMP(HTML)[]]。

[32] 
不思議でない [[HTML]] や [[SGML]] や [[XML]] の世界では、[[注釈宣言]]が対応する。また、太古の HTML の [[comment]] 要素に類似したタグであるとも言える。

[28] 
[CITE@EN-US[HTML Comment Element | HTML Comment Object]], [[InetSDK]], [TIME[2024-08-17T04:59:29.000Z]], [TIME[2000-10-11T21:24:14.115Z]] <https://web.archive.org/web/20001011194325/http://msdn.microsoft.com/workshop/author/dhtml/reference/objects/htmlcomment.asp>

[FIG(data)[ [111] [[HTML要素概説]]

:[F[要素名]]:[CODE[!--]]
:[F[要素名]]:[CODE[!-]]
:[F[要素名]]:[CODE[!]]
:日付:[TIME[1995]]
:説明:
[[注釈]]は、
低品質な解説等でしばしば[[要素]]や[[タグ]]として紹介された。
[[開始タグ]]が [CODE(HTML)[]], [CODE(HTML)[>]]、
[[タグ名]]が [CODE[!--]], [CODE[!-]], [CODE[!]]
などと説明される。
[[SGML]]
に於いても現在の 
[[HTML]]
に於いても誤りである。

]FIG]

[FIG(data)[ [41] [[HTML要素概説]]

:[F[要素名]]:[CODE[!--]]
:日付:[TIME[2000]]
:説明:
[[Microsoft Corporation]] も HTML 注釈要素は[[開始タグ]]と[[終了タグ]]が必須と紹介していた。
:出典:
[REFS[

-
[DFN[MSDHTML:Comment]]
[CITE@EN-US[HTML Comment Element | HTML Comment Object]], 
[DATA(.author)[[[Microsoft Corporation]]]], 
[TIME[2024-08-17T04:59:29.000Z]], 
[TIME(.published)[2000-10-11T21:24:14.115Z]] <https://web.archive.org/web/20001011194325/http://msdn.microsoft.com/workshop/author/dhtml/reference/objects/htmlcomment.asp>

]REFS]

]FIG]

[FIG(data)[ [40] [[HTML要素概説]]

:[F[要素名]]:[CODE[!-]]
:日付:[TIME[1998]]
:説明:
[CITE[Compact HTML]]
の tag list
に、
element
として
[CODE[!-]]
がある。
:出典:
[REFS[

-
[DFN[CHTML]]:
[CITE@en[Compact HTML for Small Information Appliances]], 
[DATA(.author)[[[Tomihisa Kamada]]]],
[DATA(.status)[W3C NOTE]],
[TIME(.published jp)[09-Feb-1998][1998-02-09]],
[TIME[2017-10-02T11:00:16.000Z]], [TIME[2024-08-24T06:35:42.196Z]] <https://www.w3.org/TR/1998/NOTE-compactHTML-19980209/>

]REFS]

]FIG]

[29] [CITE@EN-US[The XML Object Model in Internet Explorer 4.0]], [[Microsoft Corporation]], [TIME[2024-08-17T05:52:05.000Z]], [TIME[2000-10-18T15:19:27.599Z]] <https://web.archive.org/web/20001018151202/http://msdn.microsoft.com/xml/articles/xmlmodel.asp>

[30] >>29 [[XML]] の[[注釈宣言]]の[[タグ名]]が [CODE[!]] とされた [[API]]。

[33] [CITE@ja[A Guide to the Internet Connection Servers - SG244805.PDF]], [TIME[2009-11-28T06:54:29.000Z]], [TIME[2024-08-18T13:20:38.431Z]] <http://ps-2.kev009.com/rs6000/redbook-cd/SG244805.PDF#page=25>

[34] >>33 [CODE[!]] タグ ([CODE[<!]] ... [CODE[>]])

[35] 
[CITE[Compact HTML for Small Information Appliances]], [TIME[2017-10-02T11:00:16.000Z]], [TIME[2024-08-24T06:33:58.053Z]] <https://www.w3.org/TR/1998/NOTE-compactHTML-19980209/>

[36] >>35 タグリストに要素として [CODE[!-]] が掲載されている (めちゃくちゃ)。

[FIG(data)[ [74] [[HTML要素概説]]

:[F[要素名]]:[CODE[!--]]
:日付:[TIME[1990]]
:説明:
[CODE(HTML)[]] で終わるものは、
[[注釈]]であり、[[タグ]]ではない。[[タグ]]とは構文がまったく異なる。

]FIG]

[FIG(data)[ [37] [[HTML要素概説]]

:[F[要素名]]:[CODE[!]]
:日付:[TIME[1990]]
:説明:
[CODE(HTML)[<!>]] は[[タグ名]] [CODE[!]] の[[開始タグ]]のようにも見えるが、
[[HTML5構文解析器]]は[[空文字列]]の[[注釈]]とみなす。
[[SGML]] では[[注釈宣言]]だった。
:注釈:
-
[DFN[[RUBYB[注釈宣言][comment declaration]]]]
[[マーク付け宣言]]の一種で、 [CODE(SGML)[<!]] から始まり [CODE(SGML)[>]] で終わる。
[CODE(SGML)[--]] から次の [CODE(SGML)[--]] までが[[注釈]]とみなされる。
[CODE(SGML)[<!>]] は、[[注釈]]がない空の[[注釈宣言]]である。
-
[DFN[[RUBYB@ja[注釈]@en[comment]]]]
[[HTML構文]]に出現し得る構造の一種であり、
[[DOM節点]]の一種でもある。
[[SGML]]
では[[注釈宣言]]に相当する。
[[SGML]] では[[注釈宣言]]の内部構造を[[注釈]]という。

]FIG]

- [1] ''マニアックな文法論議 - SGML の注釈宣言'' <http://www.ne.jp/asahi/minazuki/bakera/html/sgml/comdeclare>

[42] [[HTML 4]] 仕様書は、 [[DTD]] の[[注釈]]は[[参考]]としています。

[[XHTML 1.0]] 仕様書にはこのような規定はありません。

[6] [[HTML 4]] では、[[利用者エージェント]]は注釈 (宣言)
を[[レンダリング]]してはなりません。 
(<IW:HTML4:conform.html#sgmlconvent> 参照。)

これを厳密に解釈すると、注釈宣言表示機能を実装した UA
は HTML 4 不適合になってしまいますが、あくまで、
通常の表示モードではレンダリングしないというのが HTML 4
の意図でしょう。

[13] 古い HTML UA には、注釈宣言内の [SAMP[>]] 
で注釈宣言を終わらせてしまうものがありました。
このため、かつては、 HTML の注釈宣言内に [SAMP[>]]
を入れるのは望ましくないと言う人もいました。

[16]
[CITE[Hixie's Natural Log: People who don't realise that they're wrong]] 
<http://ln.hixie.ch/?start=1137799947&count=1>

[[Ian Hickson]]は[[Webブラウザ]]が[[標準モード]]で[[HTML]]の[[注釈宣言]]を[[SGML]]の仕様に基づいて[[構文解析]]するように働きかけてきた。
各ブラウザが[[Acid2]]のために修正した。
そしてIanはいま自らの誤りに気づいた。・・・遅過ぎだってww
([[名無しさん]] [WEAK[2006-01-21 04:13:29 +00:00]])

[17]
[CITE[我的春秋: (X)HTML, XML のコメント記述位置]] ([CODE[2007-01-23 08:53:24 +09:00]] 版) <http://my-chunqiu.cocolog-nifty.com/blog/2007/01/xhtml_xml__83b4.html>
([[名無しさん]] [WEAK[2007-01-22 23:59:28 +00:00]])

[18]
[CITE[Netscape Navigator Extensions to HTML]] 
<http://web.archive.org/web/20000415023954/http://www.netscape.com/home/services_docs/html-extensions.html>

[[HTML 2.0]] の拡張と称して、 [[Netscape Navigator]] 
では[[注釈宣言]]中に[[タグ]]を含むことができなかったのができるようになったことが紹介されています。

[19]
[[PlaceXML]] は [[HTML]] [CODE(HTMLe)@en[[[head]]]]
に埋め込む時に [[HTML]] の[[注釈]]を使います。
[[プロジェクト]]自体が [[Web 2.0]] の影響を受けているようですので、
明らかに [[Trackback Auto Discovery]] の悪習をまねたのでしょう。
([[名無しさん]])

[20]
[CITE[EMail Msg <9306050318.AA10442@wintermute.ncsa.uiuc.edu>]] ([CODE[2007-07-01 05:00:05 +09:00]] 版) <http://ksi.cpsc.ucalgary.ca/archives/WWW-TALK/www-talk-1993q2.messages/436.html>
([[名無しさん]])

[21]
[CITE[hoshikuzu | star_dust の書斎 - 2007-09-18]] ([CODE[2007-09-23 16:39:56 +09:00]] 版) <http://d.hatena.ne.jp/hoshikuzu/20070918#p2>
([[名無しさん]])

[22]
>>21 [[WinIE 6]] で本来の [CODE(HTMLe)@en[[[h2]]]] の下に
[CODE(CSS)@en[[[background-image]]]] が[[レンダリング]]されるのを確認。

<http://suika.suikawiki.org/gate/2007/cssom/viewer.en.html?c=h2%20*%20%7B%0D%0A%20%20padding%3A%20100px%3B%0D%0A%20%20display%3A%20block%3B%0D%0A%20%20background-image%3A%20url(image)%3B%0D%0A%7D;h=%3Ch2%3EXXX%3C!----%3E%3C%2Fh2%3EYYY;p=q;x=style-element>

[49] [CITE[IRC logs: freenode / #whatwg / 20100607]]
([TIME[2010-06-25 08:55:45 +09:00]] 版)
<http://krijnhoetmer.nl/irc-logs/whatwg/20100607#l-147>

[50] [CITE@en[Web Applications 1.0 r5513     Nuke the comment end space state.Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=10578]]
( ([TIME[2010-09-27 01:50:00 +09:00]] 版))
<http://html5.org/tools/web-apps-tracker?from=5512&to=5513>

[51] [CITE[Bug 570309 – ''''''[''''''HTML5'''''']'''''' CNNMoney unclickable links ("-- >" terminates comment in HTML5)]]
( ([TIME[2010-10-11 11:18:44 +09:00]] 版))
<https://bugzilla.mozilla.org/show_bug.cgi?id=570309>

[52] [CITE['''['''whatwg''']''' Consecutive hyphen-minus characters in comments/in ACE-strings of IDNs]]
([TIME[2010-11-03 08:43:23 +09:00]] 版)
<http://lists.whatwg.org/pipermail/whatwg-whatwg.org/2010-November/028937.html>

[53] [CITE['''['''whatwg''']''' Parse error for "--" in comment end state?]]
([TIME[2010-11-03 09:55:55 +09:00]] 版)
<http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2006-May/006337.html>

[54] [CITE['''['''whatwg''']''' Consecutive hyphen-minus characters in comments/in ACE-strings of IDNs]]
([TIME[2011-01-07 10:19:39 +09:00]] 版)
<http://lists.whatwg.org/pipermail/whatwg-whatwg.org/2011-January/029706.html>

[55] [CITE[''''''[''''''whatwg'''''']'''''' Consecutive hyphen-minus characters in comments/in ACE-strings of IDNs]]
( ([TIME[2011-05-03 11:55:25 +09:00]] 版))
<http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2011-May/031436.html>

[47] [CITE[IRC logs: freenode / #whatwg / 20100721]]
([TIME[2010-08-08 15:33:20 +09:00]] 版)
<http://krijnhoetmer.nl/irc-logs/whatwg/20100721#l-842>

[48] [CITE[Add constructors for DocumentFragment, Text, and Comment. (DocumentType ... · a2f1e18 · whatwg/dom]]
( ([TIME[2013-02-16 12:38:35 +09:00]] 版))
<https://github.com/whatwg/dom/commit/a2f1e18ff56ecc12643dc54fcf50f0c335beec71>

[56] [CITE@en[XQuery and XPath Data Model 3.0]]
( ([TIME[2014-04-08 07:00:06 +09:00]] 版))
<http://www.w3.org/TR/xpath-datamodel-3/#CommentNode>

[58] [CITE@en-GB-x-Hixie[Hixie's Natural Log: People who don't realise that they're wrong]]
( ([TIME[2016-05-31 11:32:17 +09:00]]))
<http://ln.hixie.ch/?start=1137799947&count=1>

[59] 
>
2016/05/31 01:59:09 (tantek) I'm pretty sure we fixed that in Tasman (IE5/Mac) too back in the day, because of the thoroughness of all the rest of Hixie's tests.

[60] [CITE@en[Allow dashes in comments]]
([[zcorpan]]著, [TIME[2016-06-21 06:46:50 +09:00]])
<https://github.com/whatwg/html/commit/518d16fdc672d1023dcfd2847d86f559d13a842f>

[61] [CITE@en[Allow comments to end with <!-->]]
([[zcorpan]]著, [TIME[2016-06-24 01:20:26 +09:00]])
<https://github.com/whatwg/html/commit/1633b9aadab815e6daba17950c4ff81a80b896ed>

[62] [CITE@en[Specify global object references in more detail]]
([[annevk]]著, [TIME[2016-08-17 19:43:59 +09:00]])
<https://github.com/whatwg/dom/commit/fa8adb6cd107cd845feaeb71c9da208971b670ca>

[63] [CITE@en[Restrict comment syntax to not contain --> or --!>]]
([[yuyokk]]著, [TIME[2016-11-29 07:17:01 +09:00]])
<https://github.com/whatwg/html/commit/4637996e5f1579659e0351a6fac5c930c3ea553e>

[68] [CITE@en[Improve <style> and <script> processing and conformance]]
([[domenic]]著, [TIME[2017-09-14 18:42:48 +09:00]])
<https://github.com/whatwg/html/commit/9c612ac8641b5174849a2d3cb924fe662a8d3a09>

[FIG(quote)[
[FIGCAPTION[
[69] [CITE[HTML Design Notebook]]
([TIME[2014-02-25 08:06:50 +09:00]])
<https://www.w3.org/People/Connolly/drafts/html-design.html>
]FIGCAPTION]

> Mosaic 2.4
> broken comment parsing -- thinks comments end with >, rather than the actual-->

]FIG]

[72] [CITE@en[Align with IDL constructor changes]]
([[autokagami]]著, [TIME[2019-09-24 22:42:56 +09:00]])
<https://github.com/whatwg/dom/commit/57512fac17cf2f1c4c85be4aec178c8086ee5ee4>

[73] [CITE@en[Update to constructor operations · Issue #780 · whatwg/dom]]
([TIME[2020-05-14 14:04:57 +09:00]])
<https://github.com/whatwg/dom/issues/780>

[38] [CITE@ja[2004年のお便り〈9月〉(和田フォト)]], [TIME[2007-05-22T10:50:00.000Z]], [TIME[2024-09-10T04:11:42.800Z]] <https://wadaphoto.jp/otayori0409.htm>

>
[PRE[
//-->
</SCRIPT><SCRIPT language="JavaScript">
<!--HPB_SCRIPT_PLD_50
HpbImgPreload('_HPB_ROLLOVER1', 'images/n_image4.gif', 'images/m_image4.gif');
]PRE]

[39] >>38 [[ホームページビルダー]]は [CODE[<!--]] 行を活用して自身が生成した[[スクリプト]]を識別していた模様。

Historical Legal Sensitive Parent: [Help / License]

Edit

Page

Errors

Page name(s)