Basics
The ActionSheet component is a pop-up sheet that contains a set of buttons. These buttons allow users to perform custom actions related to a single task (call, send a message, delete, or edit a selected contact). This demo shows how to create a simple ActionSheet and handle button clicks.
Specify Buttons and Title
ActionSheet can contain multiple buttons. To specify and configure them, use one of these properties:
-
items[]
Accepts a local data array. -
dataSource
Accepts a local data array or a DataSource object. This object works with local and remote arrays and allows you to shape data.
For each button, you can specify a text, type, icon, template, and other properties. In this demo, the ActionSheet buttons are configured in a local array assigned to the dataSource property. Each button includes the text property only.
If you want to display a title, assign the text to the title property.
Handle Button Clicks
You can assign a function to the onItemClick property to handle button clicks. Use the e.itemData field within the function to determine which button was clicked. You can also use the onCancelClick property handle a click on the built-in Cancel button. In this demo, the ActionSheet component displays a notification with the button's name when you click a button.
Feel free to share demo-related thoughts here.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
Thank you!
We appreciate your feedback.
We appreciate your feedback.
import React from 'react';
import ActionSheet from 'devextreme-react/action-sheet';
import Button from 'devextreme-react/button';
import Switch from 'devextreme-react/switch';
import notify from 'devextreme/ui/notify';
import { actionSheetItems } from './data.js';
class App extends React.Component {
constructor(props) {
super(props);
this.state = {
isActionSheetVisible: false,
showTitle: true,
showCancelButton: true,
};
this.showActionSheet = this.showActionSheet.bind(this);
this.onActionSheetItemClick = this.onActionSheetItemClick.bind(this);
this.onActionSheetCancelClick = this.onActionSheetCancelClick.bind(this);
this.onActionSheetButtonClick = this.onActionSheetButtonClick.bind(this);
this.changeTitle = this.changeTitle.bind(this);
this.changeCancelButton = this.changeCancelButton.bind(this);
}
render() {
return (
<div>
<ActionSheet
dataSource={actionSheetItems}
title="Choose action"
showTitle={this.state.showTitle}
showCancelButton={this.state.showCancelButton}
visible={this.state.isActionSheetVisible}
onItemClick={this.onActionSheetItemClick}
onCancelClick={this.onActionSheetCancelClick} />
<div className="button">
<Button width="100%" text="Click to show Action Sheet" onClick={this.showActionSheet} />
</div>
<div className="options">
<div className="caption">Options</div>
<div className="option">
<span>Show title</span>
<Switch value={this.state.showTitle} onValueChanged={this.changeTitle} />
</div>
<div className="option">
<span>Show cancel button</span>
<Switch value={this.state.showCancelButton} onValueChanged={this.changeCancelButton} />
</div>
</div>
</div>
);
}
showActionSheet() {
this.setState({
isActionSheetVisible: true,
});
}
onActionSheetItemClick(e) {
this.onActionSheetButtonClick(e.itemData.text);
}
onActionSheetCancelClick() {
this.onActionSheetButtonClick('Cancel');
}
onActionSheetButtonClick(buttonName) {
this.setState({
isActionSheetVisible: false,
});
notify(`The "${buttonName}" button is clicked.`);
}
changeTitle(e) {
this.setState({
showTitle: e.value,
});
}
changeCancelButton(e) {
this.setState({
showCancelButton: e.value,
});
}
}
export default App;
import React from 'react';
import ReactDOM from 'react-dom';
import App from './App.js';
ReactDOM.render(
<App />,
document.getElementById('app'),
);
<!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.1.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.js");
</script>
</head>
<body class="dx-viewport">
<div class="demo-container">
<div id="app"></div>
</div>
</body>
</html>
.button {
width: 280px;
display: flex;
margin: 20px auto;
}
.options {
padding: 20px;
background-color: rgba(191, 191, 191, 0.15);
left: 0;
position: absolute;
bottom: 0;
right: 0;
}
.caption {
font-size: 18px;
font-weight: 500;
}
.option {
margin-top: 10px;
line-height: 28px;
text-align: right;
display: inline-block;
width: 100%;
}
.option > span {
float: left;
}
export const actionSheetItems = [
{ text: 'Call' },
{ text: 'Send message' },
{ text: 'Edit' },
{ text: 'Delete' },
];
window.config = {
transpiler: 'plugin-babel',
meta: {
'devextreme/localization.js': {
'esModule': true,
},
},
paths: {
'npm:': 'https://unpkg.com/',
},
defaultExtension: 'js',
map: {
'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.1.5/cjs',
'devextreme-react': 'npm:devextreme-react@23.1.5',
'jszip': 'npm:jszip@3.7.1/dist/jszip.min.js',
'devextreme-quill': 'npm:devextreme-quill@1.6.2/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.2.1/dist/dx-diagram.js',
'devexpress-gantt': 'npm:devexpress-gantt@4.1.48/dist/dx-gantt.js',
'@devextreme/runtime': 'npm:@devextreme/runtime@3.0.11',
'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',
// 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/events': {
main: 'index',
},
'es6-object-assign': {
main: './index.js',
defaultExtension: 'js',
},
},
packageConfigPaths: [
'npm:@devextreme/*/package.json',
'npm:@devextreme/runtime@3.0.11/inferno/package.json',
],
babelOptions: {
sourceMaps: false,
stage0: true,
react: true,
},
};
System.config(window.config);