mirror of
https://github.com/material-components/material-components-ios.git
synced 2026-02-20 08:27:32 +08:00
95fbb31946
Context We recently added an API for a DialogThemer but we are yet to update the README. The problem We are missing docs for the new API The fix Update the readme to have the new themer API Related issues b/116306933
57 lines
1.7 KiB
Markdown
57 lines
1.7 KiB
Markdown
# Dialogs
|
|
|
|
<!-- badges -->
|
|
|
|
Dialogs inform users about a task and can contain critical information, require decisions, or
|
|
involve multiple tasks.
|
|
|
|
<div class="article__asset article__asset--screenshot">
|
|
<img src="docs/assets/dialogs.gif" alt="Dialogs" width="320">
|
|
</div>
|
|
|
|
<!-- design-and-api -->
|
|
|
|
<!-- toc -->
|
|
|
|
- - -
|
|
|
|
## Overview
|
|
|
|
To display a modal using MaterialDialogs you set two properties on the view controller to be
|
|
presented. Set modalPresentationStyle to UIModalPresentationCustom and set
|
|
transitioningDelegate to and instance of MDCDialogTransitionController. Then you present the
|
|
view controller from the root controller to display it as a modal dialog.
|
|
|
|
### Presentation and transition controller
|
|
|
|
Presenting dialogs uses two classes: MDCDialogPresentationController and
|
|
MDCDialogTransitionController. These allow the presentation of view controllers in a material
|
|
specificed manner. MDCDialogPresentationController is a subclass of UIPresentationController
|
|
that observes the presented view controller for preferred content size.
|
|
MDCDialogTransitionController implements UIViewControllerAnimatedTransitioning and
|
|
UIViewControllerTransitioningDelegate to vend the presentation controller during the transition.
|
|
|
|
### Alert controller
|
|
|
|
MDCAlertController provides a simple interface for developers to present a modal dialog
|
|
according to the Material spec.
|
|
|
|
## Installation
|
|
|
|
- [Typical installation](../../../docs/component-installation.md)
|
|
|
|
## Usage
|
|
|
|
- [Typical use: modal dialog](typical-use-modal-dialog.md)
|
|
- [Typical use: alert](typical-use-alert.md)
|
|
|
|
## Extensions
|
|
|
|
- [Theming](theming.md)
|
|
- [Color Theming](color-theming.md)
|
|
- [Typography Theming](typography-theming.md)
|
|
|
|
## Accessibility
|
|
|
|
- [Accessibility](accessibility.md)
|