# Modal

## Basic | Property | Description | | :--------------------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Height |

Auto - the height of the widget is auto-adjusted with the screen size and display.
Fixed - the heigh of the widget is fixed in terms of 'px' value.

Left - aligns the title to the left of the section.
Center - aligns the title at the middle of the section.
Right - aligns the title to the right end of the section.

| | Hide Title Bar | Toggle this on to hide the header title from display | | Hide Close Button | Toggle this on to hide the 'X' button that closes the modal upon click | | Close on escape key | Pressing the ESC key on the keyboard closes the modal when the widget is active | | Click Outside to Close | Gives users the option to click outside the area to close the modal | | Show Mask | Toggle this on to show a grey-blurred mask on the screen, surrounding the widget | ## Interaction #### Event Handlers | Event | Description | | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **`Close`** |

The "Close" event is activated when the widget is closed. When this event triggers, the associated action gets executed.

| #### Hide This sets whether the widget has to be displayed on the screen when the program is loaded. This shows/hides the widget both on desktop and mobile devices.

## Style

Property	Description
Background	Users can change the colour of the text background using this property. It has all the RGB colour ranges to pick from. It is recommended to use a corresponding background colour that shows the font clearly.
Border Color	Set the colour to the border lines. The border lines will be shown only if that is enabled.
Border Radius	This sets the radius of the widget's corners, enabling rounded corners on the widget. This value is defined in "px" terms.
Box Shadow	The is the colour of the shadow that is generated behind the widget box. The X and Y axis values can be altered such that the shadow can be set to fall anywhere behind the widget area. "x-offset" - a positive number specifies the shadow will be on the right of the box, and a negative number will put the shadow on the left of the box. "y-offset" - a negative one means the shadow will be above the box, and a positive number means the shadow will be below the box. "Blur" - if the number is set to 0 then the shadow will be sharp. It will more blurred as the number goes higher, and the shadow will extend further away. "Color" - sets the colour of the shadow. If the colour is not set, the box shadows are drawn in the foreground colour.
Title Background	Set the background colour for the header text area.
Title Color	Set the colour for the title text. Recommended to pick this colour in contrast with the Title Background to show the text clearly.
Border Width	Set the thickness of the border of the widget using this value. It is defined using "px" terms.
Margin	This value is set in terms of "px" number which creates the space between the border and the content of the widget.
Padding	This value is set in terms of "px" number which creates the space between the border and outer elements.
BG Image	Provide the URL for the image serves as the background image to the widget
BG Repeat	Controls the repetition of the widget's background image. `repeat` - The background image is repeated both vertically and horizontally. `no-repeat` - The background-image is not repeated. The image will only be shown once. The reference to the list of options can be found here: MDN web docs
BG Size	Specifies the size of the background image. `auto`- Default value. The background image is displayed in its original size cover - Resize the background image to cover the entire container, even if it has to stretch the image or cut a little bit off one of the edges The reference to the list of options can be found here: MDN web docs
BG Position	Sets the starting position of a background image. center - keeps the image at the center position. The reference to the list of options can be found here: MDN web docs
BG Origin	Specifies the origin position (the background positioning area) of the background image. The reference to the list of options can be found here: MDN web docs