bricks/docs/zh/period.md

PeriodDays

控件功能：用于显示一个可点击的日期区间（开始日期和结束日期），用户可以通过点击日期来前后调整时间段，支持按天、月、年为单位进行步进或回退。常用于时间范围选择场景。
类型：容器控件
父类控件：bricks.HBox

初始化参数

参数名	类型	说明
start_date	string	初始开始日期，格式为 "YYYY-MM-DD"
end_date	string	初始结束日期，格式为 "YYYY-MM-DD"
step_type	string	步长类型，可选值为 'days'、'months'、'years'，默认为 'days'
step_cnt	number	每次变化的步长数量，默认为 1
title	string	可选标题文本，会显示在控件前
splitter	string	分隔符，用于分隔开始日期和结束日期，默认为 ' 至 '

注：splitter 和 step_cnt 若未传入则使用默认值。

主要事件

changed

• 触发时机：当用户点击开始日期或结束日期，导致时间区间发生变化时触发。
• 事件数据：

  {
    start_date: "YYYY-MM-DD", // 变化后的开始日期
    end_date: "YYYY-MM-DD"   // 变化后的结束日期
  }
  

• 说明：可通过 bind('changed', callback) 监听该事件，获取更新后的日期范围。