仅 chrome(v20+)和 edge(v12+)原生支持,safari(v17.6)和 firefox(v128)降级为普通文本框;值必须严格为 yyyy-w## 格式,javascript 赋值需用 value 而非 valueasdate,且需手动计算周起止日期,移动端和无障碍支持差,建议用双 date 输入或 js 周选择器替代。

week 输入框在 Chrome 和 Edge 中能用,但 Safari 和 Firefox 不支持
直接写 <input type="week"> 在 Safari 和 Firefox 里会降级成普通文本框,连日历弹窗都不会出现。这不是 bug,是标准尚未被全部实现——W3C 规范写了,但浏览器厂商没全跟上。如果你的用户大量使用 macOS 或 iOS 设备,这个控件基本等于不可用。
- Chrome(v20+)、Edge(v12+)支持原生周选择器,点击后弹出带年份和周数的滚动选择面板
- Safari(截至 v17.6)和 Firefox(截至 v128)仍显示为
<input type="text">,无任何增强交互 - 即使支持的浏览器,
value格式也固定为YYYY-W##(如"2024-W26"),不能改、不能本地化显示格式
设置默认值必须用 ISO 周格式,否则清空或提交时可能出错
给 <input type="week"> 设置 value 时,如果填 "2024-06-24" 或 "2024-26",浏览器会静默忽略,输入框显示为空。它只认严格符合 YYYY-W## 的字符串,且周数必须是两位(W01,不是 W1)。
- 正确示例:
<input type="week" value="2024-W26"> - 错误示例:
<input type="week" value="2024-26">(不解析)、<input type="week" value="2024-W1">(周数不足两位,无效) - JavaScript 动态赋值也要注意:用
input.value = "2024-W26",别用input.valueAsDate(该属性对 week 类型返回null)
获取选中周的起止日期得自己算,浏览器不提供
<input type="week"> 只返回字符串,比如 "2024-W26",但你通常需要这周的周一和周日具体日期来做查询或展示。没有内置 API,必须手动解析并计算。
- ISO 周规则:每周从周一算起,第 1 周是包含当年第一个周四的那周
- 简单做法是用
new Date()搭配Date.prototype.getWeek()(需自行实现)或第三方库如date-fns的getISOWeekYear+startOfISOWeek - 最小依赖示例(无库):
function weekStringToDateRange(weekStr) { const [year, week] = weekStr.split('-W').map(Number); const jan1 = new Date(year, 0, 1); const daysToFirstThursday = (4 - jan1.getDay() + 7) % 7; const firstThursday = new Date(jan1); firstThursday.setDate(jan1.getDate() + daysToFirstThursday); const firstWeekStart = new Date(firstThursday); firstWeekStart.setDate(firstThursday.getDate() - 3); const msPerDay = 86400000; const start = new Date(firstWeekStart.getTime() + (week - 1) * 7 * msPerDay); const end = new Date(start.getTime() + 6 * msPerDay); return { start, end }; }
移动端键盘弹出问题和无障碍支持弱,上线前必须真机测试
在 Android Chrome 上点 week 输入框,有时会弹出数字键盘而非周选择器;iOS 上则根本不会触发任何特殊键盘(因为不支持)。同时,该控件的 aria-label 和屏幕阅读器兼容性差,NVDA 和 VoiceOver 对 type="week" 的播报往往只是“编辑文本”,无法传达“请选择一周”语义。
- 替代方案建议:用两个
<input type="date">(开始/结束),或引入轻量级 JS 周选择器(如flatpickr配置mode: "week") - 如果坚持用原生
type="week",至少加 fallback 提示:<span aria-live="polite">当前仅 Chrome/Edge 支持周选择</span> - 不要依赖
:valid伪类做样式反馈——Safari/Firefox 下永远是:valid,因为它们把所有输入都当作文本处理
实际项目里,type="week" 更像一个“锦上添花”的功能,而不是可信赖的表单控件。它的兼容性断层和语义缺失,比看起来更难补救。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











