UNPKG

@skyux/modals

Version:

This library was generated with [Nx](https://nx.dev).

76 lines (75 loc) 4.08 kB
import { StaticProvider } from '@angular/core'; /** * Specifies configuration options for creating a modal. */ export interface SkyModalConfigurationInterface { /** * Whether to display the modal full screen. * This property defaults to `false`. */ fullPage?: boolean; /** * The size for the modal. The valid options are `small`, `medium`, and `large`. * This property defaults to `medium`. */ size?: string; /** * An array property of `providers`. * In Angular, a provider is something that can create or deliver a service. * This property can be used to pass context values from the component that launches the modal to the modal component. */ providers?: StaticProvider[]; /** * The HTML element ID of the element that describes * the modal. This sets the modal's `aria-describedby` attribute to provide a text equivalent for * [to support accessibility](https://developer.blackbaud.com/skyux/learn/accessibility). * The description typically includes text on the modal but not on items that users interact * with, such as buttons and forms. If you do not specify an ID, the default description is * the content of the `sky-modal-content` component. * For more information about the `aria-describedby` attribute, see the [WAI-ARIA definition](https://www.w3.org/TR/wai-aria/#aria-describedby). * @deprecated Set `headingText` on the modal component instead. */ ariaDescribedBy?: string; /** * The HTML element ID of the element that labels * the modal. This sets the `aria-labelledby` attribute for the modal to provide a text equivalent for * [to support accessibility](https://developer.blackbaud.com/skyux/learn/accessibility). * This is typically a header element, and if you do not specify an ID, the default value * is the content of the `sky-modal-header` component. * For more information about the `aria-labelledby` attribute, see the [WAI-ARIA definition](https://www.w3.org/TR/wai-aria/#aria-labelledby). * @deprecated Set `headingText` on the modal component instead. */ ariaLabelledBy?: string; /** * The ARIA role for the modal * [to support accessibility](https://developer.blackbaud.com/skyux/learn/accessibility) * by indicating how the modal functions and what it controls. For information about * how an ARIA role indicates what an item represents on a web page, see the * [WAI-ARIA roles model](http://www.w3.org/WAI/PF/aria/#roles). By default, modals set * the ARIA role to `dialog`. * @default "dialog" */ ariaRole?: string; /** * Whether the modal uses tiles. When set to `true`, the modal's background switches * to `$sky-background-color-neutral-light` and tile headings are styled as subsection headings. * This property defaults to `false`. * @deprecated Tiles inside modals are no longer a recommended design pattern. For complex forms, use [sectioned forms](https://developer.blackbaud.com/skyux/components/sectioned-form) or [other form containers](https://developer.blackbaud.com/skyux/design/guidelines/form-design) instead. */ tiledBody?: boolean; /** * The `helpKey` string. This property displays * the <i class="fa fa-question-circle" aria-hidden="true"></i> button in the modal header. * When users click this button, the `helpOpened` event broadcasts the `helpKey` parameter. * Blackbaud developers can use the Help Widget, which is for internal Blackbaud use only, to * [display help content in a flyout panel](https://docs.blackbaud.com/bb-help-docs/components/modal-header). * @deprecated To display a help button in the modal header, set either the * `helpKey` or `helpPopoverContent` inputs on the modal component. */ helpKey?: string; /** * The CSS class to add to the modal, such as `ag-custom-component-popup` for * using a modal as part of a cell editor in Data Entry Grid. */ wrapperClass?: string; }