宜搭开发包
    正在准备搜索索引...

    星期选择组件

    该组件会根据当前日期自动计算当前星期,并生成相应的选项列表。选项列表为 ["周一", "周二", "周三", "周四", "周五", "周六", "周日"]。 默认值为当前星期。

    层级 (查看层级一览)

    索引

    构造函数

    属性

    fieldId: string = ""

    目标组件的 ID

    offset: number = 0

    毫秒偏移(相较于基准)

    options: { text: string; value: string }[] = []

    组件选项列表,适用于下拉框、单选框等组件

    每个选项包含 text(显示文本)和 value(实际值)两个属性。

    preset: SchoolDaysPreset = {}

    预设配置项,可在实例化时传入,供 main() 方法使用

    value: string = ""

    组件值

    方法

    • 将当前组件与另一个组件进行组合,生成一个新的虚拟组件

      组合逻辑为:将两个组件的值进行连接,生成新的值;将两个组件的选项进行笛卡尔积,生成新的选项列表;目标组件 ID 取当前组件和另一个组件中非空的那个。

      例如,若当前组件的值为 "2023-2024学年",选项为 [{ text: "2023-2024学年", value: "2023-2024学年" }], 另一个组件的值为 "第一学期",选项为 [{ text: "第一学期", value: "第一学期" }],则组合后的虚拟组件的值为 "2023-2024学年第一学期",选项为 [{ text: "2023-2024学年第一学期", value: "2023-2024学年第一学期" }]。

      参数

      返回 Readonly<VirtualComponent>

    • 将当前劫持组件转换为一个虚拟组件,并绑定到指定的目标组件 ID 上

      该方法会创建一个 VirtualComponent 实例,并将当前组件的值、选项和目标组件 ID 注入其中。 返回的 VirtualComponent 可以调用 setDefaultValue()setOptions() 方法,将值和选项注入到目标组件中。

      参数

      • fieldId: string

        目标组件的 ID

      返回 Readonly<VirtualComponent>

    • 组件主逻辑方法,负责生成星期选项列表和默认值

      该方法会根据当前日期计算当前星期,并生成相应的选项列表。选项列表为 ["周一", "周二", "周三", "周四", "周五", "周六", "周日"]。 默认值为当前星期。 其中,星期的计算基准为当前日期加上 offset(默认为 0),即 new Date(T(this.preset).benchmarkDateTime() + this.offset)。 例如,若当前日期为周三,offset = -1 * 24 * 60 * 60 * 1000 则默认值为 "周二";offset = 1 * 24 * 60 * 60 * 1000 则默认值为 "周四"。

      返回 WeekDay

    • 设置星期偏移

      通过设置 offset,可以调整当前星期的计算基准。例如,offset = -1 则表示将当前星期的计算基准往前推 1 天, 适用于需要提前选择星期的场景。

      参数

      • offset: number

        毫秒偏移,例如 offset = -1 * 24 * 60 * 60 * 1000 则将星期计算基准往前推 1 天

      返回 WeekDay