--- title: Modal description: | Modal windows are panels which appear on top of other page content, providing new information within the same page. They are segmented from other page content through a shadowed background and three-dimensional visual elements, which convey that this content is floating on top of other page content. Modals should always be opened through a user action, such as clicking a link, and should be closed through a click or keyboard ESC press. usage: | Modals can be useful in cases where you want to show additional information that's contextually relevant to what's on the current page, without taking the user to a new page. Typically, information in a modal should be limited in quantity - where lots of information needs to be shown, a new non-modal page is typically the best solution. notes: | Modal windows should always include at least one discrete 'Close' link or button. Additionally, modal windows should always close when a user clicks outside of the modal, or presses the ESC key. ---