This is the legacy documentation of Project-level Custom Applications, which is in maintenance mode. Visit the new documentation for Org-level Custom Applications.

Form Modal Page

Description

Form Modal pages are controlled components used to render a page with a form or something that requires user input, similar to InfoModalPage but semantically with a different role. The header includes buttons to control the submission or cancellation of the form. These buttons can be overwritten with custom controls by using the <CustomFormModalPage> component.

Usage

import { FormModalPage } from '@commercetools-frontend/application-components';

<FormModalPage
  title="Lorem ipsum"
  isOpen={true}
  onClose={handleClose}
  subtitle={<Text.Body>{'Lorem ipsum ...'}</Text.Body>}
  topBarCurrentPathLabel="Lorem ipsum"
  topBarPreviousPathLabel="Back"
  onSecondaryButtonClick={handleCancel}
  onPrimaryButtonClick={handleSubmit}
>
  <TextField {...textFieldFormProps} />
</FormModalPage>;

Properties

Props	Type	Required	Default	Description
`isOpen`	`boolean`	✅	-	Indicates whether the page is open or closed. The parent component needs to manage this state.
`title`	`string`	✅	-	The title of the page.
`subtitle`	`node` or `string`	-	-	The subtitle of the page, usually a React component. If a string is passed, it's rendered as a paragraph.
`onClose`	`function`	-	-	Called when the page closes click on overlay, click on close button, press ESC. If the function is not provided, the page cannot be closed by any of the listed options.
`level`	`number`		`1`	The level indicates the stack position of the modal page, progressively increasing the `z-index` position (combined with the `baseZIndex`) as well as the spacing from the left side of the page.
`baseZIndex`	`number`		`1000`	The base `z-index` value to be applied to the overlay container, incremented by `1` according to the `level` prop.
`zIndex`	`number`		-	The `z-index` value to be applied to the overlay container. This value overrides the normal `z-index` value calculated from the `baseZIndex` and `level` props. If you provide this value, you would need to take care of providing a proper `z-index` based on the stacked level.
`topBarCurrentPathLabel`	`string`		The `title` prop	Label to appear as the current path of the top bar of the modal.
`topBarPreviousPathLabel`	`string`		`"Go Back"` (translated)	Label to appear as the previous path of the top bar of the modal.
`children`	`node`	✅	-	Content rendered within the page. If the content is long in height (depending on the screen size) a scrollbar will appear.
`labelSecondaryButton`	`string` \| `Intl message`	✅	-	`Cancel`
`labelPrimaryButton`	`string` \| `Intl message`	✅	-	`Confirm`
`onSecondaryButtonClick`	`function`	✅	-	Called when the secondary button is clicked.
`onPrimaryButtonClick`	`function`	✅	-	Called when the primary button is clicked.
`isPrimaryButtonDisabled`	`boolean`	-	`false`	Indicates whether the primary button is disabled or not.
`dataAttributesSecondaryButton`	`object`	-	-	Use this prop to pass `data-` attributes to the secondary button.
`dataAttributesPrimaryButton`	`object`	-	-	Use this prop to pass `data-` attributes to the primary button.
`getParentSelector`	`function`	-	-	The function should return an HTML element that will be used as the parent container to hold the modal DOM tree. If no function is provided, it's expected that an HTML element with the `id="parent-container"` is present in the DOM. In the `NODE_ENV=test` environment, the default HTML element is `body`.
`shouldDelayOnClose`	`bool`	-	`true`	Sets whether the ModalPage should delay calling its `onClose` function to allow the closing animation time to finish. This can be turned off if the developer is controlling the ModalPage only through the `isOpen` prop, and not abruptly mounting/unmounting it or one of its parent elements. You might also want to turn this off if you need to display a Prompt (for example to save changes) on the ModalPage before navigating out of it, as this option makes the Modal close itself before `onClose` is called.
`afterOpenStyles`	`string` or `object`	-	-	Overwrite the default styles of `afterOpen`. You can pass a "class name" or a CSS-in-JS style object. This should be used only in cases the default styles are causing some layout issues.

Static properties

`FormModalPage.Intl`

This is a convenience proxy export to expose pre-defined Intl messages defined in the @commercetools-frontend/i18n package. The Intl messages can be used for button labels.

<FormModalPage
  // other props...
  labelSecondaryButton={FormModalPage.Intl.revert}
/>