날짜를 표시하며, 특정 설정에 따라 차단할 수도 있습니다 (제한 구간에 커스텀 스타일을 적용 가능).
config | object | 표시하거나 차단할 시간 구간을 정의하는 설정 객체 |
number | 추가된 시간 구간의 ID |
//날짜 표시
scheduler.addMarkedTimespan({
days: 5, // 매주 금요일 표시
zones: "fullday", // 하루 종일 표시
css: "gray_section" // 적용할 CSS 클래스
});
scheduler.updateView();
//날짜 표시 및 차단
scheduler.addMarkedTimespan({
days: 5,
zones: "fullday",
css: "gray_section",
type: "dhx_time_block" // 고정된 값입니다
});
scheduler.updateView();
이 메서드는 버전 3.5부터 사용할 수 있습니다.
이 메서드를 사용하려면 limit 플러그인이 활성화되어 있어야 합니다.
이 메서드를 호출한 직후에는 표시(차단)가 즉시 적용되지 않습니다. 변경 사항을 적용하려면 updateView를 호출해야 합니다.
설정 객체는 다음 속성들을 포함할 수 있습니다:
속성 | 설명 |
---|---|
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 |
시간 구간에 대한 DIV를 렌더링하려면 updateView 호출 필요 | 시간 구간에 대한 DIV를 자동으로 그림 |
시간 구간이 무기한 지속됨 | 앱 내 내부 업데이트 후 즉시 시간 구간이 숨겨짐 |
설정된 시간 구간의 ID를 반환 | DIV 요소 또는 DIV 배열을 반환 |