import { ArgTypes, Meta } from '@storybook/addon-docs/blocks';

<Meta isTemplate />

# Dialog

[Source code](https://github.com/carbon-design-system/carbon/tree/main/packages/react/src/components/Dialog)

{/* <!-- START doctoc generated TOC please keep comment here to allow auto update --> <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --> */}

## Table of Contents

- [Overview](#overview)
- [Component API](#component-api)
- [Feedback](#feedback)

{/* <!-- END doctoc generated TOC please keep comment here to allow auto update --> */}

## Overview

The `Dialog` component is a primitive that wraps the native `<dialog>` and
provides a composable api of related components that match the spec for Modals
and non-modal dialogs as documented in the Dialog pattern.

Chrome's built in focus wrap behavior includes the browser bar in the tab order.
This is expected and consistent with `alert()` behavior.
https://github.com/w3c/html/issues/1514#issuecomment-404097904

## Component API

<ArgTypes />

## Feedback

Help us improve this component by providing feedback, asking questions on Slack,
or updating this file on
[GitHub](https://github.com/carbon-design-system/carbon/edit/main/packages/react/src/components/Dialog/Dialog.mdx).
