Skip to contentSkip to navigationSkip to topbar
Paste assistant Assistant
Figma
Star

Side Modal

Version 4.1.1GithubStorybookPeer review pending

A modal that stays on the side of the screen.

Installation

Installation page anchor
yarn add @twilio-paste/side-modal - or - yarn add @twilio-paste/core
import {
  SideModal,
  SideModalBody,
  SideModalButton,
  SideModalContainer,
  SideModalHeader,
  SideModalHeading,
} from '@twilio-paste/core/side-modal';

const SideModalExample: React.FC = () => {
  return (
    <SideModalContainer>
      <SideModalButton variant="primary">Open dialog</SideModalButton>
      <SideModal aria-label="My Dialog">
        <SideModalHeader>
          <SideModalHeading>Dialog header</SideModalHeading>
        </SideModalHeader>
        <SideModalBody>Dialog content</SideModalBody>
      </SideModal>
    </SideModalContainer>
  );
};

SideModal

SideModal page anchor

aria-label RequiredRequired

Title of the dialog for screen readers.

Type
string

element

Overrides the default element name to apply unique styles with the Customization Provider

Type
any
Default
SIDE_MODAL

hideOnEsc

Set to false to disable closing the SideModal when the "Escape" key is pressed.

Type
boolean
Default

element

The element the SideModalButton will render

Type
any
Default
SIDE_MODAL_BUTTON

id

The id of the SideModal that the button controls

Type
string

element

Overrides the default element name to apply unique styles with the Customization Provider

Type
any
Default
SIDE_MODAL_HEADER

i18nDismissLabel

The dismiss button text label

Type
string
Default
close

as

The element the SideModalHeading will render

Type
"h1" | "h2" | "h3" | "h4" | "h5" | "h6"
Default
h2

element

Overrides the default element name to apply unique styles with the Customization Provider

Type
any
Default
SIDE_MODAL_HEADING

state

Returned state from useSideModalState hook

Type
any

element

Overrides the default element name to apply unique styles with the Customization Provider

Type
any
Default
SIDE_MODAL_BODY

element

Overrides the default element name to apply unique styles with the Customization Provider

Type
any
Default
SIDE_MODAL_FOOTER

element

Overrides the default element name to apply unique styles with the Customization Provider

Type
any
Default
SIDE_MODAL_FOOTER_ACTIONS

justifyContent

Sets the justify-content CSS property.

Type
JustifyOptions