文档手册

behavior: calendar

2024-07-18 15:07:11

behavior: calendar

calendar 是允许选择特定日期的日期输入元素。

Elements

默认情况下应用了以下行为:

  • <input type="calendar" /> - 内联日期输入元素。

Model

日历有四种不同的视图模式:

  • 世纪视图模式 - 10 年十年表;

  • 年份视图 - 十年中 10 年的表格;

  • 月视图 - 一年中 12 个月的表格;

  • 天视图 - 一个月中的天数表。

每种模式都用于 <table> 呈现视图的内容。如果您需要以某种特定方式设置日历内容的样式,请使用 DOM 检查器来发现每个视图的 DOM 结构。

Attributes

此行为知道:

  • mode="days" | "months" | "years" | "century" - 初始视图模式。

  • value="YYYY-MM-DD" - 初始日期,ISO 8601 格式的字符串。

  • firstdayofweek="N" - 一周的第一天,N 是一个数字: 0 - 星期日, 1 - 星期一等

Events

除了标准事件集(鼠标、键盘、焦点)行为外:日历还会生成:

  • "input" (SELECT_VALUE_CHANGED) 事件 - 日期已更改。发布(异步)事件。

  • "change" - “input”事件的别名,您可以使用这些名称中的任何一个。

  • "statechange" (UI_STATE_CHANGED) 事件 - 查看模式、当月或当年变化。发布(异步)事件。

Value

日期值或未定义,反映当前选择。

Properties

  • element.calendar.mode :字符串,其中一种 "days" | "months" | "years" | "century" - 获取/设置当前视图模式。

Methods

  • element.calendar.stepDown(\[number\]) - 将值递减 1 或指定数字。根据当前模式,它将前进一天或一个月或一年或十年。

  • element.calendar.stepUp(\[number\]) - 将值递增 1 或指定数字。