🍩スキンHTML内でコメントアウトする際の#🌱豆知識:

No.2081

🍩スキンHTML内でコメントアウトする際の#🌱豆知識:

スキンをカスタマイズする際に、例えば [[hogehoge]] という記述を一時的に無効化しようと考えて  のように書きたくなるケースがあると思うのですが、これはお勧めできません。

なぜかというと、 [[hogehoge]] の箇所に実際に挿入されるHTMLソースの中にもHTMLのコメント記法が含まれている場合があるからです。例えば [[hogehoge]]] の箇所は <div class="hagehage"><a href="higehige">ふげふげ</a></div> のように出力されていることがあります。

このとき、スキンHTMLに  と書いてしまうと、実際には <a href="higehige">ふげふげ</a></div> --> と出力されてしまいます。

HTMLの文法では、コメントは入れ子構造にできない仕様なので、最初に「-->」が現れたところでコメントアウトが終わってしまいます。つまり、上記だと、最後の「-->」ではなく、半ばの「-->」でコメントが終わったとブラウザは判断してしまいます。

その結果、HTMLタグの開閉が一致しなくなってレイアウトが崩れてしまいます。普通は、中途半端に何かが表示されていればコメントアウトがおかしいことに気付くでしょう。しかし、てがろぐの各種記法には「ある状況でしか中身が挿入されない」という記法がいくつかあります。そういうものをコメントアウトしていると、『状況によっては何も表示されないために、コメントアウトが中途半端なことに気付かない』というケースがあり得ます。その場合、ある特定の条件が成立している場合にだけ表示が崩れる、ということになってしまいます。

なので、[[hogehoge]] 等の記法をコメントアウトしたい場合は、例えば
 ←カッコの種類を変える
 ←カッコを別の記号にする
 ←カッコと英字の間に空白を入れる

……のようにするとか、何か余計な文字を加えるか削るかして、てがろぐCGI側が展開しないような書き方に修正することをお勧め致します。

※てがろぐ側の出力内容にもHTMLのコメント記法を使ってコメントを含めてあるのは、『最終的な出力ソース（＝ブラウザのソース表示機能を使って見えるHTMLソース）を参考にして、装飾のためのCSSを考える際に、「そこが何のための出力なのか」を示すことで考えやすくするため』です。(たいていは)
畳む

by nishishi. ⌚2021年4月12日(月) 11:14:26〔4年以上前〕＜1216文字＞編集