@hig/modal

Modal

A modal is an overlay that focuses the customer's attention on a single task or set of controls. It creates a mode that disables the main window but keeps it visible with the modal window as a child window in front of it. Users must interact with the modal window before they can return to the parent application.

Read more about when and how to use the Modal component on the internal wiki.

Getting started

Install the package

yarn add @hig/modal @hig/theme-context @hig/theme-data

Import the component and CSS

import Modal from '@hig/modal';
import '@hig/modal/build/index.css';

Basic usage

<Modal
  title="Remove your item?"
  open
>
  <Typography>This action is irreversible.</Typography>
  
  <Button title="Cancel" type="outline" />
  <Button title="Remove" type="outline" />
</Modal>

Styling

You will likely want to provide your own styles for the Modal body content, including positioning for Typography and Button elements. Modal has a stylesheet prop that accepts a function wherein you can modify Modal's styles. For instance

import Modal from "@hig/modal";
import Typography from "@hig/typography";
import Button from "@hig/button";
import merge from "lodash.merge";

function YourComponent() {
  // ...
  const modalStyles = styles =>
    merge(styles, {
      modal: {
        bodyContent: {
          display: "flex",
          flexDirection: "column",
          justifyContent: "space-between"
        }
      }
    })
                                      
  return (
    <Modal open title="Your title" stylesheet={modalStyles}>
      <Typography>Modal content</Typography>
      <div style={{ alignSelf: "flex-end" }}>
        <Button title="Ok" type="outline" />
      </div>
    </Modal>
  )
}