ESLint plugin

The essential plugin for use with the Atlassian Design System.

use-modal-dialog-close-button

The modal dialog should have a dedicated close button to ensure it is accessible for all users.

Examples

This rule will warn makers if the hasCloseButton prop is not set to true or if the CloseButton component is not used.

Incorrect

<ModalDialog>
    ^^^^^^^^^^^ `hasCloseButton` on `ModalHeader` should be set to `true` or `CloseButton` component should be used to make modal dialog accessible.
    <div>
        <ModalTitle>Modal Title</ModalTitle>
    </div>
</ModalDialog>

<ModalDialog>
    ^^^^^^^^^^^ `hasCloseButton` on `ModalHeader` should be set to `true` or `CloseButton` component should be used to make modal dialog accessible.
    <ModalHeader>
        <ModalTitle>Modal Title</ModalTitle>
    </ModalHeader>
</ModalDialog>

<ModalDialog>
    ^^^^^^^^^^^ `hasCloseButton` on `ModalHeader` should be set to `true` or `CloseButton` component should be used to make modal dialog accessible.
    <ModalHeader hasCloseButton={false}>
        <ModalTitle>Modal Title</ModalTitle>
    </ModalHeader>
</ModalDialog>

Correct

<ModalDialog>
    <ModalHeader hasCloseButton>
        <ModalTitle>Modal Title</ModalTitle>
    </ModalHeader>
</ModalDialog>

<ModalDialog>
    <ModalHeader>
        <Box>
            <ModalTitle>Modal Title</ModalTitle>
            <CloseButton onClick={onClose} />
        </Box>
    </ModalHeader>
</ModalDialog>
Was this page helpful?
We use this feedback to improve our documentation.
  • Design system
    • Get started
    • Foundations
    • Components
    • Rovo UI
    • Tools
    • Release phases
    • Contact us
© 2026 AtlassianTrademark, (opens new window)Privacy, (opens new window)License