🚧 Under Construction

This component documentation is currently being developed. Some features may be incomplete.

Week Input

View in Pattern Lab

HTML Markup

<input type="week" class="hoo-input-date"  name="my-date-picker-name" value="2021-10-26" min="2018-01-01" max="2030-12-31"    >

Week Input

A specialized date input field for selecting a specific week of the year.

Overview

The week input provides an interface for users to select a specific week number within a year, typically through a specialized picker interface. This ensures consistent date formatting for week selection.

Usage

Week inputs should be used when:

  • The required input is specifically a week number within a year
  • Week-based planning or reporting is needed
  • Precise day-level selection isn’t required

States

  • Default - Normal state
  • Focus - When the input has keyboard focus
  • Disabled - When the input cannot be interacted with
  • Readonly - When the input is read-only

SCSS

Component Import

SCSS Partial Location

CSS Classes

  • .hoo-input-date - Base date input class (shared with other date input types)

Format

The week input value uses the format “YYYY-Www” where “ww” is the week number (e.g., “2025-W25” for the 25th week of 2025).

Week Numbering

Note that week numbering may differ between locales and standards (ISO vs. non-ISO). The HTML input follows ISO 8601 standard where weeks start on Monday and the first week of the year contains January 4th.

Accessibility

  • Always associate with a <label> element
  • Provide clear format instructions if needed
  • Ensure keyboard navigability for the picker interface
  • When disabled, include aria-disabled="true"
  • Consider the needs of users who may prefer direct text entry