Blazorise Specifications: Scheduler

Learn how Scheduler navigation, editing, selection, dragging, and recurrence behavior works.

Property Mapping

The scheduler reads and writes appointment data through mapped fields such as IdField, StartField, EndField, TitleField, DescriptionField, and AllDayField. Recurrence behavior uses RecurrenceRuleField, RecurrenceIdField, OriginalStartField, RecurrenceExceptionsField, and DeletedOccurrencesField.

Navigation and Views

The scheduler tracks the visible date through the Date parameter. Navigation uses SelectedView and WeekNavigationMode: week and work-week views either jump to the start of the previous/next week or shift by 7 days; month view shifts by one month; day view shifts by one day.

Internal Editing

Built-in editing requires Editable and UseInternalEditing to be true, and Data to be an ICollection<TItem>. When enabled, the scheduler inserts, updates, and removes items in the collection and still raises ItemInserted, ItemUpdated, and ItemRemoved.

New and Edit open the internal modal dialog when internal editing is enabled. Inserts and updates invoke ItemInserting or ItemUpdating callbacks first, which can cancel the operation.

Slot Click and Selection

Clicking an empty slot creates a new item with its start/end set to the slot range and sets the edit state to New. Clicking an all-day slot also sets the item to all-day and uses midnight start/end for the selected date.

Slot selection is available only when SlotSelectionMode is Mouse. Selection is constrained to the same scheduler section and the same day, and it only commits when the selection spans more than one slot. Successful selections create a new item and raise SlotsSelected.

Drag and Drop

Dragging is available when Draggable is true and starts a transaction that puts the scheduler in edit state. Drops are accepted only within the same scheduler section. If DropAllowed returns false, the drop is canceled and the item reverts. Successful drops call SaveImpl and raise ItemDropped.

Recurring Items

Editing or deleting a single occurrence of a recurring item records an exception in RecurrenceExceptionsField and tracks deletions in DeletedOccurrencesField. When internal editing is enabled, edits and deletes of recurring items prompt the user to choose between the series and the occurrence.