====================================================================== === SimpleBoxes HTML coding guideline ================================ ====================================================================== Written by Takuya Otani / 01 Jun 2007 Copyright (C) 2007 SimpleBoxes/SerendipityNZ All rights reserved. [改版履歴] * ver 0.00 [2007/06/01] 初版 [要旨] この文書は Takuya Otani@SimpleBoxes が作成する HTML のコーディングスタイルを定めるものとする [ライセンス] この文書は「クリエティブ・コモンズ・ライセンス表示 3.0」に従う。 http://creativecommons.org/licenses/by/3.0/ [コメントの記述] - "" をコメントとして利用すること - コメント内部に "-" は含めない - コメント内部は、BEGIN / END の文字列で始めない(Serene Bach/sb のテンプレートとの衝突を防ぐ) [head要素内の記述] head 要素内に含まれる要素は以下の順序で記述する 1. meta 要素 2. title 要素 5. base 要素 3. link 要素 4. script 要素 6. style 要素 7. object 要素 8. その他 * ガイドラインの指定 rel 属性の値として、「guideline」を設定し、href 属性にガイドラインの url を指定することで、適用するガイドラインを明示する。例. [属性の記述] 属性は以下の順序で記述する 1. 優先属性 2. コア属性 3. 言語属性 4. イベント属性 5. フォーカス属性 6. その他の属性 * 優先属性の出現順序要素毎に異なる。詳細については、後述(次項)。 * コア属性 1. class 2. id 3. title 4. style * 言語属性 DTD での指定順に準拠する。XHTML 1.0 では、以下の通り。 1. lang 2. xml:lang 3. dir * イベント属性 DTD での指定順に準拠する。XHTML 1.0 では、以下の通り。 1. onclick 2. ondblclick 3. onmousedown 4. onmouseup 5. onmouseover 6. onmousemove 7. onmouseout 8. onkeypress 9. onkeydown 10. onkeyup * フォーカス属性 DTD での指定順に準拠する。XHTML 1.0 では、以下の通り。 1. accesskey 2. tabindex 3. onfocus 4. onblur * その他の属性その他の属性は、各要素固有の属性の中で優先属性に指定されていない属性を指す。出現順序は、DTD での指定順に準拠する。 [各要素の優先属性] * meta 要素 1. http-equiv 2. name 3. content * link 要素 1. rel 2. rev 3. href 4. type * script 要素 1. src 2. type * style 要素 1. type * object 要素 1. data 2. type 3. classid 4. height 5. width 6. name * param 要素 1. id 2. name 3. value 4. valuetype 5. type * ins / del 要素 1. cite 2. datetime * blockquote 要素 1. cite * table 要素 1. summary * col / colgroup 要素 1. span * td / th 要素 1. abbr 2. rowspan 3. colspan 4. scope * a 要素 1. href 2. name * img 要素 1. src 2. alt 3. width 4. height 5. longdesc * map 要素 1. name * area 要素 1. href 2. shape 3. coords 4. alt * q 要素 1. cite * form 要素 1. action 2. method 3. enctype 4. name * label 要素 1. for * input 要素 1. type 2. name 3. value 4. size 5. src 6. alt 7. checked 8. disabled 9. readonly * select 要素 1. name 2. size 3. multiple 4. disabled * optgroup 要素 1. label 2. disabled * option 要素 1. value 2. label 3. selected 4. disabled * textarea 要素 1. name 2. cols 3. rows 4. disabled 5. readonly * button 要素 1. type 2. name 3. value 4. disabled * frameset 要素 1. cols 2. rows * frame / iframe 要素 1. name 2. src 3. longdesc [インデント] インデントを利用する場合には、スペースではなく、タブをインデントとして利用する。要素の内容が長くなる場合、要素内の要素に対しては、インデントを適用しなくてもよい。例)

短いリスト
短いリスト

長い内容長い内容長い内容長い内容長い内容長い内容長い内容...(以下略)

html 要素、head 要素、body 要素は、インデントなしとする。 head 要素内の子要素については、ひとつのインデントを原則として適用する。 body 要素内の子要素については、要素の取りうる深さに依存するが、必ずしもインデントする必要はない。 [改行] ブロック要素の終了タグの後には、原則として改行を挿入する。 head 要素内の子要素については、各要素毎に改行する。 [参考文献] - http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd