2.5.19 • Published 1 year ago

react-scheduler-fix v2.5.19

Weekly downloads
-
License
MIT
Repository
github
Last release
1 year ago

React Scheduler Component

npm package Twitter URL

Installation

npm i @aldabil/react-scheduler

Usage

import { Scheduler } from "@aldabil/react-scheduler";

Example

<Scheduler
  view="month"
  events={[
    {
      event_id: 1,
      title: "Event 1",
      start: new Date("2021/5/2 09:30"),
      end: new Date("2021/5/2 10:30"),
    },
    {
      event_id: 2,
      title: "Event 2",
      start: new Date("2021/5/4 10:00"),
      end: new Date("2021/5/4 11:00"),
    },
  ]}
/>

Options

OptionValue
heightnumber. Min height of table. Default: 600
viewstring. Initial view to load. options: "week", "month", "day". Default: "week" (if it's not null)
monthObject. Month view props. default: {weekDays: 0, 1, 2, 3, 4, 5, weekStartOn: 6, startHour: 9, endHour: 17,cellRenderer?:(props: CellProps) => JSX.Element,navigation: true}
weekObject. Week view props. default: { weekDays: 0, 1, 2, 3, 4, 5, weekStartOn: 6, startHour: 9, endHour: 17,step: 60,cellRenderer?:(props: CellProps) => JSX.Element,navigation: true}
dayObject. Day view props. default: {startHour: 9, endHour: 17, step: 60,cellRenderer?:(props: CellProps) => JSX.Element,navigation: true}
selectedDateDate. Initial selected date. Default: new Date()
navigationboolean. Show/Hide top bar date navigation. Default: true
navigationPickerPropsCalendarPickerProps for top bar date navigation. Ref: CalendarPicker API
eventsArray of ProcessedEvent. Default: [] type ProcessedEvent = {event_id: number or string;title: string;start: Date;end: Date;disabled?: boolean;color?: string;editable?: boolean;deletable?: boolean;draggable?: boolean;allDay?: boolean;}
eventRendererFunction(event:ProcessedEvent): JSX.Element. A function that overrides the event item render function, see demo Custom Event Renderer below
editableboolean. Whether the event item will show the edit button, this is applied to all events, and can be overridden in each event property, see ProcessedEvent type.
deletableboolean. Whether the event item will show the delete button, this is applied to all events, and can be overridden in each event property, see ProcessedEvent type.
draggableboolean. Whether activate drag&drop for the events, this is applied to all events, and can be overridden in each event property, see ProcessedEvent type.
remoteEvents:warning: Deprecated Function(query: string). Return promise of array of events. Used for remote data. Query returns start and end timestamps as the user navigation changes the dates currently in view. Example query value: ?start=Sat May 08 2021 00:00:00 GMT+0100 (British Summer Time)&end=Thu May 13 2021 23:59:59 GMT+0100 (British Summer Time). Working example visible here: https://codesandbox.io/s/remote-data-j13ei
getRemoteEventsFunction(viewEvent). Return promise of array of events. Can be used as a callback to fetch events by parent component or fetch.type ViewEvent = { start: Date; end: Date; view: "day" | "week" | "month";}
fieldsArray of extra fields with configurations. Example: { name: "description", type: "input" , config: { label: "Description", required: true, min: 3, email: true, variant: "outlined", ....}
loadingboolean. Loading state of the calendar table
onConfirmFunction(event, action). Return promise with the new added/edited event use with remote data. action: "add", "edit"
onDeleteFunction(id) Return promise with the deleted event id to use with remote data.
customEditorFunction(scheduler). Override editor modal. Provided prop scheduler object with helper props: {state: state obj, close(): voidloading(status: boolean): voidedited?: ProcessedEventonConfirm(event: ProcessedEvent, action:EventActions): void}
viewerExtraComponentFunction(fields, event) OR Component. Additional component in event viewer popper
resourcesArray. Resources array to split event views with resources Example {assignee: 1,text: "User One", subtext: "Sales Manager", avatar: "https://picsum.photos/200/300", color: "#ab2d2d", }
resourceFieldsObject. Map the resources correct fields. Example: { idField: "admin_id", textField: "title", subTextField: "mobile", avatarField: "title", colorField: "background", }
recourseHeaderComponentFunction(resource). Override header component of resource
resourceViewModeDisplay resources mode. Options: "default", "tabs"
directionstring. Table direction. "rtl", "ltr"
dialogMaxWidthEdito dialog maxWith. Ex: "lg", "md", "sm"... Default:"md"
localeLocale of date-fns. Default:enUS
hourFormatHour format. Options: "12", "24"...Default: "12"
translationsObject. Translations view props. default: { navigation: { month: "Month", week: "Week", day: "Day", today: "Today" }, form: { addTitle: "Add Event", editTitle: "Edit Event", confirm: "Confirm", delete: "Delete", cancel: "Cancel" }, event: { title: "Title", start: "Start", end: "End", allDay: "All Day"}, moreEvents: "More..."}
onEventDropFunction(droppedOn: Date, updatedEvent: ProcessedEvent, originalEvent: ProcessedEvent). Return a promise, used to update remote data of the dropped event. Return an event to update state internally, or void if event state is managed within component

Demos

Todos

  • Tests
  • Drag&Drop - partially
  • Resizable
  • Recurring events
  • Localization
  • Hour format 12 | 24