TECH I.S.

HTMLスタイルガイド


一貫性のある、クリーンで整頓されたHTMLコードは、他のユーザーがコードを読みやすく、理解しやすくします。

優れたHTMLコードを作成するためのガイドラインとヒントを次に示します。


常にドキュメントタイプを宣言する

ドキュメントタイプは、常にドキュメントの最初の行として宣言してください。

HTMLの正しいドキュメントタイプは次のとおりです。

<!DOCTYPE html>

小文字の要素名を使用する

HTMLでは、要素名に大文字と小文字を混在させることができます。

ただし、次の理由から、小文字の要素名を使用することをお勧めします。

  • 大文字と小文字の名前を混在させると見栄えが悪い
  • 開発者は通常、小文字の名前を使用します
  • 小文字がきれいに見える
  • 小文字の方が書きやすい

良い:

<body> <p>これは段落です</p> </body>

悪い:

<BODY> <P>これは段落です</P> </BODY>

すべてのHTML要素を閉じる

HTMLでは、すべての要素を閉じる必要はありません(たとえば、<p>エレメント)。

ただし、次のようにすべてのHTML要素を閉じることを強くお勧めします。

良い:

<section>   <p>これは段落です</p>   <p>これは段落です</p> </section>

悪い:

<section>   <p>これは段落です   <p>これは段落です </section>

小文字の属性名を使用する

HTMLでは、属性名に大文字と小文字を混在させることができます。

ただし、次の理由から、小文字の属性名を使用することをお勧めします。

  • 大文字と小文字の名前を混在させると見栄えが悪い
  • 開発者は通常、小文字の名前を使用します
  • 小文字がきれいに見える
  • 小文字の方が書きやすい

良い:

<a href="https://techis.jp/guide/html/default">HTMLチュートリアルをご覧ください</a>

悪い:

<a HREF="https://techis.jp/guide/html/default">HTMLチュートリアルをご覧ください</a>

常に属性値を引用する

HTMLでは、引用符なしで属性値を使用できます。

ただし、次の理由から、属性値を引用することをお勧めします。

  • 開発者は通常、属性値を引用します
  • 引用された値は読みやすい
  • 値にスペースが含まれている場合は、引用符を使用する必要があります

良い:

<table class="striped">

悪い:

<table class="striped">

ひどい:

値にスペースが含まれているため、これは機能しません。

<table class="table striped">

画像のalt、幅、高さを常に指定する

常に指定するalt画像の属性。この属性は、何らかの理由で画像を表示できない場合に重要です。

また、常にwidthheight画像の。これにより、ブラウザは画像をロードする前にスペースを予約できるため、ちらつきが減少します。

良い:

<img src="html5.gif" alt="HTML5" style="width:128px;height:128px">

悪い:

<img src="html5.gif">

スペースと等号

HTMLでは、等号の前後にスペースを使用できます。ただし、スペースのない方が読みやすく、エンティティをより適切にグループ化できます。

良い:

<link rel="stylesheet" href="styles.css">

悪い:

<link rel="stylesheet" href="styles.css">

長いコード行を避ける

HTML エディタを使用する場合、左右にスクロールしてHTMLコードを読むのは不便です。

コード行が長すぎないようにしてください。


空行とインデント

理由もなく空白行、スペース、またはインデントを追加しないでください。

読みやすくするために、空白行を追加して大きなコードブロックまたは論理コードブロックを区切ります。

読みやすくするために、インデントの2つのスペースを追加します。タブキーは使用しないでください。

良い:

<body> <h1>有名な都市</h1> <h2>東京</h2> <p>東京は日本の首都であり、首都圏の中心であり、世界で最も人口の多い大都市圏です。 </p> <h2>ロンドン</h2> <p>ロンドンはイングランドの首都です。イギリスで最も人口の多い都市です。</p> <h2>パリ</h2> <p>パリはフランスの首都です。パリ地域は、ヨーロッパで最大の人口集中地の1つです。 </p> </body>

悪い:

<body> <h1>有名な都市</h1> <h2>東京</h2><p>東京は日本の首都であり、首都圏の中心であり、世界で最も人口の多い大都市圏です。</p> <h2>ロンドン</h2><p>ロンドンはイングランドの首都です。イギリスで最も人口の多い都市です。</p> <h2>パリ</h2><p>パリはフランスの首都です。パリ地域は、ヨーロッパで最大の人口集中地の1つです。</p> </body>

良いテーブルの例:

<table>   <tr>     <th>名前</th>     <th>説明</th> </tr>   <tr>     <td>A</td>     <td>Aの説明</td> </tr>   <tr>     <td>B</td>     <td>Bの説明</td>   </tr> </table>

良いリストの例:

<ul>   <li>ロンドン</li>   <li>パリ</li> <li>東京</li> </ul>

<title>要素をスキップしない

<title>要素はHTMLで必須です。

ページタイトルの内容は、検索エンジン最適化(SEO)にとって非常に重要です。ページタイトルは、検索結果にページをリストする際の順序を決定するために、検索エンジンアルゴリズムによって使用されます。

<title>エレメント:
  • ブラウザのツールバーのタイトルを定義します
  • お気に入りに追加されたときにページのタイトルを提供します
  • 検索エンジンの結果にページのタイトルを表示する

したがって、タイトルをできるだけ正確で意味のあるものにするようにしてください。

<title>HTMLスタイルガイドとコーディング規約</title>

<html>と<body>を省略しますか?

HTML ページは、<html><body>タグ:

<!DOCTYPE html> <head>   <title>ページのタイトル</title> </head> <h1>これは見出しです</h1> <p>これは段落です</p>

ただし、常に追加することを強くお勧めします。<html><body>タグ!

省略<body>古いブラウザではエラーが発生する可能性があります。

省略<html><body>DOMおよびXMLソフトウェアもクラッシュする可能性があります。


<head>を省略しますか?

HTMLの<head>タグも省略できます。

ブラウザは前にすべての要素を追加します<body>、デフォルトに<head>エレメント。

<!DOCTYPE html> <html> <title>ページタイトル</title> <body> <h1>これは見出しです</h1> <p>これは段落です</p> </body> </html>

しかし、<head>タグを使うことをお勧めします。


空のHTML要素を閉じますか?

HTMLでは、空の要素を閉じることはオプションです。

可:

<meta charset="utf-8">

こちらも可:

<meta charset="utf-8" />

XML/XHTMLソフトウェアがページにアクセスすることが予想される場合は、終了スラッシュ(/)を保持します。これは、XMLおよびXHTMLで必要になるためです。


lang属性を追加する

常に含める必要がありますlang内部の属性<html>タグで、Webページの言語を宣言します。これは、検索エンジンとブラウザを支援するためのものです。

<!DOCTYPE html> <html lang="en-us"> <head>   <title>ページタイトル</title> </head> <body> <h1>これは見出しです</h1> <p>これは段落です</p> </body> </html>


メタデータ

適切な解釈と正しい検索エンジンのインデックス作成を確実にするために、言語と文字エンコーディングの両方<meta charset="charset">HTMLドキュメントのできるだけ早い段階で定義する必要があります。

<!DOCTYPE html> <html lang="en-us"> <head>   <meta charset="UTF-8"> <title>ページタイトル</title> </head>

ビューポートの設定

ビューポートは、Webページのユーザーの可視領域です。デバイスによって異なります。携帯電話では、コンピューターの画面よりも小さくなります。

以下を含める必要があります<meta>すべてのWebページの要素:

<div><meta name="viewport" content="width=device-width, initial-scale=1.0"></div>

これにより、ページのサイズとスケーリングを制御する方法がブラウザーに指示されます。

width=device-width一部は、ページの幅をデバイスの画面幅(デバイスによって異なります)に従うように設定します。 initial-scale=1.0partは、ページがブラウザによって最初にロードされるときの初期ズームレベルを設定します。

これはウェブページの例です*それなし*ビューポートメタタグ、および同じWebページ*と*ビューポートメタタグ:


ヒント:このページを携帯電話またはタブレットで閲覧している場合は、下の2つのリンクをクリックして違いを確認できます。




HTMLコメント

短いコメントは、次のように1行で記述する必要があります。

<!-- This is a comment -->

複数行にわたるコメントは、次のように記述します。

<!--   This is a long comment example. This is a long comment example.   This is a long comment example. This is a long comment example. -->

長いコメントは、2つのスペースでインデントすると見やすくなります。


スタイルシートの使用

スタイルシートへのリンクには単純な構文を使用します(type属性は必要ありません):

<link rel="stylesheet" href="styles.css">

短いCSSルールは、次のように圧縮して記述できます。

p.intro {font-family:Verdana;font-size:16em;}

長いCSSルールは、複数の行にまたがって記述する必要があります。

body {   background-color: lightgrey;   font-family: "Arial Black", Helvetica, sans-serif;   font-size: 16em;   color: black; }
  • 開始ブラケットをセレクターと同じ行に配置します
  • 左括弧の前に1つのスペースを使用します
  • 2つのスペースのインデントを使用する
  • 最後のペアを含め、各プロパティと値のペアの後にセミコロンを使用します
  • 値にスペースが含まれる場合のみ、値を引用符で囲みます
  • 先頭のスペースを入れずに、閉じ括弧を新しい行に配置します

JavaScriptをHTMLに読み込む

外部スクリプトをロードするための単純な構文を使用します(type属性は必要ありません):

<script src="myscript.js">

JavaScriptを使用したHTML要素へのアクセス

「乱雑な」HTMLコードを使用すると、JavaScriptエラーが発生する可能性があります。

これら2つのJavaScriptステートメントは、異なる結果を生成します。

getElementById("Demo").innerHTML = "Hello"; getElementById("demo").innerHTML = "Hello";

自分で試してみる»

JavaScript スタイル ガイドにアクセスする.


小文字のファイル名を使用する

一部のWebサーバー(Apache、Unix)では、ファイル名の大文字と小文字が区別されます。「london.jpg」に「London.jpg」としてアクセスすることはできません。

他のWebサーバー(Microsoft、IIS)は大文字と小文字を区別しません。「london.jpg」には「London.jpg」としてアクセスできます。

大文字と小文字を組み合わせて使用​​する場合は、これに注意する必要があります。

大文字と小文字を区別しないサーバーから大文字と小文字を区別するサーバーに移行すると、小さなエラーでもWeb が壊れてしまいます。

これらの問題を回避するには、常に小文字のファイル名を使用してください。


ファイル拡張子

HTMLファイルには.html拡大(.htm許可されています)。

CSSファイルには.css拡大。

JavaScriptファイルには.js拡大。


.htmと.htmlの違いは?

.htmと.htmlのファイル拡張子に違いはありません。

どちらも、WebブラウザーとWebサーバーによってHTMLとして扱われます。


デフォルトのファイル名

URLの最後にファイル名が指定されていない場合(「https://www.techis.jp/」など)、サーバーは「index.html」、「index.htm」、「 default.html」、または「default.htm」。

サーバーがデフォルトのファイル名として"index.html"だけで構成されている場合、ファイル名は"default.html"ではなく"index.html"でなければなりません。

ただし、サーバーは複数のデフォルトファイル名で構成できます。通常、デフォルトのファイル名はいくつでも設定できます。



プログラミング学習を加速させる

プログラミングをプロの講師に教えてもらいませんか。

テックアイエスのプログラミングスクールは初心者も大歓迎です。年齢制限もありません。転職・副業に強く、挫折させない手厚いサポートで稼ぐ力を身につけましょう!

スクールの詳細