【HTML Living Standard】week属性値の使い方
week属性値の使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
weekプロパティは、HTMLの<input>要素に週を選択する機能を提供するプロパティです。具体的には、<input>要素のtype属性に"week"という値を設定することで、ユーザーが年と週を選択するための特別な入力フィールドが作成されます。このプロパティを持つ入力フィールドは、ブラウザが提供するカレンダーのような専用のユーザーインターフェース（UI）を表示し、直感的な週の選択を可能にします。例えば、プロジェクトの期間指定や、特定の週ごとのデータ入力など、日付選択よりも広い期間を指定したい場合に非常に便利です。
ユーザーが週を選択すると、その選択された値は「YYYY-Www」という形式で送信されます。ここで「YYYY」は年を、「Www」はその年の週番号（例えば、W01は1週目、W52は52週目）を表し、週の数値は常に2桁のゼロ埋め形式で表現されます。これにより、サーバー側で週単位の情報を一貫して、かつ明確に処理できます。
このtype="week"を持つ<input>要素には、他の入力要素と同様にname属性でフォーム送信時の名前を設定したり、id属性で要素を一意に識別したりできます。また、min属性とmax属性を使用することで、ユーザーが選択できる週の範囲を制限できます。例えば、特定の期間内でのみ週を選択させたい場合に有効です。さらに、required属性を指定することで、その入力フィールドを必須項目として設定できます。ブラウザのサポート状況によってはUIのデザインや操作感が異なる場合がありますが、基本的な週選択機能は共通して提供されます。
公式リファレンス: <input type="week">
構文(syntax)
1<input type="week">
引数(parameters)
引数なし
引数はありません
戻り値(return)
戻り値なし
戻り値はありません