HTML5タグ虎の巻

input type="week"タグ

HTML5

input type="week"は、週の入力欄を作成するタグです。

解説

input type="week"を使うと、週の入力をチェックする入力欄を作成することができます。
週とは、対象年の第何週かという値です。(1週~53週)

HTML5に対応していないブラウザでは使用できないためご注意ください。
(対応していないブラウザの場合、普通のテキストボックスとして表示されます。)

コンテンツ・モデル

カテゴリー
(自カテゴリ)
フロー・コンテンツ
フレージング・コンテンツ
インタラクティブ・コンテンツ
コンテキスト
(親カテゴリ)
フレージング・コンテンツを許可する場所
コンテンツ・モデル
(子カテゴリ)
なし

属性

input(type="week")タグには以下の属性が指定できます。

【属性】
属性説明
name名前を指定する(submit時にこの名前で送信される)
(例)name="week01"
value値を指定する
(例)value="2019-W15"
min入力を許可する最小値を指定する
(例)min="2019-W1"
max入力を許可する最大値を指定する
(例)max="2020-W52"
stepステップ値を指定する(週単位)
(例)2週間単位とする⇒step="2"
 ※ステップ値とは値の刻みです。2だと 2、4、6… が入力可能です。
readonly読取専用にする
(例)readonly="readonly"
 ※readonlyのみでもOKです。
required必須入力であることを指定する
(例)required="required"
 ※requiredのみでもOKです。
【主要グローバル属性】
属性説明
classクラスを指定する
(例)class="hoge"
idIDを指定する
(例)id="foo"
styleスタイルを指定する
(例)style="color:red;"
titleツールチップを指定する
(例)title="補足情報です"
tabindexTabキーによる移動の順番を指定する
 正数:指定した数値の順にフォーカス移動される
 負数:フォーカスは可能だが、タブ移動時はフォーカス対象とならない
(例)tabindex="10"

その他のグローバル属性値については、グローバル属性をご覧ください。

サンプル

週の入力欄を作成する(初期値:2019年 第5週)

<input type="week" name="week01" value="2019-W05">

週の入力欄を作成する(入力可能範囲:2019年10週~2020年20週)

<input type="week" name="week02" min="2019-W10" max="2020-W20">

範囲を超えた入力をすると、submit時にチェックがかかります。

週の入力欄を作成する(ステップ:2週間)

<input type="week" name="week03" value="2019-W05" step="2">

step値のチェックはsubmit時に行われます。

週の入力欄を作成する(必須)

<input type="week" name="week04" required="required">

未入力だと、submit時にチェックがかかります。

備考

  • value値のフォーマットは、YYYY-Wxxです。(例:2019年5週 ⇒ "2019-W5")
  • input(type="week")は、HTML5から新たに追加になったタグです。

関連項目