If you have technical questions, please create a support ticket in the DevExpress Support Center.
import React, { useState } from 'react';
import Chat, { ChatTypes } from 'devextreme-react/chat';
import { MessageEnteredEvent, TypingEndEvent, TypingStartEvent } from 'devextreme/ui/chat';
import { currentUser, supportAgent, initialMessages } from './data.ts';
export default function App() {
const [userChatTypingUsers, setUserChatTypingUsers] = useState<ChatTypes.User[]>([]);
const [supportChatTypingUsers, setSupportChatTypingUsers] = useState<ChatTypes.User[]>([]);
const [messages, setMessages] = useState<ChatTypes.Message[]>(initialMessages);
function onMessageEntered({ message }: MessageEnteredEvent) {
setMessages((prevMessages) => [prevMessages, message]);
}
function typingStart({ user }: TypingStartEvent) {
if (user.id === currentUser.id) {
setSupportChatTypingUsers([supportAgent]);
} else {
setUserChatTypingUsers([currentUser]);
}
}
function typingEnd({ user }: TypingEndEvent) {
if (user.id === currentUser.id) {
setSupportChatTypingUsers([]);
} else {
setUserChatTypingUsers([]);
}
}
return (
<React.Fragment>
<Chat
user={currentUser}
items={messages}
onMessageEntered={onMessageEntered}
onTypingStart={typingStart}
onTypingEnd={typingEnd}
typingUsers={userChatTypingUsers}
/>
<Chat
user={supportAgent}
items={messages}
onMessageEntered={onMessageEntered}
onTypingStart={typingStart}
onTypingEnd={typingEnd}
typingUsers={supportChatTypingUsers}
/>
</React.Fragment>
);
}
xxxxxxxxxx
import React, { useState } from 'react';
import Chat from 'devextreme-react/chat';
import { currentUser, supportAgent, initialMessages } from './data.js';
export default function App() {
const [userChatTypingUsers, setUserChatTypingUsers] = useState([]);
const [supportChatTypingUsers, setSupportChatTypingUsers] = useState([]);
const [messages, setMessages] = useState(initialMessages);
function onMessageEntered({ message }) {
setMessages((prevMessages) => [prevMessages, message]);
}
function typingStart({ user }) {
if (user.id === currentUser.id) {
setSupportChatTypingUsers([supportAgent]);
} else {
setUserChatTypingUsers([currentUser]);
}
}
function typingEnd({ user }) {
if (user.id === currentUser.id) {
setSupportChatTypingUsers([]);
} else {
setUserChatTypingUsers([]);
}
}
return (
<React.Fragment>
<Chat
user={currentUser}
items={messages}
onMessageEntered={onMessageEntered}
onTypingStart={typingStart}
onTypingEnd={typingEnd}
typingUsers={userChatTypingUsers}
/>
<Chat
user={supportAgent}
items={messages}
onMessageEntered={onMessageEntered}
onTypingStart={typingStart}
onTypingEnd={typingEnd}
typingUsers={supportChatTypingUsers}
/>
</React.Fragment>
);
}
xxxxxxxxxx
import React from 'react';
import ReactDOM from 'react-dom';
import App from './App.tsx';
ReactDOM.render(
<App />,
document.getElementById('app'),
);
xxxxxxxxxx
import { ChatTypes } from 'devextreme-react/chat';
const date = new Date();
date.setHours(0, 0, 0, 0);
function getTimestamp(date, offsetMinutes = 0) {
return date.getTime() + offsetMinutes * 60000;
}
export const currentUser: ChatTypes.User = {
id: 'c94c0e76-fb49-4b9b-8f07-9f93ed93b4f3',
name: 'John Doe',
};
export const supportAgent: ChatTypes.User = {
id: 'd16d1a4c-5c67-4e20-b7v0e-2991c22747c3',
name: 'Support Agent',
avatarUrl: 'images/petersmith.png',
};
export const initialMessages = [
{
timestamp: getTimestamp(date, -9),
author: supportAgent,
text: 'Hello, John!\nHow can I assist you today?',
},
{
timestamp: getTimestamp(date, -7),
author: currentUser,
text: 'Hi, I\'m having trouble accessing my account.',
},
{
timestamp: getTimestamp(date, -7),
author: currentUser,
text: 'It says my password is incorrect.',
},
{
timestamp: getTimestamp(date, -7),
author: supportAgent,
text: 'I can help you with that. Can you please confirm your UserID for security purposes?',
},
{
timestamp: getTimestamp(date, 1),
author: currentUser,
text: 'john.doe1357',
},
{
timestamp: getTimestamp(date, 1),
author: supportAgent,
text: '✅ Instructions to restore access have been sent to the email address associated with your account.',
},
];
xxxxxxxxxx
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,
},
'openai': {
'esModule': true,
},
},
paths: {
'npm:': 'https://unpkg.com/',
'bundles:': 'bundles/',
'externals:': 'bundles/externals/',
},
defaultExtension: 'js',
map: {
'ts': 'npm:plugin-typescript@8.0.0/lib/plugin.js',
'typescript': 'npm:typescript@4.2.4/lib/typescript.js',
'jszip': 'npm:jszip@3.10.1/dist/jszip.min.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/prop-types.js',
'rrule': 'npm:rrule@2.6.4/dist/es5/rrule.js',
'luxon': 'npm:luxon@3.4.4/build/global/luxon.min.js',
'es6-object-assign': 'npm:es6-object-assign',
'devextreme': 'npm:devextreme@link:../../packages/devextreme/artifacts/npm/devextreme/cjs',
'devextreme-react': 'npm:devextreme-react@link:../../packages/devextreme-react/npm/cjs',
'devextreme-quill': 'npm:devextreme-quill@1.7.1/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.2.5/dist/dx-diagram.js',
'devexpress-gantt': 'npm:devexpress-gantt@4.1.54/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/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.8/standalone.js',
'prettier/parser-html': 'npm:prettier@2.8.8/parser-html.js',
},
packages: {
'devextreme': {
defaultExtension: 'js',
},
'devextreme-react': {
main: 'index.js',
},
'devextreme/events/utils': {
main: 'index',
},
'devextreme/localization/messages': {
format: 'json',
defaultExtension: 'json',
},
'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);
xxxxxxxxxx
import React from 'react';
import ReactDOM from 'react-dom';
import App from './App.js';
ReactDOM.render(<App />, document.getElementById('app'));
xxxxxxxxxx
const date = new Date();
date.setHours(0, 0, 0, 0);
function getTimestamp(date, offsetMinutes = 0) {
return date.getTime() + offsetMinutes * 60000;
}
export const currentUser = {
id: 'c94c0e76-fb49-4b9b-8f07-9f93ed93b4f3',
name: 'John Doe',
};
export const supportAgent = {
id: 'd16d1a4c-5c67-4e20-b7v0e-2991c22747c3',
name: 'Support Agent',
avatarUrl: 'images/petersmith.png',
};
export const initialMessages = [
{
timestamp: getTimestamp(date, -9),
author: supportAgent,
text: 'Hello, John!\nHow can I assist you today?',
},
{
timestamp: getTimestamp(date, -7),
author: currentUser,
text: "Hi, I'm having trouble accessing my account.",
},
{
timestamp: getTimestamp(date, -7),
author: currentUser,
text: 'It says my password is incorrect.',
},
{
timestamp: getTimestamp(date, -7),
author: supportAgent,
text: 'I can help you with that. Can you please confirm your UserID for security purposes?',
},
{
timestamp: getTimestamp(date, 1),
author: currentUser,
text: 'john.doe1357',
},
{
timestamp: getTimestamp(date, 1),
author: supportAgent,
text: '✅ Instructions to restore access have been sent to the email address associated with your account.',
},
];
xxxxxxxxxx
<html lang="en">
<head></head>
<body class="dx-viewport">
<div class="demo-container">
<div id="app"></div>
</div>
</body>
</html>
xxxxxxxxxx
#app {
display: flex;
gap: 20px;
}
.dx-chat {
height: 710px;
}
.dx-avatar {
border: 1px solid var(--dx-color-border);
}
Messages
To specify initial messages, you can either populate the items array (shown in this demo) or use a dataSource.
Use the following API to render new messages:
- If you use items, update the array with the new message.
- If you use a dataSource, implement load and insert operations.
Users
To specify the chat owner, set the user property. Owner messages align to the right (or left in RTL mode) and do not display the name or avatar.
Each message includes information about the sender (author): name, avatar, and alternative avatar text. If no avatar is set, the user's initials are displayed instead.
Events
If a user enters a message, the Chat raises the messageEntered event. Use the event handler to process the message. For example, you can display the message in the message feed and send the message to the server for storage.
When users start or finish typing, the Chat raises typingStart and typingEnd events. Use these events to manage the typingUsers array. The Chat uses this array to display a list of active users.