TimeVisualizingEditor

A specialized EventEditor which contains a time visualizer DayView showing the event being edited in context of the time span of the day.

To use this as the event editor in your application, configure your Calendar EventEdit feature's editorConfig as follows:

features : {
    eventEdit : {
        // Our event editor shows a time visualizer day view.
        // Make the hour height a little smaller to better fit the editor size.
        editorConfig : {
            type           : 'timevisualizingeditor',
            maximizable    : true,
            timeVisualizer : {
                hourHeight : 30
            }
        }
    }
}

The time visualizer will only be shown when editing intra-day events. Day-spanning events will not show the time visualizer.

The time visualizer will show the event being edited and, optionally, other events occurring on the same day. This is configured by the showOtherEvents config.

Time visualizing editor
//<code-header>
fiddle.title = 'Time visualizing editor';
//</code-header>
const events = [
    {
        id        : 1,
        name      : 'Team Meeting',
        startDate : '2024-01-07T10:00:00',
        endDate   : '2024-01-07T11:00:00'
    },
    {
        id        : 2,
        name      : 'Project Planning',
        startDate : '2024-01-09T14:00:00',
        endDate   : '2024-01-09T15:30:00'
    },
    {
        id        : 3,
        name      : 'Code Review',
        startDate : '2024-01-11T09:30:00',
        endDate   : '2024-01-11T10:30:00'
    },
    {
        id        : 4,
        name      : 'Daily Standup',
        startDate : '2024-01-08T09:00:00',
        endDate   : '2024-01-08T09:30:00'
    },
    {
        id        : 5,
        name      : 'Client Call',
        startDate : '2024-01-10T11:00:00',
        endDate   : '2024-01-10T12:00:00'
    },
    {
        id        : 6,
        name      : 'Sprint Review',
        startDate : '2024-01-12T15:00:00',
        endDate   : '2024-01-12T16:30:00'
    },
    {
        id        : 7,
        name      : 'Lunch & Learn',
        startDate : '2024-01-13T12:00:00',
        endDate   : '2024-01-13T13:00:00'
    }
];

// Calendar configuration
const calendar = new Calendar({
    appendTo   : targetElement,
    mode       : 'week',
    date       : new Date('2024-01-07'),
    height     : 600,
    width      : '100%',
    eventStore : {
        data : events
    },
    features : {
        eventEdit : {
            editorConfig : {
                type           : 'timevisualizingeditor',
                maximizable    : true,
                timeVisualizer : {
                    hourHeight : 30
                }
            }
        }
    },
    modeDefaults : {
        dayStartTime : '07:00',
        dayEndTime   : '20:00'
    }
});

Configs

124

Common

listenersEvents

Other

showOtherEvents: Boolean | Object

Whether to show other events occurring at the same time as the event being edited in the time visualizer. If true, all day events will be shown as well.

ParameterTypeDescription
allDayBoolean

Configure as false to not show all day events in the time visualizer.

The configuration for the time visualizer DayView shown in the editor.

Configuration for the time visualizer DayView shown in the editor

columnWidget
defaultFocusContainer
drawerPanel
labelPositionContainer
modalPopup
renditionContainer
resizableResizable
rtlRTL
spanWidget
titleRendererEventEditor

Accessibility

ariaLabelWidget
keyMapKeyMap

Content

bbarPanel
defaultsContainer
footerPanel
headerPanel
itemsContainer
lazyItemsContainer
namedItemsContainer
stripsPanel
tbarPanel
textContentContainer
toolsPanel

CSS

bodyClsPanel
borderContainer
clsWidget
colorWidget
htmlClsWidget
itemClsContainer
styleWidget
uiPanel

DOM

adoptWidget
appendToWidget
contentWidget
datasetWidget
htmlWidget
idWidget
tagWidget

Float & align

alignWidget
anchorWidget
centeredWidget
floatingWidget
xWidget
yWidget

Layout

alignSelfWidget
dockWidget
flexWidget
heightWidget
hiddenWidget
hideWhenEmptyContainer
layoutContainer
layoutStyleContainer
marginWidget
maxHeightWidget
maxWidthWidget
minHeightWidget
minWidthWidget
textAlignWidget
weightWidget
widthWidget

misc

tabBarItemsContainer

Misc

dataFieldWidget
disabledWidget
iconPanel
localeClassLocalizable
localizableLocalizable
maskedWidget
ownerWidget
readOnlyWidget
refWidget
rippleWidget
tabWidget
titlePanel
tooltipWidget

Record

recordContainer

Scrolling

State

stateIdState

Properties

102

Class hierarchy

isTimeVisualizingEditor: Boolean= truereadonly
Identifies an object as an instance of TimeVisualizingEditor class, or subclass thereof.
isTimeVisualizingEditor: Boolean= truereadonlystatic
Identifies an object as an instance of TimeVisualizingEditor class, or subclass thereof.
isContainerContainer
isDelayableDelayable
isEventEditorEventEditor
isEventsEvents
isKeyMapKeyMap
isLocalizableLocalizable
isPanelPanel
isPopupPopup
isResizableResizable
isStateState
isToolableToolable
isWidgetWidget

Other

The DayView instance which is used as the time visualizer in the editor.

The Calendar instance which is used as the calendar in the editor.

The event instance used in the time visualizer to represent the event being edited.

$namestaticWidget
columnWidget
firstItemContainer
hasChangesContainer
isValidContainer
itemsContainer
labelPositionContainer
lastItemContainer
renditionContainer
resizableResizable
rtlRTL
spanWidget
toolsPanel
typestaticWidget
valuesContainer

Accessibility

keyMapKeyMap

Content

bbarPanel
tbarPanel

CSS

clsWidget

DOM

appendToWidget
contentWidget
datasetWidget
elementWidget
htmlWidget
idWidget
styleWidget

Float & align

xWidget
yWidget

Layout

alignSelfWidget
flexWidget
heightWidget
layoutContainer
layoutStyleContainer
marginWidget
maxHeightWidget
maxWidthWidget
minHeightWidget
minWidthWidget
widthWidget

Lifecycle

configBase

Misc

cellInfoWidget
disabledWidget
localeHelperLocalizable
localeManagerLocalizable
readOnlyWidget
refWidget
tabWidget
titlePanel
tooltipWidget

Record

recordContainer

State

stateState

Visibility

hiddenWidget
isVisibleWidget

Widget hierarchy

ownerWidget
parentWidget
widgetMapContainer

Functions

75

Configuration

applyDefaultsstaticBase

Events

Float & align

alignToWidget
setXYWidget
showByWidget
toFrontWidget

Lifecycle

createstaticWidget
destroystaticBase
initClassstaticWidget

Misc

attachTooltipstaticWidget
fromElementstaticWidget
fromSelectorstaticWidget
getByIdstaticWidget
isOfTypeNamestaticBase
mixinstaticBase
optionalLstaticLocalizable

Other

addContainer
closePopup
composeWidget
createOnFrameDelayable
disableWidget
enableWidget
focusWidget
getAtContainer
getWidgetByIdContainer
insertContainer
LstaticLocalizable
maskWidget
onEvents
recomposeWidget
relayAllEvents
removeContainer
removeAllContainer
resetValuesContainer
setValuesContainer
triggerEvents
unEvents
unmaskWidget

State

Visibility

hideWidget
showWidget

Widget hierarchy

closestWidget
containsWidget
ownsWidget
queryWidget
queryAllWidget
upWidget

Events

22

Event handlers

22

Typedefs

7

CSS variables

60