The Modal frame
A container that appears above other content.
The Modal frame is a container that appears as an overlay in the center of the app when visible. You can add multiple instances of the Modal frame that operate independently.
Try it out
Try out a demo of the Modal frame.
Settings
Modal includes the following configurable options when building apps in the IDE.
Properties
All properties for Modal with supported data types or values. You can write JavaScript almost anywhere in Retool to manipulate or read property values.
enableFullBleed
Whether the container is in full bleed mode, where it can only contain a single component which expands to fit the available space.
global
Whether the object is globally scoped for use in all app pages.
headerPadding
The amount of padding used within the header.
Whether to hide the dropdown when the Esc
key is pressed.
id
The unique identifier.
isHiddenOnDesktop
Whether the component is visible in the desktop layout.
isHiddenOnMobile
Whether the component is visible in the mobile layout.
maintainSpaceWhenHidden
Whether the component takes up space on the canvas if hidden
is true
.
overlayInteraction
Whether to toggle hidden
to true
if the user clicks outside of the content area.
padding
The amount of padding to render inside.
pluginType
The plugin type.
showBorder
Whether to show a border.
showHeader
Whether to show a header area.
showHeaderBorder
Whether to show a border under the header.
showInEditor
Whether to remain visible in the editor if hidden
is true
.
showOverlay
Whether to display a darkened overlay when visible.
Methods
JavaScript API methods for interacting with Modal. You can write JavaScript almost anywhere in Retool and use methods to manipulate data and property values.
hide
Hide the component.
modal.hide()
setHidden
Set the hidden
value to toggle whether the component is visible. Defaults to true
without a parameter.
modal.setHidden(hidden)
Parameters
show
Show the component.
modal.show()
showFooter
Set the showFooter
value to toggle whether the component footer is visible.
modal.showFooter(showFooter)
Parameters
showHeader
Set the showHeader
value to toggle whether the component header is visible.
modal.showHeader(showHeader)
Parameters
showHeader
Whether to show a header area.
toggleHidden
Toggle the hidden
value between true
and false
.
modal.toggleHidden()