Dynamic Regions
New-UDDynamic allows you to define a dynamic region. Pages themselves are dynamic in nature. This means that every time a page is loaded, it runs the PowerShell for that page. Sometimes, you may want to reload a section of a page rather than the whole page itself. This is when you will want to use dynamic regions.
Basic Dynamic Region
This dynamic region reloads when the button is clicked.
New-UDApp -Title "Hello, World!" -Content {
New-UDDynamic -Id 'date' -Content {
New-UDTypography -Text "$(Get-Date)"
}
New-UDButton -Text 'Reload Date' -OnClick { Sync-UDElement -Id 'date' }
}Arguments List
An array of arguments may be passed to the dynamic region.
New-UDDynamic -Id 'dynamic_01' -Content {
New-UDTypography -Text "This is an $($ArgumentList[0]) an $($ArgumentList[1]) in a UDDynamic"
} -ArgumentList @('example of', 'arguments list') You can use Sync-UDElement to change the argument values.
New-UDDynamic -id DynamicRegion -ArgumentList 5,'hello' -content {
foreach($item in $argumentList){
New-UDTypography -Variant h3 -Text "Item: $item"
}
}
New-UDButton -Text "Sync Dynamic" -onclick {
Sync-UDElement -id DynamicRegion -ArgumentList 10,'World'
}Auto Refresh
Dynamic regions enable the ability to auto refresh components after a certain amount of time. The entire region's script block will be run when autorefreshing.
Loading Component
Sometimes refreshing a dynamic component may take some time. For example, if you are querying another service's REST API or a data. Dynamic regions support configuration of the component that shows when the region is reloading. By default, nothing is shown. This can be any app component.
API
See also
Last updated
Was this helpful?