宜搭+
    正在准备搜索索引...

    年级选择组件。

    该组件基于 Utils.SchoolDays 计算当前年级,并生成以当前年级 为起始、向前推 range 年的选项列表。 显示文本与实际值的格式由 mode 控制:

    • "a"(绝对模式):显示文本与实际值均为 "YYYY级"
    • "r"(相对模式):显示文本为 "一年级""二年级" 等,实际值为 "YYYY级"

    26.7.1

    层级 (查看层级一览)

    索引

    构造函数

    属性

    fieldId: string = ""

    目标组件的字段标识。

    该字段标识用于在 HijackedComponent.infectHijackedComponent.compose 方法中指定需要被改造的目标宜搭组件。

    26.7.1

    mode: "r" | "a" = "a"

    年级显示模式。

    • "a":绝对年级模式,显示文本与实际值均为 "YYYY级"
    • "r":相对年级模式,显示文本为 "一年级""二年级" 等。

    默认值为 "a"

    26.7.1

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

    组件的选项列表。

    每个选项包含 text(显示文本)与 value(实际值)两个字段,适用于 下拉框、单选框等宜搭组件。该列表通常由 HijackedComponent.main 方法计算得出,并通过 VirtualComponent.setOptions 注入到目标组件中。

    26.7.1

    preset: SchoolDaysPreset = {}

    时间语义化预设配置项。

    该配置项在实例化时传入,供 HijackedComponent.main 方法使用, 用于控制学年、学期、周次等时间相关组件的计算基准。

    26.7.1

    range: number = 6

    年级选项跨越的年份数量。

    默认值为 6。有效取值范围为 [1, 9]

    26.7.1

    value: string = ""

    组件的默认值。

    该值通常由 HijackedComponent.main 方法计算得出,并通过 VirtualComponent.setDefaultValue 注入到目标组件中。

    26.7.1

    方法

    • 切换为相对年级显示模式。

      切换后,选项的显示文本将变为 "一年级""二年级" 等, 但实际值仍保持 "YYYY级" 格式。

      返回 Grade

      当前组件实例,支持链式调用。

      26.7.1

    • 设置年级选项跨越的年份数量。

      仅当传入值位于闭区间 [1, 9] 内时才会更新;否则保持原值。

      参数

      • range: number

        跨越年份数量。

      返回 Grade

      当前组件实例,支持链式调用。

      26.7.1