通过应用默认或自定义样式来高亮或阻止特定日期。高亮会在应用内部任何更新后立即移除。此功能适用于强调某些日期。
config | object | 要标记或阻止的时间段的配置详情 |
array | 返回一个 HTML 元素数组 |
//高亮特定日期
scheduler.markTimespan({
days: 5, // 高亮每周五
zones: "fullday", // 高亮全天
css: "gray_section" // 应用的 CSS 类
});
//高亮并阻止特定日期
scheduler.markTimespan({
days: 5,
zones: "fullday",
css: "gray_section",
type: "dhx_time_block" // 固定值,用于阻止该时间段
});
该方法自版本 3.5 起可用。
该方法需要启用 limit 插件。
配置对象支持以下属性:
属性 | 说明 |
---|---|
start_date | 一个 Date 对象,指定限制开始时间 |
|
|
end_date | 一个 Date 对象,指定限制结束时间 |
|
|
days | 要限制的日期 |
|
|
zones | 要限制的时间段,单位为分钟 |
|
|
css | 要应用的 CSS 类名 |
|
|
html | 在标记范围内显示的 HTML 内容 |
|
|
type | 指定时间段的类型。设置为 'dhx_time_block' 时会阻止该时间段。其他值仅标记时间段,不阻止 |
|
|
invert_zones | 是否反转由 'zones' 设置的时间段(默认 false) |
|
|
sections | 限制阻止仅针对特定视图中的特定项。阻止仅在相关视图内生效 |
|
请注意,days、zones 与 start_date、end_date 是成对定义阻止区间的,不应混用。 例如,不能将 zones 与 start_date 一起使用,也不能同时将 days 与 start_date 和 end_date 组合。
有效的属性组合有两种:
属性组合 | 示例 |
---|---|
|
|
|
addMarkedTimespan | markTimespan |
需要调用 updateView 方法来渲染时间段的 DIV | 自动渲染时间段的 DIV |
时间段会永久显示 | 应用内部任何更新后,时间段会立即隐藏 |
返回创建的时间段 ID | 返回一个 DIV 或 DIV 数组 |