DevExtreme v23.2 is now available.

Explore our newest features/capabilities and share your thoughts with us.

Your search did not match any results.

Resources

Users can categorize appointments by resources. The following example illustrates what resources are: in an educational center lectures are held in several rooms. In Scheduler terms, room is a resource kind, individual rooms are resource instances, and lectures are appointments that use these resource instances.

Define Resource Kinds

Use the resources array to define resource kinds. Each object in this array should contain at least the following fields:

  • dataSource
    Resource instances of this resource kind. Each instance should contain the id, text, and color fields. If your field names differ, specify them in the valueExpr, displayExpr, and colorExpr properties, respectively.

  • fieldExpr
    A data field used to assign instances of this resource kind to appointments. Add this field to appointment objects and set the field values to id values of resource instances.

In this demo, the resources array contains three resource kinds: rooms, priorities, and assignees. Their fieldExpr values are roomId, priorityId, and assigneeId, respectively. Each appointment contains the same fields. Field values assign the appointments to different instances of these resource kinds.

Color Appointments Based on a Resource Kind

To use the color scheme of a specific resource kind, enable the kind's useColorAsDefault property. Otherwise, appointments use the color scheme of the last resource kind declared in the resources array.

This demo enables you to change the useColorAsDefault property at runtime. Click the radio buttons under the Scheduler to switch between different color schemes.

Assign Multiple Instances of a Resource Kind

Each resource kind object can contain the allowMultiple property. When this property is set to true, users can assign multiple instances of this kind to a single appointment. In this demo, the Assignee resource kind allows multiple instances.

You can also group appointments by resources as shown in the following demo: Group Orientation.

Backend API
import React, { useCallback, useState } from 'react'; import Scheduler, { Resource, SchedulerTypes } from 'devextreme-react/scheduler'; import RadioGroup, { RadioGroupTypes } from 'devextreme-react/radio-group'; import { data, assignees, rooms, priorities, resourcesList, } from './data.ts'; const currentDate = new Date(2021, 3, 27); const views: SchedulerTypes.ViewType[] = ['workWeek']; const App = () => { const [currentResource, setCurrentResource] = useState(resourcesList[0]); const onRadioGroupValueChanged = useCallback((e: RadioGroupTypes.ValueChangedEvent) => { setCurrentResource(e.value); }, []); return ( <React.Fragment> <Scheduler timeZone="America/Los_Angeles" dataSource={data} views={views} defaultCurrentView="workWeek" defaultCurrentDate={currentDate} startDayHour={9} endDayHour={19} height={600} > <Resource dataSource={rooms} fieldExpr="roomId" label="Room" useColorAsDefault={currentResource === 'Room'} /> <Resource dataSource={priorities} fieldExpr="priorityId" label="Priority" useColorAsDefault={currentResource === 'Priority'} /> <Resource dataSource={assignees} allowMultiple={true} fieldExpr="assigneeId" label="Assignee" useColorAsDefault={currentResource === 'Assignee'} /> </Scheduler> <div className="options"> <div className="caption">Use colors of:</div> <div className="option"> <RadioGroup items={resourcesList} value={currentResource} layout="horizontal" onValueChanged={onRadioGroupValueChanged} /> </div> </div> </React.Fragment> ); }; export default App;
import React, { useCallback, useState } from 'react'; import Scheduler, { Resource } from 'devextreme-react/scheduler'; import RadioGroup from 'devextreme-react/radio-group'; import { data, assignees, rooms, priorities, resourcesList, } from './data.js'; const currentDate = new Date(2021, 3, 27); const views = ['workWeek']; const App = () => { const [currentResource, setCurrentResource] = useState(resourcesList[0]); const onRadioGroupValueChanged = useCallback((e) => { setCurrentResource(e.value); }, []); return ( <React.Fragment> <Scheduler timeZone="America/Los_Angeles" dataSource={data} views={views} defaultCurrentView="workWeek" defaultCurrentDate={currentDate} startDayHour={9} endDayHour={19} height={600} > <Resource dataSource={rooms} fieldExpr="roomId" label="Room" useColorAsDefault={currentResource === 'Room'} /> <Resource dataSource={priorities} fieldExpr="priorityId" label="Priority" useColorAsDefault={currentResource === 'Priority'} /> <Resource dataSource={assignees} allowMultiple={true} fieldExpr="assigneeId" label="Assignee" useColorAsDefault={currentResource === 'Assignee'} /> </Scheduler> <div className="options"> <div className="caption">Use colors of:</div> <div className="option"> <RadioGroup items={resourcesList} value={currentResource} layout="horizontal" onValueChanged={onRadioGroupValueChanged} /> </div> </div> </React.Fragment> ); }; export default App;
import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.tsx'; ReactDOM.render( <App />, document.getElementById('app'), );
import { SchedulerTypes } from 'devextreme-react/scheduler'; type Appointment = SchedulerTypes.Appointment & { priorityId: number, roomId: number, assigneeId: number[] }; export const resourcesList = ['Assignee', 'Room', 'Priority']; export const data: Appointment[] = [ { text: 'Website Re-Design Plan', assigneeId: [4], roomId: 1, priorityId: 2, startDate: new Date('2021-04-26T16:30:00.000Z'), endDate: new Date('2021-04-26T18:30:00.000Z'), }, { text: 'Book Flights to San Fran for Sales Trip', assigneeId: [2], roomId: 2, priorityId: 1, startDate: new Date('2021-04-26T19:00:00.000Z'), endDate: new Date('2021-04-26T20:00:00.000Z'), allDay: true, }, { text: 'Install New Router in Dev Room', assigneeId: [1], roomId: 1, priorityId: 2, startDate: new Date('2021-04-26T21:30:00.000Z'), endDate: new Date('2021-04-26T22:30:00.000Z'), }, { text: 'Approve Personal Computer Upgrade Plan', assigneeId: [3], roomId: 2, priorityId: 2, startDate: new Date('2021-04-27T17:00:00.000Z'), endDate: new Date('2021-04-27T18:00:00.000Z'), }, { text: 'Final Budget Review', assigneeId: [1], roomId: 1, priorityId: 1, startDate: new Date('2021-04-27T19:00:00.000Z'), endDate: new Date('2021-04-27T20:35:00.000Z'), }, { text: 'New Brochures', assigneeId: [4], roomId: 3, priorityId: 2, startDate: new Date('2021-04-27T21:30:00.000Z'), endDate: new Date('2021-04-27T22:45:00.000Z'), }, { text: 'Install New Database', assigneeId: [2], roomId: 3, priorityId: 1, startDate: new Date('2021-04-28T16:45:00.000Z'), endDate: new Date('2021-04-28T18:15:00.000Z'), }, { text: 'Approve New Online Marketing Strategy', assigneeId: [4], roomId: 2, priorityId: 1, startDate: new Date('2021-04-28T19:00:00.000Z'), endDate: new Date('2021-04-28T21:00:00.000Z'), }, { text: 'Upgrade Personal Computers', assigneeId: [2], roomId: 2, priorityId: 2, startDate: new Date('2021-04-28T22:15:00.000Z'), endDate: new Date('2021-04-28T23:30:00.000Z'), }, { text: 'Customer Workshop', assigneeId: [3], roomId: 3, priorityId: 1, startDate: new Date('2021-04-29T18:00:00.000Z'), endDate: new Date('2021-04-29T19:00:00.000Z'), allDay: true, }, { text: 'Prepare 2021 Marketing Plan', assigneeId: [1], roomId: 1, priorityId: 2, startDate: new Date('2021-04-29T18:00:00.000Z'), endDate: new Date('2021-04-29T20:30:00.000Z'), }, { text: 'Brochure Design Review', assigneeId: [4], roomId: 1, priorityId: 1, startDate: new Date('2021-04-29T21:00:00.000Z'), endDate: new Date('2021-04-29T22:30:00.000Z'), }, { text: 'Create Icons for Website', assigneeId: [3], roomId: 3, priorityId: 1, startDate: new Date('2021-04-30T17:00:00.000Z'), endDate: new Date('2021-04-30T18:30:00.000Z'), }, { text: 'Upgrade Server Hardware', assigneeId: [4], roomId: 2, priorityId: 2, startDate: new Date('2021-04-30T21:30:00.000Z'), endDate: new Date('2021-04-30T23:00:00.000Z'), }, { text: 'Submit New Website Design', assigneeId: [1], roomId: 1, priorityId: 2, startDate: new Date('2021-04-30T23:30:00.000Z'), endDate: new Date('2021-05-01T01:00:00.000Z'), }, { text: 'Launch New Website', assigneeId: [2], roomId: 3, priorityId: 1, startDate: new Date('2021-04-30T19:20:00.000Z'), endDate: new Date('2021-04-30T21:00:00.000Z'), }, ]; export const assignees = [ { text: 'Samantha Bright', id: 1, color: '#727bd2', }, { text: 'John Heart', id: 2, color: '#32c9ed', }, { text: 'Todd Hoffman', id: 3, color: '#2a7ee4', }, { text: 'Sandra Johnson', id: 4, color: '#7b49d3', }, ]; export const rooms = [ { text: 'Room 1', id: 1, color: '#00af2c', }, { text: 'Room 2', id: 2, color: '#56ca85', }, { text: 'Room 3', id: 3, color: '#8ecd3c', }, ]; export const priorities = [ { text: 'High', id: 1, color: '#cc5c53', }, { text: 'Low', id: 2, color: '#ff9747', }, ];
window.exports = window.exports || {}; window.config = { transpiler: 'ts', typescriptOptions: { module: 'system', emitDecoratorMetadata: true, experimentalDecorators: true, jsx: 'react', }, meta: { 'react': { 'esModule': true, }, 'typescript': { 'exports': 'ts', }, 'devextreme/time_zone_utils.js': { 'esModule': true, }, 'devextreme/localization.js': { 'esModule': true, }, 'devextreme/viz/palette.js': { 'esModule': true, }, }, paths: { 'npm:': 'https://unpkg.com/', }, defaultExtension: 'js', map: { 'ts': 'npm:plugin-typescript@4.2.4/lib/plugin.js', 'typescript': 'npm:typescript@4.2.4/lib/typescript.js', 'react': 'npm:react@17.0.2/umd/react.development.js', 'react-dom': 'npm:react-dom@17.0.2/umd/react-dom.development.js', 'prop-types': 'npm:prop-types@15.8.1/prop-types.js', 'rrule': 'npm:rrule@2.6.4/dist/es5/rrule.js', 'luxon': 'npm:luxon@1.28.1/build/global/luxon.min.js', 'es6-object-assign': 'npm:es6-object-assign@1.1.0', 'devextreme': 'npm:devextreme@23.2.5/cjs', 'devextreme-react': 'npm:devextreme-react@23.2.5/cjs', 'jszip': 'npm:jszip@3.10.1/dist/jszip.min.js', 'devextreme-quill': 'npm:devextreme-quill@1.6.4/dist/dx-quill.min.js', 'devexpress-diagram': 'npm:devexpress-diagram@2.2.5/dist/dx-diagram.js', 'devexpress-gantt': 'npm:devexpress-gantt@4.1.51/dist/dx-gantt.js', '@devextreme/runtime': 'npm:@devextreme/runtime@3.0.12', 'inferno': 'npm:inferno@7.4.11/dist/inferno.min.js', 'inferno-compat': 'npm:inferno-compat/dist/inferno-compat.min.js', 'inferno-create-element': 'npm:inferno-create-element@7.4.11/dist/inferno-create-element.min.js', 'inferno-dom': 'npm:inferno-dom/dist/inferno-dom.min.js', 'inferno-hydrate': 'npm:inferno-hydrate@7.4.11/dist/inferno-hydrate.min.js', 'inferno-clone-vnode': 'npm:inferno-clone-vnode/dist/inferno-clone-vnode.min.js', 'inferno-create-class': 'npm:inferno-create-class/dist/inferno-create-class.min.js', 'inferno-extras': 'npm:inferno-extras/dist/inferno-extras.min.js', 'devextreme-cldr-data': 'npm:devextreme-cldr-data@1.0.3', // SystemJS plugins 'plugin-babel': 'npm:systemjs-plugin-babel@0.0.25/plugin-babel.js', 'systemjs-babel-build': 'npm:systemjs-plugin-babel@0.0.25/systemjs-babel-browser.js', // Prettier 'prettier/standalone': 'npm:prettier@2.8.4/standalone.js', 'prettier/parser-html': 'npm:prettier@2.8.4/parser-html.js', }, packages: { 'devextreme': { defaultExtension: 'js', }, 'devextreme-react': { main: 'index.js', }, 'devextreme/events/utils': { main: 'index', }, 'devextreme/localization/messages': { format: 'json', defaultExtension: '', }, 'devextreme/events': { main: 'index', }, 'es6-object-assign': { main: './index.js', defaultExtension: 'js', }, }, packageConfigPaths: [ 'npm:@devextreme/*/package.json', 'npm:@devextreme/runtime@3.0.12/inferno/package.json', ], babelOptions: { sourceMaps: false, stage0: true, react: true, }, }; System.config(window.config);
import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.js'; ReactDOM.render(<App />, document.getElementById('app'));
export const resourcesList = ['Assignee', 'Room', 'Priority']; export const data = [ { text: 'Website Re-Design Plan', assigneeId: [4], roomId: 1, priorityId: 2, startDate: new Date('2021-04-26T16:30:00.000Z'), endDate: new Date('2021-04-26T18:30:00.000Z'), }, { text: 'Book Flights to San Fran for Sales Trip', assigneeId: [2], roomId: 2, priorityId: 1, startDate: new Date('2021-04-26T19:00:00.000Z'), endDate: new Date('2021-04-26T20:00:00.000Z'), allDay: true, }, { text: 'Install New Router in Dev Room', assigneeId: [1], roomId: 1, priorityId: 2, startDate: new Date('2021-04-26T21:30:00.000Z'), endDate: new Date('2021-04-26T22:30:00.000Z'), }, { text: 'Approve Personal Computer Upgrade Plan', assigneeId: [3], roomId: 2, priorityId: 2, startDate: new Date('2021-04-27T17:00:00.000Z'), endDate: new Date('2021-04-27T18:00:00.000Z'), }, { text: 'Final Budget Review', assigneeId: [1], roomId: 1, priorityId: 1, startDate: new Date('2021-04-27T19:00:00.000Z'), endDate: new Date('2021-04-27T20:35:00.000Z'), }, { text: 'New Brochures', assigneeId: [4], roomId: 3, priorityId: 2, startDate: new Date('2021-04-27T21:30:00.000Z'), endDate: new Date('2021-04-27T22:45:00.000Z'), }, { text: 'Install New Database', assigneeId: [2], roomId: 3, priorityId: 1, startDate: new Date('2021-04-28T16:45:00.000Z'), endDate: new Date('2021-04-28T18:15:00.000Z'), }, { text: 'Approve New Online Marketing Strategy', assigneeId: [4], roomId: 2, priorityId: 1, startDate: new Date('2021-04-28T19:00:00.000Z'), endDate: new Date('2021-04-28T21:00:00.000Z'), }, { text: 'Upgrade Personal Computers', assigneeId: [2], roomId: 2, priorityId: 2, startDate: new Date('2021-04-28T22:15:00.000Z'), endDate: new Date('2021-04-28T23:30:00.000Z'), }, { text: 'Customer Workshop', assigneeId: [3], roomId: 3, priorityId: 1, startDate: new Date('2021-04-29T18:00:00.000Z'), endDate: new Date('2021-04-29T19:00:00.000Z'), allDay: true, }, { text: 'Prepare 2021 Marketing Plan', assigneeId: [1], roomId: 1, priorityId: 2, startDate: new Date('2021-04-29T18:00:00.000Z'), endDate: new Date('2021-04-29T20:30:00.000Z'), }, { text: 'Brochure Design Review', assigneeId: [4], roomId: 1, priorityId: 1, startDate: new Date('2021-04-29T21:00:00.000Z'), endDate: new Date('2021-04-29T22:30:00.000Z'), }, { text: 'Create Icons for Website', assigneeId: [3], roomId: 3, priorityId: 1, startDate: new Date('2021-04-30T17:00:00.000Z'), endDate: new Date('2021-04-30T18:30:00.000Z'), }, { text: 'Upgrade Server Hardware', assigneeId: [4], roomId: 2, priorityId: 2, startDate: new Date('2021-04-30T21:30:00.000Z'), endDate: new Date('2021-04-30T23:00:00.000Z'), }, { text: 'Submit New Website Design', assigneeId: [1], roomId: 1, priorityId: 2, startDate: new Date('2021-04-30T23:30:00.000Z'), endDate: new Date('2021-05-01T01:00:00.000Z'), }, { text: 'Launch New Website', assigneeId: [2], roomId: 3, priorityId: 1, startDate: new Date('2021-04-30T19:20:00.000Z'), endDate: new Date('2021-04-30T21:00:00.000Z'), }, ]; export const assignees = [ { text: 'Samantha Bright', id: 1, color: '#727bd2', }, { text: 'John Heart', id: 2, color: '#32c9ed', }, { text: 'Todd Hoffman', id: 3, color: '#2a7ee4', }, { text: 'Sandra Johnson', id: 4, color: '#7b49d3', }, ]; export const rooms = [ { text: 'Room 1', id: 1, color: '#00af2c', }, { text: 'Room 2', id: 2, color: '#56ca85', }, { text: 'Room 3', id: 3, color: '#8ecd3c', }, ]; export const priorities = [ { text: 'High', id: 1, color: '#cc5c53', }, { text: 'Low', id: 2, color: '#ff9747', }, ];
<!DOCTYPE html> <html> <head> <title>DevExtreme Demo</title> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/23.2.5/css/dx.light.css" /> <link rel="stylesheet" type="text/css" href="styles.css" /> <script src="https://unpkg.com/core-js@2.6.12/client/shim.min.js"></script> <script src="https://unpkg.com/systemjs@0.21.3/dist/system.js"></script> <script type="text/javascript" src="config.js"></script> <script type="text/javascript"> System.import("./index.tsx"); </script> </head> <body class="dx-viewport"> <div class="demo-container"> <div id="app"></div> </div> </body> </html>
.options { padding: 20px; background-color: rgba(191, 191, 191, 0.15); margin-top: 20px; } .caption { font-size: 18px; font-weight: 500; } .option { margin-top: 10px; display: inline-block; }