Primary version
Modal
Universal Dashboard is now a part of PowerShell Universal. This documentation is for reference to the v2 version of Universal Dashboard and is no longer maintained.
Modal
Modals are popup windows that appear above the website. You can show a modal from an endpoint using
Show-UDModal.Displaying Modals
In the below example, when you click the button a modal will be shown that contains the text specified. You can place any UD controls within the header and content script blocks.
1
New-UDButton -Text "Show Modal" -OnClick {
2
Show-UDModal -Content {
3
New-UDHeading -Text "Hello, Modal"
4
}
5
}
Copied!
Clicking the button will bring up a modal that looks like this.
Modal with a Heading in the Content
Hiding Modals
You can also hide modals using the
Hide-UDModal cmdlet. This cmdlet takes no arguments and simply hides the modal. This could be done after showing progress. In this example, we create a persistent modal that cannot be hidden by the user. Once the Start-Sleep cmdlet timer elapses, the modal will close with Hide-UDModal.1
New-UDButton -Text "Show Modal" -OnClick {
2
Show-UDModal -Content {
3
New-UDHeading -Text "Loading some stuff..."
4
} -Persistent
5
Start-Sleep -Seconds 4
6
Hide-UDModal
7
}
Copied!
Adjusting Modal Size
You can adjust the height and width of a modal using the
-Height and -Width parameters of Show-UDModal. These parameters accept any valid HTML\CSS sizing such as px or em.Here is an example of setting a modal to a certain pixel size.
1
New-UDButton -Text "Show Modal" -OnClick {
2
Show-UDModal -Content {
3
New-UDHeading -Text "Hello, Modal"
4
} -Height '500px' -Width '1500px'
5
}
Copied!
Large modal
Color
You can change the color of a modal using the
-BackgroundColor and -FontColor parameters of Show-UDModal.1
New-UDButton -Text "Show Modal" -OnClick {
2
Show-UDModal -Content {
3
New-UDHeading -Text "Hello, Modal" -Color 'white'
4
} -BackgroundColor green
5
}
Copied!
Green Modal
Last modified 3mo ago
Copy link