API overview
Scheduler methods
| Name | Description |
|---|---|
| DataProcessor | DataProcessor 생성자 |
| Promise | Promise 객체를 생성하는 생성자 |
| addEvent | 새 이벤트를 추가합니다 |
| addEventNow | 새 이벤트를 생성하고 확인을 위한 라이트박스를 엽니다. |
| addMarkedTimespan | 날짜를 표시하며, 특정 설정에 따라 차단할 수도 있습니다 (제한 구간에 커스텀 스타일을 적용 가능). |
| addSection | 현재 활성화된 뷰에 새 섹션을 추가합니다. |
| addShortcut | 새로운 키보드 단축키를 생성합니다 |
| alert | 알림 메시지 박스를 표시합니다 |
| assert | 주어진 표현식이 false일 경우, 화면 오른쪽 상단에 빨간색 팝업으로 errorMessage가 표시됩니다. |
| attachEvent | DhtmlxScheduler의 내부 이벤트에 핸들러를 연결합니다. |
| backbone | Backbone 모델의 모든 업데이트와 스케줄러 간의 동기화를 유지하며, 그 반대 방향도 지원합니다. |
| batchUpdate | 여러 이벤트를 한 번에 업데이트합니다 |
| bind | 지정된 값으로 this 키워드가 설정된 새로운 함수를 생성합니다. |
| blockTime | 지정된 날짜를 차단하고 기본 'dimmed' 스타일을 적용합니다. |
| callEvent | 내부 이벤트를 트리거합니다 |
| changeEventId | 이벤트의 id를 업데이트합니다. |
| checkCollision | 주어진 이벤트가 동일 시간대에 존재하는 다른 이벤트와 겹치는지 확인합니다. |
| checkEvent | 특정 이벤트에 핸들러가 할당되어 있는지 확인합니다 |
| checkInMarkedTimespan | 특정 타입의 타임스팬 내에 이벤트가 포함되는지 여부를 결정합니다 |
| checkLimitViolation | 주어진 이벤트가 차단된 시간 구간과 겹치는지 여부를 결정합니다. |
| clearAll | 스케줄러 에서 모든 이벤트를 제거합니다. |
| closeAllSections | 현재 활성화된 뷰에서 모든 섹션을 닫습니다. |
| closeSection | 현재 활성 뷰 내에서 특정 섹션을 닫습니다. |
| collapse | 스케줄러를 확장된 상태에서 일반 크기로 되돌립니다. |
| confirm | Confirm 메시지 박스를 엽니다 |
| copy | 주어진 객체의 깊은 복사본을 생성합니다. |
| createDataProcessor | 새로운 dataProcessor 인스턴스를 생성하고 이를 scheduler에 연결합니다. |
| createGridView | 스케줄러 내에서 Grid 뷰를 설정합니다. |
| createTimelineView | 스케줄러에서 Timeline 뷰를 설정합니다. |
| createUnitsView | 스케줄러 내에서 Units 뷰를 설정합니다. |
| defined | 인수가 undefined일 경우 false를 반환하며, 그렇지 않으면 true를 반환합니다. |
| deleteAllSections | 활성 뷰에서 모든 섹션을 제거합니다. |
| deleteEvent | 지정된 이벤트를 제거합니다. |
| deleteMarkedTimespan | AddMarkedTimespan() 메서드를 사용해 생성된 마킹 또는 차단을 제거합니다. |
| deleteSection | 현재 활성화된 뷰에서 섹션을 제거합니다. |
| destroyCalendar | 이전에 생성된 미니 캘린더를 제거합니다. |
| destructor | 스케줄러 인스턴스를 제거합니다 |
| detachEvent | 이전에 attachEvent 메서드를 사용하여 추가한 이벤트 핸들러를 제거합니다. |
| edit | 이벤트 박스 내에서 이벤트의 텍스트를 직접 변경할 수 있도록 인라인 에디터를 엽니다. |
| editStop | 인라인 이벤트 에디터가 열려 있을 때 종료합니다. |
| endLightbox | 라이트박스를 닫을 때 사용됩니다. |
| event | HTML 요소에 이벤트 핸들러를 설정합니다. |
| eventRemove | HTML 요소에서 이벤트 핸들러를 제거합니다. |
| expand | 더 나은 가시성을 위해 스케줄러를 전체 화면으로 확장합니다. |
| exportToPDF | Scheduler를 PDF 포맷으로 내보냅니다. |
| exportToPNG | Scheduler를 PNG 이미지로 내보낼 수 있습니다. |
| focus | 스케줄러에 focus를 활성화합니다. |
| formSection | 라이트박스 섹션 객체에 접근할 수 있습니다. |
| getActionData | 현재 커서 아래에 있는 날짜와 섹션을 반환합니다. 해당 항목이 없을 경우에는 반환하지 않습니다. |
| getEvent | 주어진 id에 해당하는 이벤트 객체를 제공합니다. |
| getEventEndDate | 이벤트의 종료 날짜를 가져옵니다 |
| getEventStartDate | 이벤트의 시작 날짜를 가져옵니다 |
| getEventText | 이벤트와 연관된 텍스트를 가져옵니다 |
| getEvents | 지정된 기간 내에 발생하는 이벤트 컬렉션을 반환합니다. |
| getLabel | 라이트박스 내 select 컨트롤의 레이블을 가져옵니다. |
| getLightbox | 라이트박스의 HTML 요소를 가져옵니다 |
| getRecDates | 반복 이벤트의 모든 발생일을 가져옵니다 |
| getRenderedEvent | 현재 표시되고 있는 이벤트의 HTML 요소를 반환합니다. |
| getSection | 현재 활성화된 뷰 내 특정 섹션의 객체를 가져옵니다. |
| getShortcutHandler | 키 내비게이션 shortcut에 대한 핸들러를 가져옵니다 |
| getState | 스케줄러의 현재 상태를 가져옵니다. |
| getUserData | 특정 이벤트에 연결된 사용자 데이터를 가져옵니다 |
| getView | 이름을 기반으로 뷰 객체를 반환합니다. 이름이 지정되지 않으면 현재 뷰를 반환합니다. |
| hideCover | 화면의 나머지 부분과의 상호작용을 차단하는 라이트박스 모달 오버레이를 제거합니다. |
| hideLightbox | 변경 사항을 저장하지 않고 라이트박스를 닫습니다. |
| hideQuickInfo | 현재 열려 있는 경우 팝업 이벤트 폼을 숨깁니다. |
| highlightEventPosition | 타임라인에서 이벤트의 기간을 표시합니다. |
| init | DhtmlxScheduler 인스턴스를 생성하는 생성자입니다. |
| invertZones | 주어진 타임존을 반전시킵니다. |
| isCalendarVisible | 스케줄러에서 캘린더가 현재 표시되고 있는지 식별합니다. |
| isOneDayEvent | 주어진 이벤트가 하루만 지속되는지 아니면 여러 날에 걸치는지 판단합니다. |
| isViewExists | 지정된 이름의 뷰가 존재하는지 확인합니다. |
| linkCalendar | 이 메서드는 스케줄러에서 활성 날짜가 변경될 때마다 미니 캘린더의 활성 날짜를 업데이트합니다. |
| load | 외부 소스에서 스케줄러로 데이터를 로드합니다. |
| markCalendar | 특정 날짜에 CSS 클래스를 추가합니다. |
| markTimespan | 기본 스타일이나 사용자 정의 스타일을 적용하여 특정 날짜를 하이라이트하거나 차단합니다. 하이라이트는 앱 내에서 내부 업데이트가 발생하면 즉시 제거됩니다. 특정 날짜를 강조할 때 유용합니다. |
| message | 선택한 유형의 message 박스를 엽니다 |
| mixin | 'source' 객체의 속성을 'target' 객체에 병합합니다. |
| modalbox | Modalbox를 엽니다 |
| openAllSections | 현재 활성화된 뷰에서 모든 섹션을 엽니다 (이 메서드는 뷰가 'Tree' 모드인 Timeline일 때만 작동하며, 그렇지 않으면 무시됩니다) |
| openSection | 현재 활성 화된 뷰 내에서 특정 섹션을 엽니다 (활성 뷰가 'Tree' 모드의 Timeline인 경우에만 작동하며, 그렇지 않으면 메서드는 무시됩니다) |
| parse | 클라이언트 측 리소스에서 데이터를 로드하는 기능을 처리합니다. |
| plugins | 선택한 extensions를 활성화합니다. |
| removeShortcut | 키보드 단축키를 제거합니다 |
| render | 스케줄러 디스플레이를 새로 고칩니다 |
| renderCalendar | 컴팩트한 캘린더를 생성합니다 |
| renderEvent | 커스텀 이벤트 박스의 HTML 콘텐츠를 생성합니다 |
| resetLightbox | 현재 라이트박스의 HTML 객체 요소를 제거합니다. |
| scrollUnit | Units 뷰에서 지정된 단위 수만큼 스크롤합니다. |
| select | 지정한 이벤트를 선택합니다. |
| serialize | 스케줄러에 현재 로드된 모든 이벤트를 serialize합니다. |
| serverList | Units, Timeline 뷰 또는 Lightbox에 로드할 수 있는 이름이 지정된 컬렉션을 정의합니다. |
| setCurrentView | 선택한 뷰와 날짜를 표시합 니다. |
| setEvent | 스케줄러의 데이터 풀에 새 이벤트를 추가합니다. |
| setEventEndDate | 이벤트의 종료 날짜를 업데이트합니다. |
| setEventStartDate | 이벤트의 시작 날짜를 업데이트합니다. |
| setEventText | 특정 이벤트의 텍스트를 업데이트합니다 |
| setLightboxSize | 라이트박스 크기를 업데이트합니다. |
| setLoadMode | 데이터를 부분적으로 로드하는 모드를 설정하여 동적 로딩을 가능하게 합니다. |
| setSkin | 현재 활성 스킨을 변경합니다 |
| setUserData | 특정 이벤트에 사용자 데이터를 할당합니다 |
| showCover | 화면의 나머지 부분과의 상호작용을 차단하는 라이트박스 모달 오버레이를 표시합니다. |
| showEvent | 현재 또는 선택된 뷰에서 지정된 이벤트를 표시하고 하이라이트합니다. |
| showLightbox | 주어진 이벤트에 대한 라이트박스를 엽니다. |
| showQuickInfo | 주어진 이벤트에 대한 팝업 이벤트 폼을 엽니다. |
| startLightbox | 지정한 HTML 컨테이너 내에 커스텀 라이트박스를 화면 중앙에 표시합니다. |
| toICal | 스케줄러 데이터를 ICal 포맷으로 변환합니다. |
| toJSON | 스케줄러의 데이터를 JSON 형식의 문자열로 변환합니다. |
| toPDF | 현재 뷰를 PDF 문서로 내보내는 기능으로, 인쇄할 때 유용합니다. |
| toPDFRange | 여러 스케줄러 뷰를 PDF 문서로 내보내기 (인쇄용으로 유용) |
| toXML | 스케줄러의 데이터를 XML 포맷으로 변환합니다 |
| uid | 현재 스케줄러 인스턴스 내에서 고유함이 보장되는 유니크 ID를 생성합니다 (전역 GUID가 아님). |
| unblockTime | 이전의 blockTime() 메서드로 설정된 블록을 제거합니다. |
| unmarkCalendar | 지정된 날짜에서 CSS 클래스를 제거합니다. |
| unmarkTimespan | MarkTimespan() 메서드로 적용된 표시 또는 차단을 해제합니다 |
| unselect | 지정된 이벤트에서 선택을 제거합니다. |
| updateCalendar | 미니 캘린더에 선택한 날짜를 표시합니다 |
| updateCollection | 지정된 컬렉션을 새로운 옵션으로 업데이트합니다. |
| updateEvent | 지정된 이벤트를 수정합니다. |
| updateView | 지정된 뷰와 날짜를 이벤트를 발생시키지 않고 표시합니다. |
Scheduler properties
| Name | Description |
|---|---|
| active_link_view | 월간 보기에서 날짜 숫자를 클릭 가능한 링크로 표시하여 선택한 뷰에서 해당 날짜를 열 수 있게 합니다. |
| agenda_end | 이벤트가 표시되는 종료 날짜를 정의합니다. |
| agenda_start | 이벤트가 표시되기 시작하는 날짜를 지정합니다. |
| ajax_error | XML 데이터 로딩 실패 시 기본 에러 알림이 표시되는 방식을 정의합니다 |
| all_timed | 'short' 옵션은 멀티데이 이벤트를 일반적인 형식으로 표시합니다 (1일 이벤트가 표시되는 방식과 유사). |
| api_date | api_date 템플릿에서 사용되는 날짜 형식을 설정합니다. |
| auto_end_date | 시작 날짜가 조정될 때 이벤트의 종료 날짜를 자동으로 업데이트합니다. |
| buttons_left | 라이트박스 하단 왼쪽 코너에 위치한 버튼 세트를 보유합니다. |
| buttons_right | 라이트박스의 오른쪽 하단에 위치한 버튼 세트를 포함합니다 |
| cascade_event_count | 캐스케이드에 표시되는 최대 이벤트 수를 정의합니다. |
| cascade_event_display | 'cascade' 표시 모드를 활성화합니다. |
| cascade_event_margin | 연속적으로 표시되는 이벤트들의 왼쪽 마진을 정의합니다. |
| check_limits | 제한 검사 기능을 켜거나 끕니다. |
| collision_limit | 단일 시간 슬롯에 허용되는 최대 이벤트 수를 정의합니다 |
| container_autoresize | 스케줄러 컨테이너가 전체 내용을 스크롤 없이 모두 표시할 수 있도록 자동으로 크기를 조절합니다. |
| csp | 날짜 포맷팅 메서드가 내부적으로 어떻게 구현되는지를 지정합니다. |
| date_format | 데이터 세트에서 데이터를 파싱하고 서버로 날짜를 전송할 때 사용하는 날짜 형식을 정의 합니다. |
| day_column_padding | 뷰 컬럼에 패딩을 추가합니다 |
| day_date | 주간(Week) 및 단위(Units) 뷰의 X축에 사용되는 날짜 형식을 지정합니다. |
| dblclick_create | 사용자가 더블클릭하여 이벤트를 생성할 수 있도록 합니다 |
| default_date | 템플릿 'day_date', 'week_date', 'day_scale_date'가 뷰 헤더에 날짜를 표시할 때 사용하는 날짜 형식을 정의합니다. |
| delay_render | updateView 및 setCurrentView 호출(스케줄러의 재렌더링을 트리거하는)을 감싸는 타임아웃(밀리초 단위)을 설정합니다. |
| details_on_create | 드래그하거나 더블 클릭하여 새 이벤트를 생성할 때 확장된 폼을 사용할 수 있도록 합니다. |
| details_on_dblclick | 이벤트를 더블 클릭하여 라이트박스를 열 수 있도록 설정합니다. |
| display_marked_timespans | 스케줄러에서 표시된(차단된) 시간 구간이 하이라이트되는지 여부를 제어합니다. |
| displayed_event_color | ShowEvent() 메서드로 표시되는 이벤트의 기본 배경색을 정의합니다. |
| displayed_event_text_color | ShowEvent() 메서드로 표시되는 이벤트의 기본 글자색을 정의합니다. |
| drag_create | 드래그 앤 드롭으로 새 이벤트를 생성할 수 있습니다. |
| drag_event_body | 이벤트 본문의 아무 부분이나 잡아서 스케줄러 이벤트를 드래그할 수 있게 합니다. |
| drag_highlight | 이 옵션은 스케줄러에서 이벤트를 드래그할 때 시간 축 상에서 이벤트의 시작 지점과 지속 시간을 하이라이트합니다. |
| drag_in | 드래깅 이벤트가 드래그를 시작한 스케줄러 내에서만 이동할 수 있도록 제한하여, 서로 다른 스케줄러 간의 이벤트 이동을 방지합니다. |
| drag_lightbox | 라이트박스를 헤더를 통해 드래그할 수 있도록 허용합니다. |
| drag_move | Drag-and-drop을 사용하여 이벤트의 위치를 변경할 수 있습니다. |
| drag_out | 이 스케줄러에서 다른 스케줄러로 이벤트가 드래그되는 것을 방지합니다. |
| drag_resize | 드래그 앤 드롭을 사용하여 이벤트 크기를 조절할 수 있습니다. |
| edit_on_create | 새 이벤트 생성 시 라이트박스를 열 수 있도록 설정합니다. |
| event_attribute | 이벤트의 HTML 요소를 id로 식별하는 데 사용되는 속성 이름을 정의합니다. |
| event_duration | 이벤트의 초기 지속 시간을 분 단위로 설정합니다. |
| first_hour | 시간 눈금(Y축)의 시작 시간을 정의합니다. |
| fix_tab_position | 뷰의 탭을 왼쪽에서 오른쪽으로 이동합니다. |
| full_day | 이벤트를 하루 종일 지속되도록 설정할 수 있습니다. |
| header | 스케줄러 헤더(네비게이션 패널) 레이아웃을 설정합니다. |
| highlight_displayed_event | ShowEvent 메서드로 가져온 이벤트가 표시될 때 하이라이트되는지 여부를 결정합니다. |
| hour_date | Y축에 표시되는 시간 형식을 정의합니다. 기본 이벤트 및 라이트박스 템플릿에서도 시간 부분을 포맷하는 데 사용됩니다. |
| hour_size_px | 시간 블록의 높이를 픽셀 단위로 정의합니다 |
| icons_edit | 이벤트 박스 내의 사이드 편집 메뉴에 표시되는 아이콘 세트를 보유합니다. |
| icons_select | 이벤트 박스의 사이드 선택 메뉴에 표시되는 아이콘 세트를 유지합니다. |
| include_end_by | 'End by' 필드에 입력된 날짜를 배타적(exclusive)으로 처리할지 포함적(inclusive)으로 처리할지 설정합니다. |
| key_nav | 스케줄러에서 키보드 내비게이션을 활성화합니다. |
| key_nav_step | 이벤트를 탐색할 때 사용하는 최소 단계 크기(분 단위)를 설정합니다 |
| last_hour | Y축의 시간 스케일 상한을 정의합니다. |
| left_border | 스케줄러에서 점선 왼쪽 테두리를 활성화합니다 |
| lightbox | Lightbox 객체를 지정합니다 |
| lightbox_recurring | 반복 이벤트를 편집할 때 라이트박스의 동작 방식을 제어합니다. |
| limit_drag_out | 스케줄러의 보이는 영역을 벗어나서 이벤트를 드래그하는 것을 방지합니다. |
| limit_end | 허용된 날짜 범위의 종료 경계를 정의합니다. |
| limit_start | 허용된 날짜 범위의 시작 경계를 설정합니다. |
| limit_time_select | 라이트박스의 시간 선택기를 'last_hour'와 'first_hour' 옵션에 따라 최대값과 최소값으로 제한합니다. |
| limit_view | 사용자가 이벤트를 탐색할 수 있는 날짜 범위를 제한합니다. |
| load_date | 동적 로딩 시 서버 요청 파라미터 'from'과 'to'의 형식을 정의합니다. |
| map_end | 이벤트가 표시되는 날짜의 마지막을 정의합니다. |
| map_error_position | 이벤트의 위치를 확인할 수 없을 때 지도에 표시되는 위치를 정의합니다 |
| map_infowindow_max_width | Map 뷰에서 팝업 마커의 최대 너비를 설정합니다. |
| map_initial_position | 지도의 시작 위치를 설정합니다 |
| map_initial_zoom | Map 뷰에서 지도의 시작 줌 레벨을 설정합니다. |
| map_resolve_event_location | 이벤트의 좌표가 데이터베이스에 저장되어 있지 않은 경우 자동으로 위치를 확인하려는 시도를 활성화합니다. |
| map_resolve_user_location | 사용자가 지도에 위치를 표시하기 위해 위치 공유를 요청받을지 여부를 제어합니다. |
| map_settings | 맵과 관련된 구성 옵션을 포함합니다 |
| map_start | 이벤트가 표시되기 시 작할 날짜를 지정합니다 |
| map_type | Google Maps의 타입을 정의합니다 |
| map_view_provider | 사용할 지도 제공자를 정의합니다 |
| map_zoom_after_resolve | 브라우저가 위치 권한 요청 시 사용자 위치를 표시할 줌 레벨을 설정하며, 사용자가 동의할 경우 적용됩니다. |
| mark_now | 현재 시간을 나타내는 마커를 켜거나 끕니다. |
| max_month_events | 한 셀에 표시되는 최대 이벤트 수를 제어합니다 |
| min_grid_size | Grid 뷰가 자동 크기 조정 시 축소될 수 있는 최소 크기를 정의합니다. |
| min_map_size | Autoresizing 시 Map 뷰가 축소될 수 있는 최소 크기를 정의합니다 |
| minicalendar | 미니 캘린더 객체를 정의합니다. |
| month_date | 월 보기 헤더의 형식을 정의합니다 |
| month_day | 월 및 연도 뷰의 셀에 표시되는 날짜 형식을 정의합니다. |
| month_day_min_height | Month 뷰에서 셀의 최소 높이를 설정합니다. |
| multi_day | 여러 날에 걸친 이벤트를 표시할 수 있도록 합니다. |
| multi_day_height_limit | 멀티 데이 이벤트가 표시되는 섹션의 높이를 제어합니다. |
| multisection | Timeline 또는 Units 뷰에서 동일한 이벤트를 여러 섹션에 걸쳐 렌더링할 수 있도록 합니다. |
| multisection_shift_all | Timeline 또는 Units 뷰에서 여러 섹션에 할당된 이벤트를 드래그할 때, 모든 인스턴스를 함께 이동할지('true') 아니면 선택한 하나만 이동할지('false')를 제어합니다. |
| now_date | Limit 확장 기능에서 현재 시간 표시기의 날짜를 설정합니다 (- mark_now 설정을 통해 활성화됨) |
| occurrence_timestamp_in_utc | 시간대 걱정 없이 반복 이벤트를 처리할 수 있게 해줍니다. |
| overwrite_marked_timespans | 마크된 타임스팬의 차단 우선순위 제어 |
| parse_exact_format | 스케줄러가 파싱 시 날짜 형식을 엄격하게 일치시키도록 제어합니다. |
| positive_closing | 사용자가 이벤트 박스 내에서 이벤트 텍스트를 직접 편집할 때 '저장' 동작을 제어합니다. |
| preserve_length | 비선형 타임 스케일에서 이벤트를 드래그할 때 보이는 길이를 동일하 게 유지합니다. |
| preserve_scroll | 동일한 뷰 내에서 날짜를 이동할 때 현재 스크롤 위치를 유지하지 않음 |
| prevent_cache | 브라우저에서 GET 요청 캐싱을 활성화할지 비활성화할지 제어합니다. |
| quick_info_detached | 이벤트 폼이 화면의 왼쪽/오른쪽에서 나타날지, 선택된 이벤트 바로 옆에 나타날지를 제어합니다. |
| readonly | 스케줄러의 읽기 전용 모드를 활성화합니다. |
| readonly_form | 라이트박스에 읽기 전용 모드를 활성화합니다. |
| recurring_overflow_instances | 다음 달로 넘어가는 반복 이벤트 처리 방식을 제어합니다 |
| recurring_workdays | "Every workday" 옵션이 라이트박스에서 선택되었을 때 반복 이벤트에 대해 어떤 요일이 근무일로 간주되는지를 정의합니다. |
| repeat_date | 'recurring' 라이트박스 내 'End by' 필드에 사용되는 날짜 형식을 지정합니다. |
| repeat_precise | 'weekly' 반복 설정 시 과거 날짜를 이벤트에 포함하지 않도록 합니다. |
| resize_month_events | 드래그 앤 드롭을 사용하여 Month 뷰에서 며칠간 계속되는 이벤트의 크기를 조절할 수 있게 합니다. |
| resize_month_timed | 월별 뷰에서 단일 날짜 이벤트를 드래그 앤 드롭으로 크기 조절할 수 있도록 허용합니다 |
| responsive_lightbox | 라이트박스가 작은 화면에서도 부드럽게 조정되도록 활성화합니다 |
| rtl | 스케줄러에서 RTL(오른쪽에서 왼쪽) 모드를 활성화합니다. |
| scroll_hour | 스케줄러에서 24시간 형식의 시간에 따라 시작하는 세로 스크롤 위치를 정의합니다. |
| section_delimiter | 이벤트의 관련 데이터 속성 내에서 여러 섹션 또는 단위를 구분하기 위해 사용하는 구분자를 정의합니다. |
| select | 이벤트 박스 내에서 select 바의 표시 여부를 토글합니다. |
| separate_short_events | 짧은 이벤트가 겹치는 것을 방지하는 데 도움을 줍니다. |
| server_utc | 서버와 데이터를 주고받을 때 서버 측 날짜를 UTC와 로컬 타임존 간에 변환할 수 있도록 합니다. |
| show_errors | 문제가 발생했을 때 에러 알림 팝업을 켭니다 |
| show_loading | 데이터 로딩 중에 진행 표시기나 스피너를 표시합 니다. 이는 동적 로딩 시나리오에 유용합니다. |
| show_quick_info | 'quick_info' 확장 기능(작업 세부 정보를 보여주는 팝업)을 켜거나 끕니다. |
| start_on_monday | 주의 시작 요일을 설정합니다 |
| time_step | 이벤트 시간 값의 최소 증가 단위(분)를 설정합니다. |
| timeline_swap_resize | 이벤트의 종료일이 시작일보다 이전으로 이동할 경우, 리사이징 중에 종료일과 시작일이 서로 교환될 수 있도록 허용합니다. |
| tooltip_hide_timeout | 툴팁이 사라지기 전에 얼마나 오래 표시될지(밀리초 단위) 설정합니다. |
| tooltip_offset_x | 툴팁의 위치를 수평으로 조정하며, 양수 값일 경우 오른쪽으로 이동합니다. |
| tooltip_offset_y | 값이 양수일 때 top 오프셋을 설정하여 tooltip의 수직 위치를 조정합니다. |
| tooltip_timeout | 작업에 대한 tooltip이 나타나기까지 걸리는 시간(밀리초 단위)을 정의합니다 |
| touch | 스케줄러에서 터치 지원을 켜거나 끕니다. |
| touch_drag | 롱 터치 제스처와 스크롤 제스처를 구분하는 지속 시간을 밀리초 단위로 설정합니 다. |
| touch_swipe_dates | 모바일 기기에서 가로 스와이프 제스처로 활성 날짜를 전환하는 기능을 켜거나 끌 수 있습니다. |
| touch_tip | 화면 오른쪽 상단에 프롬프트 메시지가 표시되는지 여부를 제어합니다. |
| touch_tooltip | DhtmlxScheduler의 툴팁을 터치 디바이스에서 표시할 수 있도록 활성화합니다. |
| undo_deleted | 이벤트 삭제 후 나타나는 Undo 팝업을 활성화합니다. |
| update_render | 스케줄러가 모든 동작 후에 완전히 다시 그려지는지 여부를 제어합니다. |
| use_select_menu_space | 이 옵션은 이벤트가 셀의 전체 너비를 차지하는지 여부를 정의합니다. |
| wai_aria_application_role | 메인 스케줄러 컨테이너와 미니캘린더 요소에 role="application"이 할당되어야 하는지 지정합니다. |
| wai_aria_attributes | WAI-ARIA 지원을 활성화하여 컴포넌트가 스크린 리더에 의해 인식될 수 있도록 합니다. |
| week_agenda_select | Week Agenda 뷰에서 선택된 이벤트를 하이라이트합니다. |
| week_date | 월간 뷰의 서브 헤더에 표시되는 날짜 형식을 정의합니다. |
| wide_form | 표준 (wide) 라이트박스를 짧은 버전 대신 표시할지 여부를 제어합니다. |
| xml_date | 데이터 세트에서 데이터를 해석할 때 사용하는 날짜 형식을 정의합니다 |
| year_x | 연도 뷰에 표시되는 행(row)의 수를 지정합니다. |
| year_y | 연도 뷰에 표시되는 열 수를 설정합니다. |
Scheduler events
| Name | Description |
|---|---|
| onAfterBatchUpdate | batchUpdate 메서드 실행이 완료된 직후에 트리거됩니다. |
| onAfterEventDisplay | 스케줄러가 뷰, 날짜, 시간 등을 변경하여 'showEvent' 메서드로 지정된 이벤트를 표시할 때 트리거되며, 이벤트가 표시된 후에 발생합니다. |
| onAfterFolderToggle | 타임라인 뷰의 'tree' 모드에서 트리 분기가 열리거나 닫힌 직후에 트리거됩니다. |
| onAfterLightbox | 사용자가 라이트박스(편집 폼)를 닫을 때 한 번 실행됩니다. |
| onAfterQuickInfo | 팝업 이벤트 폼이 닫힌 직후에 트리거됩니다. |
| onAfterSchedulerResize | 스케줄러의 크기가 업데이트되고 데이터 영역이 다시 그려진 후 한 번 트리거됩니다. |
| onBeforeBatchUpdate | batchUpdate 메서드가 실행되기 바로 전에 트리거됩니다. |
| onBeforeCollapse | 사용자가 스케줄러의 크기를 '전체 화면'에서 원래 크기로 전환하기 위해 확장 아이콘을 클릭할 때 발생합니다. |
| onBeforeDrag | 사용자가 드래그 또는 리사이즈 동작을 시작할 때 트리거됩니다 (버전 2.1+부터 사용 가능) |
| onBeforeEventChanged | 드래그 앤 드롭을 통해 이벤트가 수정될 때 트리거되며, 변경 사항이 아직 저장되지 않은 상태입니다. |
| onBeforeEventCreated | 사용자가 스케줄러에서 커서를 드래그하여 새 이벤트를 생성할 때 트리거됩니다. |
| onBeforeEventDelete | 사용자가 삭제 버튼(이벤트 바 또는 상세 창에서)을 클릭한 직후에 트리거됩니다. |
| onBeforeEventDisplay | 'showEvent' 메서드가 특정 이벤트를 표시하기 직전에 트리거되며, 이벤트가 나타나기 전에 코드를 실행할 수 있습니다. |
| onBeforeEventDragIn | 드래그된 이벤트가 스케줄러 영역에 진입하기 직전에 발생합니다. |
| onBeforeEventDragOut | 스케줄러에서 이벤트가 드래그되어 나가기 직전에 트리거됩니다. |
| onBeforeEventPasted | 사용자가 'CTRL+V' 키보드 단축키를 누르기 직전에 트리거됩니다. |
| onBeforeExpand | 사용자가 확장 아이콘을 클릭하여 스케줄러를 원래 크기에서 '전체 화면'으로 전환할 때 트리거됩니다. |
| onBeforeExternalDragIn | 외부 DHTMLX 컴포넌트에서 스케줄러로 요소가 드래그되기 바로 전에 트리거됩니다 (dnd 확장이 활성화되어 있어야 합니다) |
| onBeforeFolderToggle | 타임라인 뷰의 '트리' 모드에서 트리 브랜치가 열리거나 닫히기 직전에 발생합니다. |
| onBeforeLightbox | 사용자가 라이트박스(편집 폼)를 열기 직전에 발생하는 이벤트입니다. |
| onBeforeParse | 데이터 파싱이 시작되기 직전에 트리거됩니다. |
| onBeforeQuickInfo | 이벤트에 대한 Quick Info 팝업이 표시되기 직전에 트리거됩니다. |
| onBeforeSectionRender | 단일 Timeline 섹션이 설정되기 직전, 아직 렌더링되지 않은 상태에서 트리거됩니다 (Timeline 뷰에만 적용됨) |
| onBeforeTodayDisplayed | 스케줄러에서 'Today' 버튼이 클릭될 때 트리거됩니다. |
| onBeforeTooltip | 데이터 항목에 대한 tooltip이 나타나기 직전에 트리거됩니다 ('tooltip' 확장 기능이 활성화된 경우에만 적용) |
| onBeforeViewChange | 사용자가 현재 뷰에서 다른 뷰로 전환하기 직전에 트리거됩니다 |
| onCellClick | 사용자가 셀을 한 번 클릭할 때 발생하는 이벤트 (Timeline 뷰에서만 적용됨) |
| onCellDblClick | 사용자가 셀을 더블 클릭할 때 발생하는 이벤트 (Timeline 뷰에서만 적용) |
| onClearAll | 스케줄러의 데이터가 모두 삭제된 후 한 번 호출됩니다. |
| onClick | 사용자가 이벤트에서 마우스 왼쪽 버튼을 클릭할 때 발생합니다. |
| onCollapse | 사용자가 확장 아이콘을 클릭하여 스케줄러를 '전체 화면'에서 원래 크기로 전환할 때 트리거됩니다. |
| onConfirmedBeforeEventDelete | 사용자가 삭제 버튼을 클릭하고 삭제를 확인한 직후에 트리거됩니다 (이벤트의 바 또는 상세 창에서). |
| onContextMenu | 사용자가 스케줄러 내에서 마우스 오른쪽 버튼을 클릭하여 컨텍스트 메뉴를 열 때 트리거됩니다. |
| onDataRender | 데이터가 페이지에 렌더링을 완료했을 때 한 번 트리거됩니다 |
| onDblClick | 사용자가 이벤트를 더블 클릭할 때 발생합니다. |
| onDestroy | 스케줄러가 destructor 메서드를 사용하여 해제된 후 한 번 트리거됩니다. |
| onDragEnd | 드래그 또는 리사이즈 작업이 완료되었을 때 트리거됩니다 |
| onEmptyClick | 사용자가 스케줄러 내 빈 영역(이벤트가 아닌 부분)을 클릭할 때 트리거됩니다. |
| onError | assert가 'false' 값을 받을 때, 즉 assertion이 실패했을 때 트리거됩니다. |
| onEventAdded | 스케줄러에 새로운 이벤트가 추가될 때 트리거됩니다. |
| onEventCancel | 사용자가 라이트박스(편집 폼)에서 '취소' 버튼을 눌렀을 때 트리거됩니다. |
| onEventChanged | 사용자가 이벤트 편집을 완료하고 업데이트를 저장할 때(이벤트 바 또는 상세 창에서 편집 및 저장 버튼 클릭 후) 한 번 트리거됩니다. |
| onEventCollision | 사용자가 이미 예약된 시간 슬롯 내에서 새 이벤트를 생성하거나 기존 이벤트를 수정하려고 할 때 트리거됩니다. |
| onEventCopied | 사용자가 'CTRL+C' 키보드 단축키를 눌렀을 때 트리거됩니다 (단, 'keyboard navigation' 확장 기능이 활성화된 경우에만 작동). |
| onEventCreated | 사용자가 새 이벤트를 생성하기 시작할 때 트리거됩니다 (더블 클릭하거나 드래그하여 생성할 때) |
| onEventCut | 사용자가 'CTRL+X' 키보드 단축키를 누를 때 트리거됩니다 (이 기능은 'keyboard navigation' 확장 기능이 활성화된 경우에만 작동합니다). |
| onEventDeleted | 이벤트가 삭제된 직후에 트리거됩니다 (버전 3.0 이상부터 사용 가능) |
| onEventDrag | 스케줄러 내에서 이벤트가 드래그되거나 크기 조정될 때 트리거됩니다. |
| onEventDragIn | 드래그된 이벤트가 스케줄러에 진입할 때 발생합니다 |
| onEventDragOut | 드래그된 이벤트가 스케줄러 영역을 벗어날 때 발생합니다. |
| onEventDropOut | 드래그된 이벤트가 스케줄러 영역 밖에 드롭될 때 발생합니다 |
| onEventIdChange | 이벤트의 ID가 업데이트될 때 트리거됩니다 |
| onEventLoading | 데이터 소스에서 이벤트가 로드될 때 트리거됩니다. |
| onEventPasted | 사용자가 'CTRL+V' 키보드 단축키를 눌렀을 때 트리거됩니다. |
| onEventSave | 사용자가 라이트박스(편집 폼)에서 '저장' 버튼을 클릭할 때 트리거됩니다. |
| onEventSelected | 스케줄러에서 사용자가 이벤트를 선택할 때 발생합니다. |
| onEventUnselected | 사용자가 다른 이벤트를 선택하여 이벤트 선택을 해제할 때 트리거됩니다. |
| onExpand | 사용자가 확장 아이콘을 클릭하여 스케줄러의 크기를 원래 상태에서 '전체 화면'으로 전환할 때 트리거됩니다. |
| onExternalDragIn | 외부 DHTMLX 컴포넌트에서 스케줄러로 데이터가 드래그될 때 발생합니다 (dnd 확장이 활성화되어 있어야 합니다) |
| onLightbox | 사용자가 라이트박스(편집 폼)를 열자마자 트리거됩니다. |
| onLightboxButton | 사용자가 라이트박스 내부의 커스텀 버튼을 클릭할 때 트리거됩니다. |
| onLimitViolation | 사용자가 현재 제한되거나 차단된 시간에 이벤트를 할당하려고 할 때 트리거됩니다. |
| onLoadEnd | 데이터 소스에서 데이터 로딩이 완료되면 한 번 실행됩니다. |
| onLoadError | 스케줄러가 데이터를 파싱하지 못하거나 서버가 4xx 또는 5xx 상태 코드를 응답할 때 발생합니다. |
| onLoadStart | 데이터 소스에서 데이터 로딩 프로세스가 시작되기 직전에 트리거됩니다. |
| onLocationError | 이벤트의 위치를 지도에서 찾을 수 없을 때 발생합니다 (맵 뷰에서만 적용) |
| onMouseDown | 사용자가 미리 정의된 'onclick' 핸들러가 없는 스케줄러 요소를 클릭할 때 트리거됩니다. |
| onMouseMove | 스케줄러 위에서 마우스 커서가 움직일 때 트리거됩니다. |
| onOptionsLoad | Timeline/Units 뷰의 일부가 업데이트된 후 트리거됩니다. |
| onOptionsLoadFinal | 옵션(섹션) 컬렉션의 로딩이 완료될 때 한 번만 트리거됩니다 (Timeline 뷰에만 적용됨) |
| onOptionsLoadStart | 서버에서 옵션 또는 섹션 집합이 로드되기 바로 직전에 트리거됩니다 (Timeline 뷰에만 적용됨) |
| onParse | 데이터가 파싱되어 API에 준비된 직후, 하지만 Scheduler에 표시되기 전 시점에 트리거됩니다. |
| onQuickInfo | 팝업 편집 폼이 나타날 때 트리거됩니다. |
| onSaveError | 데이터 업데이트 중 오류가 발생했을 때 트리거됩니다 |
| onScaleAdd | 스케줄러에서 단일 뷰 단위(예: 컬럼, 섹션, 또는 일 셀)가 렌더링된 직후에 트리거됩니다. |
| onScaleDblClick | 사용자가 타임 스케일을 더블 클릭할 때 발생합니다. |
| onSchedulerReady | 스케줄러가 초기화를 완료했지만 아직 페이지에 표시되기 전 한 번 트리거됩니다. |
| onSchedulerResize | 스케줄러의 크기가 변경되기 직전에 트리거됩니다. |
| onTemplatesReady | 스케줄러 템플릿이 초기화되었을 때 트리거됩니다. |
| onTimelineCreated | Timeline 뷰가 설정된 직후에 트리거되며, 페이지에 아직 표시되기 전 상태에서 발생합니다 (Timeline 뷰에만 적용됨) |
| onViewChange | 현재 뷰가 다른 뷰로 전환된 후에 트리거됩니다. |
| onViewMoreClick | 사용자가 Month 뷰에서 'View more' 링크를 클릭할 때 트리거됩니다 (이 이벤트는 Month 뷰에만 적용됩니다) |
| onXLE | 데이터 소스에서 데이터 로딩이 완료되었을 때 한 번 발생합니다. |
| onXLS | 데이터 소스가 로딩을 시작하기 직전에 트리거됩니다 |
| onXScaleClick | 사용자가 x축 셀을 싱글 클릭할 때 트리거됩니다 (Timeline 뷰에서만 적용됨) |
| onXScaleDblClick | 사용자가 x축 셀을 더블 클릭할 때 트리거됩니다 (Timeline 뷰에서만 적용됨) |
| onYScaleClick | 사용자가 y축의 셀을 한 번 클릭할 때 발생합니다 (Timeline 뷰에서만 적용됨) |
| onYScaleDblClick | 사용자가 y축의 셀을 더블클릭할 때 트리거됩니다 (Timeline 뷰에서만 적용됨) |
Scheduler templates
| Name | Description |
|---|---|
| agenda_date | 뷰의 헤더에 표시되는 날짜를 정의합니다 |
| agenda_day | Agenda 뷰의 날짜 셀 내부에 표시될 내용을 정의합니다. |
| agenda_text | Agenda 뷰의 두 번째 열에 표시되는 텍스트를 정의합니다. |
| agenda_time | Agenda 뷰의 첫 번째 열에 표시되는 날짜를 정의합니다. |
| api_date | API 메서드가 날짜를 처리할 때 사용하는 날짜 형식을 설정합니다. 이는 들어오는 날짜 값을 올바르게 해석하는 데 도움이 됩니다. |
| calendar_date | 미니 캘린더(날짜 선택기)의 일자 셀 내부에 표시되는 내용을 정의합니다. |
| calendar_month | 미니 캘린더 헤더(날짜 선택기)에 표시할 날짜를 설정합니다. |
| calendar_scale_date | Mini-Calendar 헤더(날짜 선택기)의 요일 레이블 형식을 설정합니다. |
| calendar_time | 라이트박스의 시작일 및 종료일 필드에 사용되는 날짜 형식을 정의합니다. |
| day_date | Day 및 Units 뷰의 헤더에 표시되는 날짜를 정의합니다. |
| day_scale_date | Day 뷰의 서브 헤더에 표시되는 날짜를 설정합니다. |
| drag_marker_class | 시간 축에서 이벤트의 강조된 기간에 적용되는 CSS 클래스를 정의합니다 |
| drag_marker_content | 타임 스케일에서 강조 표시된 블록에 표시되는 내용을 정의합니다 |
| event_bar_date | 이벤트의 날짜를 설정하는 데 사용됩니다. 이 기능은 단일 날짜에만 해당하는 이벤트에 적용됩니다. |
| event_bar_text | 다일 이벤트에 표시되는 텍스트를 설정합니다. |
| event_class | 이벤트 컨테이너에 추가될 CSS 클래스를 정의합니다. |
| event_date | 이벤트 시작 및 종료 날짜의 시간 부분을 정의합니다. 주로 다른 템플릿에서 시간 간격을 표시할 때 사용됩니다. |
| event_header | 이벤트의 헤더 내용을 정의합니다. |
| event_text | 이벤트에 표시되는 텍스트를 정의합니다. |
| format_date | 날짜 객체를 포맷된 날짜 문자열로 변환합니다. 이는 서버로 날짜 데이터를 전송할 때 유용합니다. |
| GRID_date | 뷰 헤더에 표시되는 날짜를 설정합니다. |
| GRID_full_date | Id='date'인 컬럼에 날짜가 어떻게 표시되는지 정의합니다. |
| GRID_single_date | Id가 'start_date' 또는 'end_date'인 컬럼에 날짜가 표시되는 방식을 정의합니다. |
| GRID_field | 열에 표시되는 텍스트를 정의합니다 |
| hour_scale | Y-축에 표시되는 요소를 정의합니다. |
| load_format | 동적 로딩 모드에서 사용되는 요청 형식을 정의합니다. |
| map_date | 뷰 헤더에 표시되는 날짜를 설정합니다 |
| map_info_content | 맵 뷰에서 정보 창(info window) 안에 표시되는 내용을 정의합니다. |
| map_text | 뷰의 두 번째 열에 표시되는 텍스트를 정의합니다. |
| map_time | 뷰의 첫 번째 열에 표시되는 날짜를 설정합니다 |
| month_date | 뷰 헤더에 표시될 날짜를 설정합니다. |
| month_date_class | 하루 셀에 할당되는 CSS 클래스를 정의합니다. |
| month_day | 셀 내에서 날짜가 어떻게 표시되는지를 정의합니다. |
| month_events_link | 월별 뷰 셀 내에 'View more' 링크가 어떻게 표시되는지 제어합니다 |
| month_scale_date | 월 뷰의 X축에 사용되는 날짜 형식을 정의합니다 |
| parse_date | 날짜 문자열을 Date 객체로 변환합니다 |
| quick_info_content | 팝업 편집 폼 안에 표시되는 내용을 정의합니다 |
| quick_info_date | 팝업 편집 폼에 표시되는 날짜를 정의합니다. |
| quick_info_title | 팝업 편집 폼의 제목을 설정합니다 |
| time_picker | 라이트박스 내에서 드롭다운 형태의 시간 선택기를 제공합니다. |
| time_slot_class | Day 및 Week 뷰에서 배경 셀의 CSS 클래스를 정의합니다. |
| time_slot_text | Day/Week 뷰의 배경 셀 안에 표시되는 내용을 정의합니다. |
| tooltip_date_format | 툴팁에 표시되는 시작 및 종료 날짜 형식을 정의합니다. |
| tooltip_text | 툴팁에 표시되는 텍스트를 설정합니다 |
| week_agenda_date | Week Agenda 뷰의 헤더에 표시되는 날짜를 정의합니다. |
| week_agenda_event_text | 이벤트에 표시되는 텍스트를 정의합니다 |
| week_agenda_scale_date | 뷰의 일(day) 셀에 표시되는 날짜 |
| week_date | 뷰 헤더에 표시되는 날짜를 설정 합니다 |
| week_date_class | 요일 셀에 할당되는 CSS 클래스를 정의합니다 |
| week_scale_date | 뷰의 서브 헤더에 표시되는 날짜를 정의합니다. |
| year_date | 뷰의 헤더에 표시되는 날짜를 설정합니다 |
| year_month | 뷰 내 월 블록 헤더에 표시되는 월 이름을 정의합니다. |
| year_scale_date | 뷰의 월 블록 내 서브 헤더에 표시되는 요일 이름을 정의합니다. |
| year_tooltip | 일정이 있는 날짜 셀 위에 표시되는 툴팁을 정의합니다. |
| lightbox_header | Lightbox의 헤더 섹션을 정의합니다 |
| TIMELINE_cell_value | 뷰의 셀 내에 예약된 이벤트 수를 나타냅니다. |
| TIMELINE_cell_class | 뷰에서 셀에 할당될 CSS 클래스를 설정합니다. |
| TIMELINE_scalex_class | X축 항목에 할당될 CSS 클래스 이름을 정의합니다. |
| TIMELINE_second_scalex_class | 두 번째 X축의 아이템에 추가될 CSS 클래스 이름을 설정합니다. |
| TIMELINE_scaley_class | Y축의 아이템에 할당될 CSS 클래스 이름을 정의합니다. |
| TIMELINE_scale_label | Y축 항목을 지정합니다 |
| TIMELINE_tooltip | 일정된 이벤트가 포함된 일(day) 셀에 대한 tooltip 텍스트를 제공합니다. |
| TIMELINE_date | 뷰 헤더에 표시되는 날짜를 정의합니다. |
| TIMELINE_scale_date | X축에 표시되는 항목을 정의합니다 |
| TIMELINE_second_scale_date | 보조 X축에 표시되는 항목을 정의합니다 |
| TIMELINE_row_class | 타임라인 뷰에서 행에 할당될 CSS 클래스를 정의합니다. |
| UNITS_date | 뷰 헤더에 표시되는 날짜를 설정합니다 |
| UNITS_scale_text | X축에 표시되는 항목을 정의합니다 |
| xml_date | 이 템플릿은 XML 파일에서 가져온 문자열을 지정된 형식에 따라 날짜 객체로 변환합니다. |
| xml_format | 날짜 객체를 특정 템플릿에 따라 문자열로 변환합니다. 주로 서버로 데이터를 전송할 때 사용됩니다. |
Scheduler others
| Name | Description |
|---|---|
| ajax | @getshort(api/method/ajax_other.md) |
| config | @getshort(api/method/config_other.md) |
| date | @getshort(api/method/date_other.md) |
| env | @getshort(api/method/env_other.md) |
| i18n | @getshort(api/method/i18n_other.md) |
| ical | @getshort(api/method/ical_other.md) |
| json | @getshort(api/method/json_other.md) |
| keys | @getshort(api/method/keys_other.md) |
| locale | @getshort(api/method/locale_other.md) |
| matrix | @getshort(api/method/matrix_other.md) |
| skin | @getshort(api/method/skin_other.md) |
| templates | @getshort(api/method/templates_other.md) |
| tooltip | @getshort(api/method/tooltip_other.md) |
| version | @getshort(api/method/version_other.md) |
| xy | @getshort(api/method/xy_other.md) |
Need help?
Got a question about the documentation? Reach out to our technical support team for help and guidance. For custom component solutions, visit the Services page.