UniversalDashboard.MaterialUI.psm1
|
$TAType = [psobject].Assembly.GetType('System.Management.Automation.TypeAccelerators') $TAtype::Add('DashboardColor', 'UniversalDashboard.Models.DashboardColor') $TAtype::Add('Endpoint', 'UniversalDashboard.Models.Endpoint') $TAtype::Add('FontAwesomeIcons', 'UniversalDashboard.Models.FontAwesomeIcons') function New-UDRow { [CmdletBinding(DefaultParameterSetName = 'static')] param( [Parameter()] [String]$Id = ([Guid]::NewGuid()), [Parameter(ParameterSetName = "static", Position = 0)] [ScriptBlock]$Columns, [Parameter(ParameterSetName = "dynamic")] [object]$Endpoint, [Parameter(ParameterSetName = "dynamic")] [Switch]$AutoRefresh, [Parameter(ParameterSetName = "dynamic")] [int]$RefreshInterval = 5 ) End { # if ($PSCmdlet.ParameterSetName -eq 'dynamic') # { # throw "dynamic parameterset not yet supported" # } New-UDGrid -Container -Content { & $Columns } } } function New-UDColumn { [CmdletBinding(DefaultParameterSetName = 'content')] param( [Parameter()] [String]$Id = ([Guid]::NewGuid()), [Parameter()] [Alias('Size')] [ValidateRange(1, 12)] [int]$SmallSize = 12, [Parameter()] [ValidateRange(1, 12)] [int]$LargeSize = 12, [Parameter()] [ValidateRange(1, 12)] [int]$MediumSize = 12, [Parameter()] [ValidateRange(1, 12)] [int]$ExtraLargeSize, [Parameter()] [ValidateRange(1, 12)] [int]$ExtraSmallSize, [Parameter(ParameterSetName = 'content', Position = 1)] [ScriptBlock]$Content, [Parameter(ParameterSetName = "endpoint")] [Endpoint]$Endpoint, [Parameter(ParameterSetName = "endpoint")] [Switch]$AutoRefresh, [Parameter(ParameterSetName = "endpoint")] [int]$RefreshInterval = 5 ) $Parameters = @{} if ($PSCmdlet.MyInvocation.BoundParameters.ContainsKey("ExtraLargeSize")) { $Parameters.Add("ExtraLargeSize", $ExtraLargeSize) } if ($PSCmdlet.MyInvocation.BoundParameters.ContainsKey("ExtraSmallSize")) { $Parameters.Add("ExtraSmallSize", $ExtraSmallSize) } if ($PSCmdlet.ParameterSetName -eq 'content') { $GridContent = $Content New-UDGrid -Id $Id -Item -SmallSize $SmallSize -MediumSize $MediumSize -LargeSize $LargeSize -Content { & $GridContent } @Parameters } else { New-UDGrid -Id $Id -Item -SmallSize $SmallSize -MediumSize $MediumSize -LargeSize $LargeSize -Content { New-UDDynamic -AutoRefresh:$AutoRefresh -AutoRefreshInterval $RefreshInterval -Content $Endpoint } @Parameters } } function New-UDNivoTheme { param( [Parameter()] [UniversalDashboard.Models.DashboardColor]$TickLineColor, [Parameter()] [UniversalDashboard.Models.DashboardColor]$TickTextColor, [Parameter()] [UniversalDashboard.Models.DashboardColor]$GridLineStrokeColor, [Parameter()] [int]$GridStrokeWidth ) @{ axis = @{ ticks = @{ line = @{ stoke = $TickLineColor.HtmlColor } text = @{ fill = $TickTextColor.HtmlColor } } } grid = @{ line = @{ stroke = $GridLineStrokeColor.HtmlColor strokeWidth = $GridStrokeWidth } } } } function New-UDChartJS { param( [Parameter()] [string]$Id = [Guid]::NewGuid(), [Parameter(ParameterSetName = 'Simple')] [string]$DatasetLabel, [Parameter()] [ValidateSet('bar', 'line', 'area', 'doughnut', 'radar', 'pie', 'bubble')] [string]$Type, [Parameter()] [Hashtable]$Options, [Parameter()] [Endpoint]$OnClick, [Parameter(Mandatory)] $Data, [Parameter(ParameterSetName = 'Datasets', Mandatory)] [Hashtable[]]$Dataset, [Parameter(ParameterSetName = "Simple")] [string]$DataProperty = '', [Parameter()] [string]$LabelProperty = '', [Parameter(ParameterSetName = "Simple")] [UniversalDashboard.Models.DashboardColor[]]$BackgroundColor = @("#808978FF"), [Parameter(ParameterSetName = "Simple")] [UniversalDashboard.Models.DashboardColor[]]$BorderColor = @("#FF8978FF"), [Parameter(ParameterSetName = "Simple")] [UniversalDashboard.Models.DashboardColor[]]$HoverBackgroundColor = @("#807B210C"), [Parameter(ParameterSetName = "Simple")] [UniversalDashboard.Models.DashboardColor[]]$HoverBorderColor = @("#FF7B210C"), [Parameter(ParameterSetName = "Simple")] [int]$BorderWidth = 1 ) if ($OnClick) { $OnClick.Register($Id, $PSCmdlet) | Out-Null } if ($PSCmdlet.ParameterSetName -eq 'Simple') { if (-not $DatasetLabel) { $DatasetLabel = $DataProperty } $Dataset += New-UDChartJSDataset -Data $Data -DataProperty $DataProperty -Label $DatasetLabel -BackgroundColor $BackgroundColor -BorderColor $BorderColor -HoverBackgroundColor $HoverBackgroundColor -HoverBorderColor $HoverBorderColor -BorderWidth $BorderWidth } Foreach ($datasetDef in $Dataset) { if ($datasetDef.DataProperty) { $datasetDef.data = @($Data | ForEach-Object { $_.($datasetDef.DataProperty) }) } } @{ type = 'ud-chartjs' id = $id isPlugin = $true assetId = $AssetId chartType = $Type.ToLower() options = $Options onClick = $OnClick data = @{ labels = @($Data | ForEach-Object { $_.($LabelProperty) }) datasets = $dataset } } } function New-UDChartJSDataset { [CmdletBinding()] param( [object]$Data = @(), [string]$DataProperty, [string]$Label, [UniversalDashboard.Models.DashboardColor[]]$BackgroundColor = @("#807B210C"), [UniversalDashboard.Models.DashboardColor[]]$BorderColor = @("#FF7B210C"), [int]$BorderWidth, [UniversalDashboard.Models.DashboardColor[]]$HoverBackgroundColor = @("#807B210C"), [UniversalDashboard.Models.DashboardColor[]]$HoverBorderColor = @("#FF7B210C"), [int]$HoverBorderWidth, [string]$XAxisId, [string]$YAxisId, [Hashtable]$AdditionalOptions ) Begin { $datasetOptions = @{ data = $Data DataProperty = $DataProperty label = $Label backgroundColor = $BackgroundColor.HtmlColor borderColor = $BorderColor.HtmlColor borderWidth = $BorderWidth hoverBackgroundColor = $HoverBackgroundColor.HtmlColor hoverBorderColor = $HoverBorderColor.HtmlColor hoverBorderWidth = $HoverBorderWidth xAxisId = $XAxisId yAxisId = $YAxisId } if ($AdditionalOptions) { $AdditionalOptions.GetEnumerator() | ForEach-Object { $datasetOptions.($_.Key) = $_.Value } } $datasetOptions } } function New-UDChartJSMonitor { param( [Parameter()] [string]$Id = [Guid]::NewGuid(), [Parameter()] [ValidateSet('bar', 'line', 'area', 'doughnut', 'radar', 'pie', 'horizontalBar')] [string]$Type = 'line', [Parameter()] [int]$DataPointHistory = 10, [Parameter()] [Hashtable]$Options, [Parameter()] [DashboardColor[]]$ChartBackgroundColor, [Parameter()] [DashboardColor[]]$ChartBorderColor, [Parameter(Mandatory)] [string[]]$Labels = @(), [Parameter()] [Switch]$AutoRefresh, [Parameter()] [int]$RefreshInterval = 5, [Parameter(Mandatory)] [Endpoint]$LoadData ) $LoadData.Register($Id, $PSCmdlet) | Out-Null @{ type = 'chartjs-monitor' id = $id assetId = $AssetId isPlugin = $true loadData = $LoadData labels = $Labels dataPointHistory = $DataPointHistory chartType = $Type.ToLower() options = $Options autoRefresh = $AutoRefresh refreshInterval = $RefreshInterval chartBackgroundColor = if ($chartBackgroundColor) { $chartBackgroundColor.HtmlColor } else { @() } chartBorderColor = if ($ChartBorderColor) { $ChartBorderColor.HtmlColor } else { @() } } } function Out-UDChartJSMonitorData { [CmdletBinding()] param( [Parameter(ValueFromPipeline = $true)] $Data ) Begin { New-Variable -Name Items -Value @() } Process { $Items += $Data } End { $Timestamp = [DateTime]::UtcNow $dataSets = @() foreach ($item in $Items) { $dataSets += @{ x = $Timestamp y = $item } } $dataSets | ConvertTo-Json } } function New-UDSparkline { param( [Parameter()] [string]$Id = [Guid]::NewGuid().ToString(), [Parameter(Mandatory)] [int[]]$Data, [Parameter()] [int]$Limit, [Parameter()] [int]$Width, [Parameter()] [int]$Height, [Parameter()] [int]$Margin, [Parameter()] [DashboardColor]$Color, [Parameter()] [ValidateSet("bars", "lines", "both")] $Type = 'bars', [Parameter()] [int]$Min, [Parameter()] [int]$Max ) @{ type = 'sparklines' isPlugin = $true assetId = $AssetId id = $Id data = $data limit = $Limit width = $Width height = $Height marin = $Margin color = $Color.HtmlColor sparkType = $Type min = $Min max = $Max } }function New-UDAlert { <# .SYNOPSIS Creates an alert. .DESCRIPTION Creates an alert. .PARAMETER Id The ID of this component. .PARAMETER Severity The severity of this alert. .PARAMETER Children Content of the alert. .PARAMETER Text Text for the body of the alert. .PARAMETER Title A title for this alert. .PARAMETER ClassName A CSS class to apply to the alert. .PARAMETER Style An hashtable of styles to apply to this component. #> param( [Parameter()] [string]$Id = [Guid]::NewGuid(), [Parameter()] [ValidateSet("success", "error", "warning", "info")] [string]$Severity = "success", [Parameter(ParameterSetName = "Content")] [Alias("Content")] [scriptblock]$Children, [Parameter(ParameterSetName = "Text")] [string]$Text, [Parameter()] [string]$Title, [Parameter()] [string]$ClassName, [Parameter()] [Hashtable]$Style ) if ($PSCmdlet.ParameterSetName -eq 'Text') { $Children = { $Text } } @{ type = "mu-alert" id = $id isPlugin = $true assetId = $MUAssetId severity = $Severity.ToLower() children = & $Children title = $Title className = $ClassName style = $Style } } function New-UDAppBar { <# .SYNOPSIS Creates an AppBar. .DESCRIPTION Creates an AppBar. This can be used to replace the built-in AppBar. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Drawer A drawer that can be opened from this AppBar. Use New-UDDrawer to create a drawer to pass to this parameter. .PARAMETER Children Children of this AppBar. The children of an AppBar are commonly text and buttons. .PARAMETER Position The position of this AppBar. A fixed position will override the default AppBar. .PARAMETER Footer Positions the app bar at the bottom of the page to create a footer .PARAMETER DisableThemeToggle Removes the theme toggle switch from the app bar. .PARAMETER Color The theme color to use for the app bar. .PARAMETER ClassName A CSS class to apply to the app bar. .EXAMPLE Creates a new AppBar that is relative to other components. New-UDAppBar -Children { New-UDTypography -Text 'Hello' -Paragraph } -Position relative #> param( [Parameter()] [string]$Id = [Guid]::NewGuid(), [Parameter()] [Hashtable]$Drawer, [Parameter()] [Alias('Content')] [ScriptBlock]$Children, [Parameter()] [ValidateSet('absolute', 'fixed', 'relative', 'static', 'sticky')] [string]$Position = 'fixed', [Parameter()] [switch]$Footer, [Parameter()] [Switch]$DisableThemeToggle, [Parameter()] [string]$ClassName, [Parameter()] [ValidateSet('default', 'inherit', 'primary', 'secondary', 'transparent')] [string]$Color = 'default' ) @{ id = $Id type = 'mu-appbar' assetId = $MUAssetId isPlugin = $true children = & $Children drawer = $Drawer position = $Position footer = $Footer.IsPresent disableThemeToggle = $DisableThemeToggle.IsPresent className = $ClassName color = $Color.ToLower() } } function New-UDAutocomplete { <# .SYNOPSIS Creates an autocomplete textbox. .DESCRIPTION Creates an autocomplete textbox. Autocomplete text boxes can be used to allow the user to select from a large list of static or dynamic items. Typing in the textbox will filter the list. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Label The label to show for the textbox. .PARAMETER Value The value of the textbox. .PARAMETER OnChange A script block that is invoked when the selection changes. .PARAMETER OnLoadOptions A script block that is called when the user starts typing in the text box. The $Body variable will contain the typed text. You should return a JSON array of values that are a result of what the user has typed. .PARAMETER Options Static options to display in the selection drop down. When the user types, these options will be filtered. .PARAMETER FullWidth Whether the component should take up the full width of its parent. .PARAMETER Variant The variant of the text box. Valid values are: "filled", "outlined", "standard" .PARAMETER Multiple Whether multiple items can be selected. .PARAMETER ClassName A CSS class to apply to the component. .PARAMETER Icon The icon to display before the text box. Use New-UDIcon to create the value for this parameter. .PARAMETER OnEnter A script block to call when the user presses enter within the autocomplete textbox. .EXAMPLE Creates a autocomplete with a static list of options. New-UDAutocomplete -Id 'autoComplete' -Options @('Test', 'Test2', 'Test3', 'Test4') .EXAMPLE Creates an autocomplete with a dynamically filtered set of options New-UDAutocomplete -Id 'autoCompleteDynamic' -OnLoadOptions { @('Test', 'Test2', 'Test3', 'Test4') | Where-Object { $_ -match $Body } | ConvertTo-Json } #> param( [Parameter()] [String]$Id = ([Guid]::NewGuid()), [Parameter()] [string]$Label, [Parameter()] [string]$Value, [Parameter()] [Endpoint]$OnChange, [Parameter(Mandatory, ParameterSetName = "Dynamic")] [Endpoint]$OnLoadOptions, [Parameter(Mandatory, ParameterSetName = "Static")] $Options, [Parameter()] [Switch]$FullWidth, [Parameter()] [ValidateSet("filled", "outlined", "standard")] [string]$Variant = "standard", [Parameter()] [Switch]$Multiple, [Parameter()] [string]$ClassName, [Parameter()] $Icon, [Parameter()] [Endpoint]$OnEnter ) if (-not $Options) { $Options = @() } elseif ($Options -is [scriptblock]) { $Options = & $Options } if ($OnChange) { $OnChange.ContentType = 'text/plain'; $OnChange.Register($Id + "onChange", $PSCmdlet) } if ($OnEnter) { $OnEnter.Register($Id + "onEnter", $PSCmdlet) } if ($PSCmdlet.ParameterSetName -eq 'Dynamic') { if ($OnLoadOptions) { $OnLoadOptions.ContentType = 'text/plain'; $OnLoadOptions.Register($Id + "onLoadOptions", $PSCmdlet) } } @{ id = $id assetId = $MUAssetId isPlugin = $true type = "mu-autocomplete" label = $Label value = $value onChange = $onChange onLoadOptions = $OnLoadOptions options = $Options fullWidth = $FullWidth.IsPresent variant = $Variant.ToLower() multiple = $Multiple.IsPresent className = $ClassName icon = $icon onEnter = $OnEnter } } function New-UDAutocompleteOption { <# .SYNOPSIS Creates a new autocomplete option. .DESCRIPTION Creates a new autocomplete option. This cmdlet is to be used with New-UDAutocomplete. Pass the result of this cmdlet to the -Options parameter to create a new option. .PARAMETER Name The name of the autocomplete option. This will be shown in the autocomplete. .PARAMETER Value The value of the autocomplete option. This will be passed back to New-UDForm -OnSubmit or the $EventData for -OnChange on New-UDAutocomplete. #> param( [Parameter(Mandatory = $true)] [String]$Name, [Parameter(Mandatory = $true)] [String]$Value ) @{ type = 'mu-autocomplete-option' name = $Name value = $Value } } function New-UDAvatar { <# .SYNOPSIS Creates a new Avatar. .DESCRIPTION Creates a new Avatar. An avatar is typically an image of a user. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Image The URL of an image to show in the avatar. .PARAMETER Alt The alt text to assign to the avatar. .PARAMETER ClassName Classes to assign to the avatar component. .PARAMETER Variant The variant type of the avatar. .EXAMPLE A small avatar using Alon's image. New-UDAvatar -Image 'https://avatars2.githubusercontent.com/u/34351424?s=460&v=4' -Alt 'alon gvili avatar' -Id 'avatarContent' -Variant small #> param( [Parameter ()][string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter ()][string]$Image, [Parameter ()][string]$Alt, [Parameter ()][string]$ClassName, [Parameter ()] [ValidateSet("square", 'rounded')] [string]$Variant = 'rounded', [Parameter()] $Sx, [Parameter()] [Alias("Content")] [ScriptBlock]$Children ) End { $Avatar = @{ type = 'mu-avatar' isPlugin = $true assetId = $MUAssetId id = $Id image = $Image alt = $Alt variant = $Variant.ToLower() className = $ClassName sx = $Sx children = if ($Children) { & $Children } } $Avatar.PSTypeNames.Insert(0, "UniversalDashboard.MaterialUI.Avatar") | Out-Null $Avatar } } function New-UDAvatarGroup { <# .SYNOPSIS A group of avatars. .DESCRIPTION A group of avatars. .PARAMETER Id The ID for this component. .PARAMETER Total If you need to control the total number of avatars not shown, you can use the total prop. .PARAMETER Maximum AvatarGroup renders its children as a stack. Use the max prop to limit the number of avatars. .PARAMETER Children Avatars for the group. .EXAMPLE An example .NOTES General notes #> param( [Parameter ()] [string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter()] [int]$Total, [Parameter()] [int]$Maximum, [Parameter(Mandatory)] [Alias("Content")] [ScriptBlock]$Children, [Parameter()] $Sx ) $Avatar = @{ type = 'mu-avatar-group' isPlugin = $true assetId = $MUAssetId id = $Id sx = $Sx children = & $Children } if ($PSBoundParameters.ContainsKey("Total")) { $Avatar['total'] = $Total } if ($PSBoundParameters.ContainsKey("Maximum")) { $Avatar['max'] = $Maximum } $Avatar } function New-UDBackdrop { <# .SYNOPSIS Creates an overlay over the current page. .DESCRIPTION Creates an overlay over the current page. .PARAMETER Id The ID of this component .PARAMETER Color The color of the backdrop. .PARAMETER Children Child components to include in the backdrop. .PARAMETER Open Whether the backdrop is open. .PARAMETER OnClick A script block to invoke when the backdrop is clicked. .PARAMETER ClassName A CSS class to apply to the backdrop. #> param( [Parameter ()] [string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter()] [DashboardColor]$Color = '#fff', [Parameter(Mandatory)] [Alias("Content")] [ScriptBlock]$Children, [Parameter()] [Switch]$Open, [Parameter()] [Endpoint]$OnClick, [Parameter()] [string]$ClassName ) if ($OnClick) { $OnClick.Register($Id, $PSCmdlet) } @{ type = 'mu-backdrop' isPlugin = $true assetId = $MUAssetId id = $Id color = $Color.HtmlColor children = & $Children open = $Open.IsPresent onClick = $OnClick className = $ClassName } } function New-UDBadge { param( [Parameter ()] [string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter()] [ValidateSet("defeault", 'primary', 'secondary', 'error', 'info', 'success', 'warning')] [string]$Color = 'default', [Parameter(Mandatory)] [Alias("Content")] [ScriptBlock]$Children = {}, [Parameter()] [scriptblock]$BadgeContent = {}, [Parameter()] [Switch]$Invisible, [Parameter()] [int]$Max = 99, [Parameter()] [ValidateSet('circular', 'rectangular')] [string]$Overlap = 'rectangular', [Parameter()] [Switch]$ShowZero, [Parameter()] [ValidateSet('standard', 'dot')] [string]$Variant = 'standard', [Parameter()] [ValidateSet('topright', 'topleft', 'bottomright', 'bottomleft')] [string]$Location = 'topright' ) @{ type = 'mu-badge' isPlugin = $true assetId = $MUAssetId id = $Id color = $Color.ToLower() children = & $Children badgeContent = & $BadgeContent invisible = $Invisible.IsPresent max = $Max overlap = $Overlap.ToLower() showZero = $ShowZero.IsPresent variant = $Variant.ToLower() location = $Location.ToLower() } } <# New-UDBadge -Content { New-UDIcon -Icon 'User' -Size 2x } -BadgeContent { 100 } -Color primary #> function New-UDButton { <# .SYNOPSIS Creates a new button. .DESCRIPTION Creates a new button. Buttons are used to allow the user to take action. .PARAMETER Text The text to show within the button. .PARAMETER Icon An icon to show within the button. Use New-UDIcon to create an icon for this parameter. .PARAMETER Variant The variant type for this button. Valid values are: "text", "outlined", "contained" .PARAMETER IconAlignment How to align the icon within the button. Valid values are: "left", "right" .PARAMETER FullWidth Whether the button takes the full width of the it's container. .PARAMETER OnClick The action to take when the button is clicked. .PARAMETER Size The size of the button. Valid values are: "small", "medium", "large" .PARAMETER Style Styles to apply to the button. .PARAMETER Href A URL that the user should be redirected to when clicking the button. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Color The color of the component. Valid values are: 'default', 'inherit', 'primary', 'secondary' .PARAMETER Disabled Whether the button is disabled. .PARAMETER ClassName The CSS Class to apply to the button. .EXAMPLE Creates a button with the GitHub logo and redirects the user to GitHub when clicked. $Icon = New-UDIcon -Icon 'github' New-UDButton -Text "Submit" -Id "btnClick" -Icon $Icon -OnClick { Invoke-UDRedirect https://github.com } .EXAMPLE Creates a button with a blue background. New-UDButton -Text "Submit" -Style @{ backgroundColor = "blue"} -OnClick { Invoke-UDRedirect https://github.com } #> param ( [Parameter (Position = 0)] [string]$Text, [Parameter (Position = 1)] $Icon, [Parameter (Position = 2)] [ValidateSet("text", "outlined", "contained")] [string]$Variant = "contained", [Parameter (Position = 3)] [ValidateSet("left", "right")] [string]$IconAlignment = "left", [Parameter (Position = 6)] [switch]$FullWidth, [Parameter (Position = 7)] [Endpoint]$OnClick, [Parameter (Position = 8)] [ValidateSet("small", "medium", "large")] [string]$Size, [Parameter (Position = 9)] [Hashtable]$Style, [Parameter (Position = 10)] [string]$Href, [Parameter()] [string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter()] [ValidateSet('default', 'inherit', 'primary', 'secondary', 'success', 'error', 'info', 'warning')] [string]$Color = 'primary', [Parameter()] [Switch]$Disabled, [Parameter()] [string]$ClassName, [Parameter()] [Switch]$ShowLoading, [Parameter()] [object]$LoadingIndicator, [Parameter()] [ValidateSet('center', 'start', 'end')] [string]$LoadingPosition = "center" ) End { if ($OnClick) { $OnClick.Register($Id, $PSCmdlet) } if ($Color -eq 'default') { $Color = 'primary' } @{ # Mandatory properties to load as plugin. type = 'mu-button' isPlugin = $true assetId = $MUAssetId # Command properties. id = $Id text = $Text variant = $Variant.ToLower() onClick = $OnClick iconAlignment = $IconAlignment disabled = $Disabled.IsPresent icon = $Icon fullWidth = $FullWidth.IsPresent size = $Size href = $Href style = $Style color = if ($Color) { $Color.ToLower() } else { $null } className = $ClassName showLoading = $ShowLoading.IsPresent loadingIndicator = $LoadingIndicator loadingPosition = $LoadingPosition.ToLower() } } } function New-UDCard { <# .SYNOPSIS Creates a new card. .DESCRIPTION Creates a new card. Cards are used to display related content. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER ClassName A CSS class to assign to this card. .PARAMETER ShowToolBar Whether to show the toolbar for this card. .PARAMETER ToolBar The toolbar for this card. Use New-UDCardToolbar to create a toolbar. .PARAMETER Header The header for this card. The header typically contains a title for the card. Use New-UDCardHeader to create a header. .PARAMETER Body The body for this card. This is the main content for the card. Use New-UDCardHeader to create a body. .PARAMETER Expand Th expand content for this card. Expand content is show when the user clicks the expansion button. Use New-UDCardExpand to create an expand. .PARAMETER Footer The footer for this card. Footer contents typically contain actions that are relavent to the card. Use New-UDCardFooter to create a footer. .PARAMETER Style Styles to apply to the card. .PARAMETER Elevation The amount of elevation to provide the card. The more elevation, the more it will appear the card is floating off the page. .PARAMETER Title A title for the card. .PARAMETER TitleAlignment The alignment for the title. .PARAMETER Content The content of the card. .PARAMETER Image An image to show in the card. .PARAMETER Sx Theme-based style to apply to the card. .EXAMPLE Shows a card with a title, image and content. New-UDCard -Id 'SimpleCard' -Title "Alon" -Content { "Content" } -Image 'https://avatars2.githubusercontent.com/u/34351424?s=460&v=4' #> [CmdletBinding()] param( [Parameter()] [string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter()] [string]$ClassName, [Parameter(ParameterSetName = "Advanced")] [PSTypeName('UniversalDashboard.MaterialUI.CardHeader')]$Header, [Parameter(ParameterSetName = "Advanced")] [PSTypeName('UniversalDashboard.MaterialUI.CardBody')]$Body, [Parameter(ParameterSetName = "Advanced")] [PSTypeName('UniversalDashboard.MaterialUI.CardExpand')]$Expand, [Parameter(ParameterSetName = "Advanced")] [PSTypeName('UniversalDashboard.MaterialUI.CardFooter')]$Footer, [Parameter(ParameterSetName = "Advanced")] [PSTypeName('UniversalDashboard.MaterialUI.CardMedia')]$Media, [Parameter()] [Hashtable]$Style, [Parameter()] [ValidateSet("0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24")] [int]$Elevation, [Parameter(ParameterSetName = "Simple")] [Parameter(ParameterSetName = "Text")] [String]$Title, [Parameter(ParameterSetName = "Simple")] [Parameter(ParameterSetName = "Text")] [ValidateSet('left', 'center', 'right')] [String]$TitleAlignment = 'left', [Parameter(ParameterSetName = "Simple")] [ScriptBlock]$Content, [Parameter(ParameterSetName = "Simple")] [string]$Image, [Parameter(ParameterSetName = "Text")] [string]$Text, [Parameter()] [Switch]$Raised, [Parameter(ParameterSetName = "Simple")] $Avatar, [Parameter()] $Sx, [Parameter()] [ValidateSet("elevation", 'outlined')] [string]$Variant = 'elevation' ) End { if ($PSCMdlet.ParameterSetName -eq 'Advanced') { # Card Media checks if ($null -ne $Media) { if ($Media.psobject.typenames -notcontains "UniversalDashboard.MaterialUI.CardMedia") { throw "Media must be a UniversalDashboard.MaterialUI.CardMedia object, please use New-UDCardMedia command." } } # Card header checks if ($null -ne $Header) { if ($Header.psobject.typenames -notcontains "UniversalDashboard.MaterialUI.CardHeader") { throw "Header must be a UniversalDashboard.MaterialUI.CardHeader object, please use New-UDCardHeader command." } } # Card Content checks if ($null -ne $Content) { if ($Content.psobject.typenames -notcontains "UniversalDashboard.MaterialUI.CardBody") { throw "Body must be a UniversalDashboard.MaterialUI.CardBody object, please use New-UDCardBody command." } } # Card Expand checks if ($null -ne $Expand) { if ($Expand.psobject.typenames -notcontains "UniversalDashboard.MaterialUI.CardExpand") { throw "Expand must be a UniversalDashboard.MaterialUI.CardExpand object, please use New-UDCardExpand command." } } # Card footer checks if ($null -ne $Footer) { if ($Footer.psobject.typenames -notcontains "UniversalDashboard.MaterialUI.CardFooter") { throw "Footer must be a UniversalDashboard.MaterialUI.CardFooter object, please use New-UDCardFooter command." } } $Parts = @{ header = $Header body = $Body expand = $Expand footer = $Footer } $Content = { $Parts } } else { $Header = New-UDCardHeader -Title $Title -TitleAlignment $TitleAlignment -Avatar $Avatar if ($Image) { $Media = New-UDCardMedia -Height 120 -Image $Image } if ($PSCmdlet.ParameterSetName -eq 'Text') { $Element = New-UDElement -Tag div -Content { $Text -split "`r`n" | ForEach-Object { $_ New-UDElement -Tag "br" } } $Content = { $Element } } $Body = New-UDCardBody -Content $Content $Parts = @{ header = $Header body = $Body expand = $Expand footer = $Footer } $Content = { $Parts } } $Card = @{ type = "mu-card" isPlugin = $true assetId = $MUAssetId id = $Id className = $ClassName showToolBar = $ShowToolBar.IsPresent media = $Media toolbar = $ToolBar header = $Header body = $Body expand = $Expand footer = $Footer style = $Style elevation = $Elevation raised = $Raised.IsPresent sx = $sx variant = $variant.ToLower() } $Card.PSTypeNames.Insert(0, "UniversalDashboard.MaterialUI.Card") | Out-Null $Card } } function New-UDCardHeader { [CmdletBinding()] param( [Parameter()] [string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter()] [string]$Title, [Parameter()] [string]$SubHeader, [Parameter()] [ValidateSet('inherit', 'left', 'justify', 'right', 'center')] [string]$TitleAlignment = 'inherit', [Parameter()] [ValidateSet('inherit', 'left', 'justify', 'right', 'center')] [string]$SubHeaderAlignment = 'inherit', [Parameter()] $Avatar, [Parameter()] $Action ) End { $Header = @{ type = "mu-card-header" isPlugin = $true assetId = $MUAssetId id = $Id title = $Title subheader = $SubHeader subHeaderAlignment = $SubHeaderAlignment titleAlignment = $TitleAlignment.ToLower() avatar = $Avatar action = $Action } $Header.PSTypeNames.Insert(0, "UniversalDashboard.MaterialUI.CardHeader") | Out-Null $Header } } function New-UDCardBody { [CmdletBinding()] param( [Parameter()] [string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter()] [string]$ClassName, [Parameter()] [scriptblock]$Content, [Parameter()] [Hashtable]$Style ) End { $cContent = @{ type = "mu-card-body" isPlugin = $true assetId = $MUAssetId id = $Id className = $ClassName content = New-UDErrorBoundary -Content $Content style = $Style # PSTypeName = "UniversalDashboard.MaterialUI.CardContent" } $cContent.PSTypeNames.Insert(0, "UniversalDashboard.MaterialUI.CardBody") | Out-Null $cContent } } function New-UDCardExpand { [CmdletBinding()] param( [Parameter()] [string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter()] [string]$ClassName, [Parameter()] [scriptblock]$Content, [Parameter()] [Hashtable]$Style ) End { $Expand = @{ type = "mu-card-expand" isPlugin = $true assetId = $MUAssetId id = $Id className = $ClassName content = New-UDErrorBoundary -Content $Content style = $Style isEndpoint = $isEndPoint.IsPresent refreshInterval = $RefreshInterval autoRefresh = $AutoRefresh.IsPresent # PSTypeName = "UniversalDashboard.MaterialUI.CardExpand" } $Expand.PSTypeNames.Insert(0, "UniversalDashboard.MaterialUI.CardExpand") | Out-Null $Expand } } function New-UDCardFooter { [CmdletBinding()] param( [Parameter()] [string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter()] [string]$ClassName, [Parameter()] [scriptblock]$Content, [Parameter()] [Hashtable]$Style ) End { $Footer = @{ type = "mu-card-footer" isPlugin = $true assetId = $MUAssetId id = $Id className = $ClassName content = New-UDErrorBoundary -Content $Content style = $Style isEndpoint = $isEndPoint.IsPresent refreshInterval = $RefreshInterval autoRefresh = $AutoRefresh.IsPresent # PSTypeName = "UniversalDashboard.MaterialUI.CardFooter" } $Footer.PSTypeNames.Insert(0, "UniversalDashboard.MaterialUI.CardFooter") | Out-Null $Footer } } function New-UDCardMedia { [CmdletBinding()] [OutputType([Hashtable])] param( [Parameter()] [string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter()] [ValidateSet("img", "video", "audio")] [string]$Component = "img", [Parameter()] [string]$Alt, [Parameter()] [string]$Height, [Parameter (ParameterSetName = 'image')] [string]$Image, [Parameter()] [string]$Title, [Parameter(ParameterSetName = 'media')] [string]$Source ) End { $CardMedia = @{ type = "mu-card-media" isPlugin = $true assetId = $MUAssetId id = $Id component = $Component alt = $Alt height = $Height image = $Image title = $Title source = $Source # PSTypeName = "UniversalDashboard.MaterialUI.CardMedia" } $CardMedia.PSTypeNames.Insert(0, "UniversalDashboard.MaterialUI.CardMedia") | Out-Null $CardMedia } } function New-UDCheckBox { <# .SYNOPSIS Creates a checkbox. .DESCRIPTION Creates a checkbox. Checkboxes can be used in forms or by themselves. .PARAMETER Label The label to show next to the checkbox. .PARAMETER Icon The icon to show instead of the default icon. Use New-UDIcon to create an icon. .PARAMETER CheckedIcon The icon to show instead of the default checked icon. Use New-UDIcon to create an icon. .PARAMETER OnChange Called when the value of the checkbox changes. The $EventData variable will have the current value of the checkbox. .PARAMETER Style A hashtable of styles to apply to the checkbox. .PARAMETER Disabled Whether the checkbox is disabled. .PARAMETER Checked Whether the checkbox is checked. .PARAMETER ClassName A CSS class to assign to the checkbox. .PARAMETER LabelPlacement Where to place the label. Valid values are: "top","start","bottom","end" .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Color The theme color to apply to this component .PARAMETER Size The size of the checkbox. Valid values are: "small", "medium" .EXAMPLE Creates a checkbox with a custom icon and style. $Icon = New-UDIcon -Icon angry -Size lg -Id 'demo-checkbox-icon' -Regular $CheckedIcon = New-UDIcon -Icon angry -Size lg -Id 'demo-checkbox-icon-checked' New-UDCheckBox -Id 'btnCustomIcon' -Icon $Icon -CheckedIcon $CheckedIcon -OnChange {} -Style @{color = '#2196f3'} #> param ( [Parameter (Position = 0)] [string]$Label, [Parameter (Position = 1)] $Icon, [Parameter (Position = 2)] $CheckedIcon, [Parameter (Position = 3)] [Endpoint]$OnChange, [Parameter (Position = 4)] [Hashtable]$Style, [Parameter (Position = 5)] [switch]$Disabled, [Parameter (Position = 6)] [bool]$Checked, [Parameter (Position = 7)] [string]$ClassName, [Parameter (Position = 7)] [ValidateSet("top", "start", "bottom", "end")] [string]$LabelPlacement, [Parameter(Position = 8)] [string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter (Position = 9)] [ValidateSet("small", "medium")] [string]$Size = 'medium', [Parameter ()] [ValidateSet('default', 'primary', 'secondary')] [string]$Color = 'default' ) End { if ($OnChange) { $OnChange.Register($Id + "onChange", $PSCmdlet) } @{ # Mandatory properties to load as plugin. type = 'mu-checkbox' isPlugin = $true assetId = $MUAssetId # Command properties. id = $Id className = $ClassName checked = $Checked onChange = $OnChange icon = $Icon checkedIcon = $CheckedIcon disabled = $Disabled.IsPresent style = $Style label = $Label labelPlacement = $LabelPlacement color = $Color.ToLower() size = $Size.ToLower() } } } function New-UDChip { <# .SYNOPSIS Creates a new chip. .DESCRIPTION Creates a new chip. Chips can be used to display tags or little bits of data. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Label The label for the chip. .PARAMETER OnDelete A script block to call when the chip is deleted. .PARAMETER OnClick A script block to call when the chip is clicked. .PARAMETER Icon An icon to show within the chip. .PARAMETER Style CSS styles to apply to the chip. .PARAMETER Variant The theme variant to apply to the chip. .PARAMETER Avatar An avatar to show within the chip. .PARAMETER AvatarType The type of avatar to show in the chip. .PARAMETER ClassName A CSS class to apply to the chip. .PARAMETER Color The color of the chip. Defaults to 'default'. Valid values: "default", "primary", "secondary" .PARAMETER Size The size of the chip. Valid values are: "small", "medium" .EXAMPLE Creates a clickable chip with a custom style and icon. $Icon = New-UDIcon -Icon 'user' -Size sm -Style @{color = '#fff'} New-UDChip -Label "Demo User" -Id "chipIcon" -Icon $Icon -OnClick {Show-UDToast -Message 'test'} -Clickable -Style @{backgroundColor = '#00838f'} #> [CmdletBinding(DefaultParameterSetName = 'Icon')] param( [Parameter()] [string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter(Position = 0)] [string]$Label, [Parameter(Position = 8)] [Endpoint]$OnDelete, [Parameter(Position = 7)] [Endpoint]$OnClick, [Parameter (Position = 1, ParameterSetName = "Icon")] $Icon, [Parameter(Position = 2)] [Hashtable]$Style, [Parameter(Position = 3)] [ValidateSet("outlined", "default")] [string]$Variant = "default", [Parameter(Position = 4, ParameterSetName = "Avatar")] [string]$Avatar, [Parameter(Position = 5, ParameterSetName = "Avatar" )] [ValidateSet("letter", "image")] [string]$AvatarType, [Parameter (Position = 9)] [ValidateSet("small", "medium")] [string]$Size = 'medium', [Parameter()] [string]$ClassName, [Parameter()] [ValidateSet("default", "primary", "secondary", "error", "info", "success", "warning")] [string]$Color = 'default' ) End { if ($OnClick) { $OnClick.Register($Id + "OnClick", $PSCmdlet) } if ($OnDelete) { $OnDelete.Register($Id + "OnDelete", $PSCmdlet) } @{ #This needs to match what is in the register function call of chips.jsx type = "mu-chip" #Eventually everything will be a plugin so we wont need this. isPlugin = $true #This was set in the UniversalDashboard.MaterialUI.psm1 file assetId = $MUAssetId id = $Id label = $Label icon = $Icon style = $Style variant = $Variant onClick = $OnClick onDelete = $OnDelete avatar = $Avatar avatarType = $AvatarType className = $ClassName color = $Color.ToLower() size = $Size.ToLower() } } } function New-UDCodeEditor { <# .SYNOPSIS Creates a new Monaco code editor control. .DESCRIPTION Creates a new Monaco code editor control. .PARAMETER Id The ID of this editor .PARAMETER Language The language to use for syntax highlighting. .PARAMETER Height The height of the editor. .PARAMETER Width The width of the editor. .PARAMETER HideCodeLens Hides code lens within the editor. .PARAMETER DisableCodeFolding Disables code folding. .PARAMETER FormatOnPaste Formats on paste. .PARAMETER GlyphMargin Seconds the size of the glyph margin .PARAMETER DisableLineNumbers Disables line numbers .PARAMETER DisableLinks Disables automatically highlighting links. .PARAMETER DisableBracketMatching Disables bracket matching. .PARAMETER MouseWheelScrollSensitivity Sets the mouse wheel scroll sensitivity. .PARAMETER MouseWheelZoom Enables Ctrl+Scroll zooming. .PARAMETER ReadOnly Sets the editor to readonly. .PARAMETER RenderControlCharacters Enables rendering of control characters. .PARAMETER ShowFoldingControls Controls how to show the folding controls. .PARAMETER SmoothScrolling Enables smooth scrolling. .PARAMETER Theme Selects the theme. The default is the 'vs' theme. .PARAMETER Code The code to show in the editor. .PARAMETER LightTheme The light theme for the editor. .PARAMETER DarkTheme The dark theme for the editor. .EXAMPLE New-UDCodeEditor -Code 'Get-Process' -Theme 'vs-dark' -Language 'powershell' -Readonly Creates a readonly code editor with PowerShell script. #> [CmdletBinding(DefaultParameterSetName = "Standard")] param( [Parameter()] [string]$Id = ([Guid]::NewGuid()), [Parameter()] [ValidateSet('apex', 'azcli', 'bat', 'clojure', 'coffee', 'cpp', 'csharp', 'csp', 'css', 'dockerfile', 'fsharp', 'go', 'handlebars', 'html', 'ini', 'java', 'javascript', 'json', 'less', 'lua', 'markdown', 'msdax', 'mysql', 'objective', 'perl', 'pgsql', 'php', 'postiats', 'powerquery', 'powershell', 'pug', 'python', 'r', 'razor', 'redis', 'redshift', 'ruby', 'rust', 'sb', 'scheme', 'scss', 'shell', 'solidity', 'sql', 'st', 'swift', 'typescript', 'vb', 'xml', 'yaml')] [string]$Language, [Parameter()] [string]$Height = '500', [Parameter()] [string]$Width = '100%', [Parameter(ParameterSetName = 'Standard')] [Switch]$HideCodeLens, [Parameter(ParameterSetName = 'Standard')] [Switch]$DisableCodeFolding, [Parameter(ParameterSetName = 'Standard')] [Switch]$FormatOnPaste, [Parameter(ParameterSetName = 'Standard')] [Switch]$GlyphMargin, [Parameter(ParameterSetName = 'Standard')] [Switch]$DisableLineNumbers, [Parameter(ParameterSetName = 'Standard')] [Switch]$DisableLinks, [Parameter(ParameterSetName = 'Standard')] [Switch]$DisableBracketMatching, [Parameter(ParameterSetName = 'Standard')] [int]$MouseWheelScrollSensitivity = 1, [Parameter(ParameterSetName = 'Standard')] [Switch]$MouseWheelZoom, [Parameter(ParameterSetName = 'Standard')] [Switch]$ReadOnly, [Parameter(ParameterSetName = 'Standard')] [Switch]$RenderControlCharacters, [Parameter(ParameterSetName = 'Standard')] [ValidateSet("always", "mouseover")] [string]$ShowFoldingControls = "mouseover", [Parameter(ParameterSetName = 'Standard')] [Switch]$SmoothScrolling, [Parameter(ParameterSetName = 'Standard')] [ValidateSet("vs", "vs-dark", "hc-black")] [Alias("Theme")] [string]$LightTheme = 'vs', [Parameter(ParameterSetName = 'Standard')] [ValidateSet("vs", "vs-dark", "hc-black")] [string]$DarkTheme = 'vs-dark', [Parameter()] [string]$Code, [Parameter()] [string]$Original, [Parameter(ParameterSetName = 'Standard')] [Switch]$Autosize, [Parameter(ParameterSetName = 'Options')] [Hashtable]$Options = @{}, [Parameter()] [Switch]$CanSave, [Parameter()] [String]$Extension = 'txt' ) End { # if ($Endpoint -is [scriptblock]) { # $Endpoint = New-UDEndpoint -Endpoint $Endpoint -Id $Id # } # elseif ($Endpoint -isnot [UniversalDashboard.Models.Endpoint]) { # throw "Endpoint must be a script block or UDEndpoint" # } if ($PSCmdlet.ParameterSetName -eq 'Options') { $Options["assetId"] = $AssetId $Options["isPlugin"] = $true $Options["type"] = "ud-monaco" $Options["id"] = $Id $Options["height"] = $Height $Options["width"] = $Width $Options["language"] = $Language $Options["code"] = $code $Options["original"] = $original return $Options } @{ assetId = $AssetId isPlugin = $true type = "ud-monaco" id = $Id height = $Height width = $Width language = $Language codeLens = -not $HideCodeLens.IsPresent folding = -not $DisableCodeFolding.IsPresent formatOnPaste = $FormatOnPaste.IsPresent glyphMargin = $GlyphMargin.IsPresent lineNumbers = if ($DisableLineNumbers.IsPresent) { "off" } else { "on" } links = -not $DisableLinks.IsPresent matchBrackets = -not $DisableBracketMatching.IsPresent mouseWheelScrollSensitivity = $MouseWheelScrollSensitivity mouseWheelZoom = $MouseWheelZoom.IsPresent readOnly = $ReadOnly.IsPresent renderControlCharacters = $RenderControlCharacters.IsPresent showFoldingControls = $ShowFoldingControls smoothScrolling = $SmoothScrolling.IsPresent lightTheme = $LightTheme darkTheme = $DarkTheme code = $Code original = $Original autosize = $Autosize.IsPresent canSave = $CanSave.IsPresent extension = $Extension } } } function New-UDContainer { <# .SYNOPSIS Creates a Material UI container. .DESCRIPTION Creates a Material UI container. Containers pad the left and right side of the contained content to center it on larger resolution screens. .PARAMETER Id The ID of this component. .PARAMETER Children The child items to include within the container. .PARAMETER ClassName A CSS class to apply to the container. .EXAMPLE Creates a container with some text. New-UDContainer -Content { New-UDTypography -Text 'Nice' } #> param( [Parameter()] [string]$Id = ([Guid]::NewGuid()).ToString(), [Alias("Content")] [Parameter(Mandatory, Position = 0)] [ScriptBlock]$Children, [Parameter()] [string]$ClassName ) Process { try { $c = New-UDErrorBoundary -Content $Children } catch { $c = New-UDError -Message $_ } @{ isPlugin = $true id = $id assetId = $MUAssetId type = "mu-container" children = $c className = $ClassName } } } function New-UDDashboard { <# .SYNOPSIS Creates a new dashboard. .DESCRIPTION Creates a new dashboard. This component is the root element for all dashboards. You can define content, pages, themes and more. .PARAMETER Title The title of the dashboard. .PARAMETER Content The content for this dashboard. When using content, it creates a dashboard with a single page. .PARAMETER Pages Pages for this dashboard. Use New-UDPage to define a page and pass an array of pages to this parameter. .PARAMETER Theme The theme for this dashboard. You can define a theme with New-UDTheme. .PARAMETER Scripts JavaScript files to run when this dashboard is loaded. These JavaScript files can be absolute and hosted in a third-party CDN or you can host them yourself with New-PSUPublishedFolder. .PARAMETER Stylesheets CSS files to run when this dashboard is loaded. These CSS files can be absolute and hosted in a third-party CDN or you can host them yourself with New-PSUPublishedFolder. .PARAMETER Logo A logo to display in the navigation bar. You can use New-PSUPublishedFolder to host this logo file. .PARAMETER DefaultTheme The default theme to show when the page is loaded. The default is to use the light theme. .PARAMETER DisableThemeToggle Disables the toggle for the theme. .PARAMETER HeaderPosition Position of the header within the dashboard. .PARAMETER HeaderBackgroundColor The background color of the header. This will override the theme colors. .PARAMETER HeaderColor The color of the header. This will override the theme colors. .PARAMETER HideNavigation Obsolete. This parameter was intended for testing purposes. .PARAMETER HideUserName Obsolete. This parameter was intended for testing purposes. .EXAMPLE Creates a new dashboard with a single page. New-UDDashboard -Title 'My Dashboard' -Content { New-UDTypography -Text 'Hello, world!' } .EXAMPLE Creates a new dashboard with multiple pages. $Pages = @( New-UDPage -Name 'HomePage' -Content { New-UDTypography -Text 'Home Page' } New-UDPage -Name 'Page2' -Content { New-UDTypography -Text 'Page2' } ) New-UDDashboard -Title 'My Dashboard' -Pages $Pages #> param( [Parameter()] [string]$Title = "PowerShell Universal Dashboard", [Parameter(ParameterSetName = "Content", Mandatory)] [Endpoint]$Content, [Parameter(ParameterSetName = "Pages", Mandatory)] [PowerShellUniversal.DashboardPage[]]$Pages = @(), [Parameter()] [Hashtable]$Theme = (Get-UDTheme -Name $UDDefaultTheme), [Parameter()] [string[]]$Scripts = @(), [Parameter()] [string[]]$Stylesheets = @(), [Parameter()] [string]$Logo, [Parameter()] [ValidateSet("Light", "Dark")] [string]$DefaultTheme = "Light", [Parameter()] [switch]$DisableThemeToggle, [ValidateSet('absolute', 'fixed', 'relative', 'static', 'sticky')] [Parameter()] [string]$HeaderPosition = 'static', [Parameter()] [UniversalDashboard.Models.DashboardColor]$HeaderColor, [Parameter()] [UniversalDashboard.Models.DashboardColor]$HeaderBackgroundColor, [Parameter()] [ValidateSet("Temporary", "Permanent")] [string]$NavigationLayout = 'Temporary', [Parameter()] [Hashtable[]]$Navigation, [Parameter()] [Switch]$HideUserName, [Parameter()] [Switch]$HideNavigation, [Parameter()] [Endpoint]$LoadNavigation, [Parameter()] [Endpoint]$HeaderContent, [Parameter()] [Endpoint]$PageNotFound, [Parameter()] [Endpoint]$NotAuthorized, [Parameter()] [scriptblock]$SessionTimeoutModal, [Parameter()] [Endpoint]$Menu ) if ($HeaderContent) { $HeaderContent.Register("DashboardHeaderContent", $PSCmdlet); } if ($LoadNavigation) { $LoadNavigation.Register("DashboardLoadNavigation", $PSCmdlet); } if ($PageNotFound) { $PageNotFound.Register('PageNotFound', $Role, $PSCmdlet) } if ($NotAuthorized) { $NotAuthorized.Register('NotAuthorized', $Role, $PSCmdlet) } if ($Menu) { $Menu.Register('DashboardMenu', $Role, $PSCmdlet) } if ($PSCmdlet.ParameterSetName -eq 'Content') { $Parameters = @{ Name = $Title Url = "Home" Content = $Content Logo = $Logo HeaderPosition = $HeaderPosition HeaderColor = $HeaderColor HeaderBackgroundColor = $HeaderBackgroundColor NavigationLayout = $NavigationLayout.ToLower() HideUserName = $HideUserName.IsPresent HideNavigation = $HideNavigation } if ($HeaderContent) { $Parameters['HeaderContent'] = $HeaderContent } if ($Navigation) { $Parameters['Navigation'] = $Navigation } $Pages += New-UDPage @Parameters } else { if ($HideNavigation) { $Pages.ForEach({ $_.hideNavigation = $true }) } if ($Navigation) { $Pages.Where({ -not $_.Navigation }).ForEach({ $_.navigation = $Navigation }) } if ($NavigationLayout) { $Pages.Where({ -not $_.navLayout }).ForEach({ $_.navLayout = $NavigationLayout.ToLower() }) } if ($HeaderContent) { $Pages.Where({ -not $_.HeaderContent }).ForEach({ $_.headerContent = $HeaderContent }) } if ($HeaderPosition) { $Pages.Where({ -not $_.HeaderPosition }).ForEach({ $_.headerPosition = $HeaderPosition }) } if ($HeaderBackgroundColor) { $Pages.Where({ -not $_.HeaderBackgroundColor }).ForEach({ $_.headerBackgroundColor = $HeaderBackgroundColor }) } if ($HeaderColor) { $Pages.Where({ -not $_.HeaderColor }).ForEach({ $_.headerColor = $HeaderColor }) } if ($Logo) { $Pages.Where({ -not $_.Logo }).ForEach({ $_.logo = $Logo }) } } $Cache:Pages = $Pages @{ title = $Title pages = $Pages theme = $Theme | ConvertTo-Json -Depth 10 scripts = $Scripts stylesheets = $Stylesheets defaultTheme = $DefaultTheme.ToLower() disableThemeToggle = $DisableThemeToggle.IsPresent navigation = $Navigation navigationLayout = $NavigationLayout headerContent = $HeaderContent loadNavigation = $LoadNavigation pageNotFound = $PageNotFound notAuthorized = $NotAuthorized translations = $Translations hideUserName = $HideUserName.IsPresent sessionTimeout = if ($SessionTimeoutModal) { & $SessionTimeoutModal } else { $null } menu = $Menu } } function New-UDDataGrid { <# .SYNOPSIS Displays data in a table-style grid. .DESCRIPTION Displays data in a table-style grid. Provides support for sorting, paging, and filtering of large data sets. .PARAMETER Id The ID of this data grid. .PARAMETER Columns An array of column to display in this table. .PARAMETER LoadRows The script block that loads the data for this grid. .PARAMETER Height The static height for this data grid. .PARAMETER AutoHeight Whether to calculate the height of this data grid. .PARAMETER AutoPageSize Automatically determines the page size. .PARAMETER CheckboxSelection Checkbox selection for rows. .PARAMETER CheckboxSelectionVisibleOnly Parameter description .PARAMETER ColumnBuffer Parameter description .PARAMETER ColumnThreshold .PARAMETER Density The visible density of the table. .PARAMETER PageSize The default page size. .PARAMETER RowsPerPageOptions An array of page sizes. .PARAMETER ShowPagination Whether to show Pagination. .PARAMETER Language The language to use for text in the data grid. .PARAMETER LoadDetailContent A script block that is called when rows are expanded. $EventData will contain the row's data. .PARAMETER DetailHeight The static height of the detail pane. .PARAMETER OnEdit A script block that is called when the row is edited. $EventData will include the edited data. Return an object to update the data grid row. .PARAMETER OnExport A script block that is called when data is exported. .PARAMETER ShowQuickFilter Shows a quick filter (search) box. .EXAMPLE PS > New-UDDataGrid -LoadRows { PS > $Data = @( PS > @{ Name = 'Adam'; Number = Get-Random} PS > @{ Name = 'Tom'; Number = Get-Random} PS > @{ Name = 'Sarah'; Number = Get-Random} PS > ) PS > @{ PS > rows = $Data PS > rowCount = $Data.Length PS > } PS > } -Columns @( PS > New-UDDataGridColumn -Field 'Name' PS > New-UDDataGridColumn -Field 'Number' PS > ) -Id 'dataGrid1' Basic data grid|Creates a basic data grid with columns. .EXAMPLE PS > New-UDDataGrid -LoadRows { PS > $Data = 1..1000 | ForEach-Object { PS > @{ Name = "User$($_)"; Number = Get-Random } PS > } PS > Out-UDDataGridData -Data $Data -Total $Data.Length -Context $EventData PS > } -Columns @( PS > New-UDDataGridColumn -Field 'Name' PS > New-UDDataGridColumn -Field 'Number' PS > ) -Pagination -Id 'dataGrid2' Out-UDDataGridData|Adds support for filtering, sorting, and paging. .EXAMPLE PS > New-UDDataGrid -LoadRows { PS > $Rows = 1..100 | % { PS > @{ Name = 'Adam'; Number = Get-Random} PS > } PS > @{ PS > rows = $Rows PS > rowCount = $Rows.Length PS > } PS > PS > } -Columns @( PS > New-UDDataGridColumn -Field 'Name' -Render { PS > New-UDAlert -Text $EventData.Name PS > } PS > New-UDDataGridColumn -Field 'Number' PS > ) -Pagination -Id 'dataGrid3' Render|Adds support for custom rendering of columns. .EXAMPLE PS > New-UDDataGrid -LoadRows { PS > $Data = @( PS > @{ Name = 'Adam'; Number = Get-Random } PS > @{ Name = 'Tom'; Number = Get-Random } PS > @{ Name = 'Sarah'; Number = Get-Random } PS > ) PS > @{ PS > rows = $Data PS > rowCount = $Data.Length PS > } PS > } -Columns @( PS > New-UDDataGridColumn -Field 'Name' PS > New-UDDataGridColumn -Field 'Number' PS > ) -LoadDetailContent { PS > New-UDAlert -Text $EventData.row.Name PS > } -Id 'dataGrid4' Detailed Content|Adds support for detailed content. .EXAMPLE PS > New-UDDataGrid -LoadRows { PS > $Data = @( PS > @{ Name = 'Adam'; number = Get-Random } PS > @{ Name = 'Tom'; number = Get-Random } PS > @{ Name = 'Sarah'; number = Get-Random } PS > ) PS > @{ PS > rows = $Data PS > rowCount = $Data.Length PS > } PS > } -Columns @( PS > @{ field = "Name"; editable = $true } PS > @{ field = "number" ; editable = $true } PS > ) -OnEdit { PS > Show-UDToast "Editing $Body" PS > } -Id 'dataGrid5' Editing|Adds support for editing rows. .EXAMPLE PS > New-UDDataGrid -LoadRows { PS > $Data = @( PS > @{ Name = 'Adam'; number = Get-Random } PS > @{ Name = 'Tom'; number = Get-Random } PS > @{ Name = 'Sarah'; number = Get-Random } PS > ) PS > @{ PS > rows = $Data PS > rowCount = $Data.Length PS > } PS > } -Columns @( PS > New-UDDataGridColumn -Field 'Name' -HeaderName 'A Name' -Flex 1 -HeaderAlign 'center' -Align 'center' -DisableColumnMenu PS > New-UDDataGridColumn -Field 'Number' -HeaderName 'A Number' -Flex 1 -HeaderAlign 'right' -Align 'right' -DisableColumnMenu PS > ) -Id 'dataGrid6' Column Options| #> #[Component("Data Grid", "Table", "Creates a new card.")] param( [Parameter()] [string]$Id = [Guid]::NewGuid(), [Parameter()] [Hashtable[]]$Columns, [Parameter()] [Endpoint]$LoadRows, [Parameter()] [string]$Height, [Parameter()] [Switch]$AutoHeight = $true, [Parameter()] [Switch]$AutoPageSize, [Parameter()] [Switch]$CheckboxSelection, [Parameter()] [Switch]$CheckboxSelectionVisibleOnly, [Parameter()] [int]$ColumnBuffer = 3, [Parameter()] [int]$ColumnThreshold = 3, [Parameter()] [ValidateSet("compact", "standard", "comfortable")] [string]$Density = "standard", [Parameter()] [int]$PageSize = 5, [Parameter()] [int[]]$RowsPerPageOptions = @(5, 10, 25), [Parameter()] [Alias("Pagination")] [Switch]$ShowPagination, [Parameter()] [Endpoint]$OnSelectionChange, [Parameter()] [ValidateSet("ar-SD", "bg-BG", "cs-CZ", "da-DK", "nl-NL", "en-US", "fi-FI", "fr-FR", "de-DE", "el-GR", "he-IL", "hu-HU", "it-IT", "ja-JP", "ko-KR", "nb-NO", "fa-IR", "pl-PL", "pt-BR", "ro-RO", "ru-RU", "sk-SK", "es-ES", "sv-SE", "tr-TR", "uk-UA", "zh-CN")] [string]$Language = "en-US", [Parameter()] [Endpoint]$LoadDetailContent, [Parameter()] [string]$DetailHeight = "auto", [Parameter()] [Endpoint]$OnEdit, [Parameter()] [Endpoint]$OnExport, [Parameter()] [Switch]$ShowQuickFilter, [Parameter()] [string]$DefaultSortColumn, [Parameter()] [ValidateSet("asc", "desc")] [string]$DefaultSortDirection = "asc", [Parameter()] [Switch]$DisableRowSelectionOnClick, [Parameter()] [Switch]$HideExport, [Parameter()] [int]$RowHeight = -1, [Parameter()] [string]$IdentityColumn ) if ($LoadRows) { $RenderedColumns = $Columns.Where( { $_.ContainsKey("render") }) $LoadRows.PostProcess = { $Data = $Args[0] if ($Data.Rows.Count -ge 1) { foreach ($Item in $Data.Rows) { Set-Variable -Name 'EventData' -Value $Item Set-Variable -Name 'Row' -Value $Row foreach ($Column in $RenderedColumns) { $Render = $Column['render'].GetNewClosure() $RenderedData = $Render.Invoke() if (-not $RenderedData) { $RenderedData = "" } if ($Item -isnot [hashtable]) { Add-Member -InputObject $Item -MemberType NoteProperty -Name "rendered$($Column.field)" -Value $RenderedData -Force } else { $Item["rendered$($Column.field)"] = $RenderedData } } } } $Data } $RenderedColumns | ForEach-Object { $LoadRows.PostProcessVariables.AddRange(([Endpoint]::GetVariablesInAst($_['render'].Ast))) } $LoadRows.Register($Id, $PSCmdlet, @{ RenderedColumns = $RenderedColumns }) } if ($Columns) { $Columns = $Columns | ForEach-Object { if ($_.Field) { $_.Field = [char]::ToLower($_.Field[0]) + $_.Field.Substring(1) } $_ } } if ($OnEdit) { $OnEdit.Register($Id + "Edit", $PSCmdlet) } if ($OnExport) { $OnExport.Register($Id + "Export", $PSCmdlet) } if ($LoadDetailContent) { $LoadDetailContent.Register($Id + "MasterDetail", $PSCmdlet) } if ($OnSelectionChange) { $OnSelectionChange.Register($Id + "Selection", $PSCmdlet) } @{ type = "mu-datagrid" id = $Id columns = $Columns loadRows = $LoadRows autoHeight = $AutoHeight autoPageSize = $AutoPageSize.IsPresent checkboxSelection = $CheckboxSelection.IsPresent checkboxSelectionVisibleOnly = $CheckboxSelectionVisibleOnly.IsPresent columnBuffer = $ColumnBuffer columnThreshold = $ColumnThreshold density = $Density.ToLower() pageSize = $PageSize pageSizeOptions = $RowsPerPageOptions pagination = $ShowPagination.IsPresent language = $Language.ToLower() loadDetailContent = $LoadDetailContent detailHeight = $DetailHeight onEdit = $OnEdit onExport = $OnExport showQuickFilter = $ShowQuickFilter.IsPresent onSelectionChange = $OnSelectionChange defaultSortColumn = $DefaultSortColumn defaultSortDirection = $DefaultSortDirection height = $Height disableRowSelectionOnClick = $DisableRowSelectionOnClick.IsPresent hideExport = $HideExport.IsPresent rowHeight = $RowHeight identityColumn = if ($IdentityColumn) { [char]::ToLower($IdentityColumn[0]) + $IdentityColumn.Substring(1) } else { $null } } } function New-UDDataGridColumn { <# .SYNOPSIS Creates a new data grid column. .DESCRIPTION Creates a new data grid column. .PARAMETER Align The alignment of the cell data. Possible values are 'left', 'center' and 'right'. .PARAMETER CellClassName CSS class name to be applied on cell element. .PARAMETER ColumnSpan The number of columns that the column should span. .PARAMETER Description The description of the column that appears when hovering the header cell. .PARAMETER DisableColumnMenu If true, the column menu is disabled. .PARAMETER DisableExport If true, the column is not exported. .PARAMETER DisableReorder If true, the column cannot be reordered. .PARAMETER Editable If true, the column is editable. .PARAMETER Field The field of the row data that the column represents. .PARAMETER Filterable If true, the column is filterable. .PARAMETER Flex The flex value used to set the column width. .PARAMETER Groupable If true, the column is groupable. .PARAMETER HeaderAlign The alignment of the column header cell. Possible values are 'left', 'center' and 'right'. .PARAMETER HeaderName The name of the column header. .PARAMETER Hideable If true, the column is hideable. .PARAMETER HideSortIcons If true, the sort icons are hidden. .PARAMETER MaxWidth The maximum width of the column. .PARAMETER MinWidth The minimum width of the column. .PARAMETER Pinnable If true, the column is pinnable. .PARAMETER Resizable If true, the column is resizable. .PARAMETER Sortable If true, the column is sortable. .PARAMETER SortingOrder The sorting order of the column. Possible values are 'asc', 'desc' and null. .PARAMETER Type The type of the column. Possible values are 'string' | 'number' | 'date' | 'dateTime' | 'boolean' | 'singleSelect'; .PARAMETER Width The width of the column. .PARAMETER Render A script block that is used to render the column. The script block is passed the row data as $EventData. #> param( [Parameter()] [ValidateSet("left", "center", "right")] [string]$Align = 'left', [Parameter()] [string]$CellClassName, [Parameter()] [int]$ColumnSpan = 1, [Parameter()] [string]$Description, [Parameter()] [switch]$DisableColumnMenu, [Parameter()] [switch]$DisableExport, [Parameter()] [switch]$DisableReorder, [Parameter()] [switch]$Editable, [Parameter()] [Alias("Property")] [string]$Field, [Parameter()] [Switch]$Filterable, [Parameter()] [float]$Flex = 1.0, [Parameter()] [switch]$Groupable, [Parameter()] [ValidateSet("left", "center", "right")] [string]$HeaderAlign = 'left', [Parameter()] [Alias("Title")] [string]$HeaderName, [Parameter()] [switch]$Hideable, [Parameter()] [switch]$HideSortIcons, [Parameter()] [int]$MaxWidth, [Parameter()] [int]$MinWidth, [Parameter()] [switch]$Pinnable, [Parameter()] [switch]$Resizable = $true, [Parameter()] [switch]$Sortable, [Parameter()] [string[]]$SortingOrder, [Parameter()] [string]$Type, [Parameter()] [int]$Width, [Parameter()] [ScriptBlock]$Render ) $Result = [PowerShellUniversal.UDHashtable]::new() $Result.AddString("align", $Align, "left", $true) $Result.AddString("cellClassName", $CellClassName, "", $false) $Result.AddInt("colSpan", $ColumnSpan, 1) $Result.AddString("description", $Description, "", $false) $Result.AddBool("disableColumnMenu", $DisableColumnMenu.IsPresent, $false) $Result.AddBool("disableExport", $DisableExport.IsPresent, $false) $Result.AddBool("disableReorder", $DisableReorder.IsPresent, $false) $Result.AddBool("editable", $Editable.IsPresent, $false) $Result.AddString("field", $Field, $true) $Result.AddBool("filterable", $Filterable.IsPresent, $false) $Result.AddFloat("flex", $Flex, 1.0) $Result.AddBool("groupable", $Groupable.IsPresent, $false) $Result.AddString("headerAlign", $HeaderAlign, "left", $true) $Result.AddString("headerName", $HeaderName, $Field) $Result.AddBool("hideable", $Hideable.IsPresent, $false) $Result.AddBool("hideSortIcons", $HideSortIcons.IsPresent, $false) $Result.AddInt("maxWidth", $MaxWidth, 0) $Result.AddInt("minWidth", $MinWidth, 0) $Result.AddBool("pinnable", $Pinnable.IsPresent, $false) $Result.AddBool("resizable", $Resizable.IsPresent, $true) $Result.AddBool("sortable", $Sortable.IsPresent, $false) $Result.AddStringArray("sortingOrder", $SortingOrder) $Result.AddString("type", $Type, "", $false) $Result.AddInt("width", $Width, 0) $Result.AddScriptBlock("render", $Render) $Result } function Out-UDDataGridData { <# .SYNOPSIS Outputs data for a data grid. .DESCRIPTION Outputs data for a data grid. .PARAMETER Context The context of the data grid. .PARAMETER Data The data to output. .PARAMETER TotalRows The total number of rows in the data set. #> [CmdletBinding()] param( [Parameter(Mandatory)] $Context, [Parameter(Mandatory, ValueFromPipeline)] [object]$Data, [Parameter()] [int]$TotalRows = -1 ) Begin { $Items = [System.Collections.ArrayList]::new() } Process { if ($Data -is [Array]) { $Items = $Data } else { $Items.Add($Data) | Out-Null } } End { $Result = $Items if ($null -ne $Context.Filter.Items -and $Context.Filter.Items.Count -gt 0) { $linkOperator = $Context.Filter.logicOperator $filterTextArray = "" $filterTextArray = @() foreach ($filter in $Context.Filter.Items) { $property = $Filter.field $val = $filter.Value switch ($filter.operator) { "contains" { $filterTextArray += "`$PSItem.$Property -match '$val'" } "equals" { $filterTextArray += "`$_.$property -eq '$val'" } "startsWith" { $filterTextArray += "`$_.$property -like '$val*'" } "endsWith" { $filterTextArray += "`$_.$property -like '*$val'" } "isAnyOf" { $filterTextArray += "`$_.$property -in '$val'" } "notequals" { $filterTextArray += "`$_.$property -ne '$val'" } "notcontains" { $filterTextArray += "`$_.$property -notmatch '$val'" } "isEmpty" { $filterTextArray += "`$_.$property -eq `$null" } "isNotEmpty" { $filterTextArray += "`$_.$property -ne `$null" } } } if ($linkOperator -eq 'and') { [string]$filterTextLine = $filterTextArray -join " -and " } else { [string]$filterTextLine = $filterTextArray -join " -or " } $filterScriptBlock = [Scriptblock]::Create($filterTextLine).GetNewClosure() $Result = $Result | Where-Object -FilterScript $filterScriptBlock } if ($Context.filter.quickfiltervalues -and $Context.filter.quickfiltervalues.length -gt 0) { $Result = $Result | where-object { (((($_ | convertto-csv | out-string -width 50000 ) -split "`n")[1]) ) -match $Context.filter.quickfiltervalues[0] } } if ($null -ne $Result) { $TotalRows = $Result.Count } else { $TotalRows = 0 } $Sort = $Context.Sort[0] $Result = $Result | Sort-Object -Property $Sort.field -Descending:$($Sort.Sort -eq 'desc') $Result = $Result | Select-Object -Skip ($Context.Page * $Context.pageSize) -First $Context.PageSize @{ rows = [Array]$Result rowCount = $TotalRows } } } function Out-UDDataGridExport { <# .SYNOPSIS Exports data from the data grid. .DESCRIPTION Exports data from the data grid. .PARAMETER Data The data to export. .PARAMETER MimeType The mime type to export. .PARAMETER FileName The file name to export. #> param( [Parameter(Mandatory)] [string]$Data, [Parameter()] [string]$MimeType = 'text/plain', [Parameter()] [string]$FileName = 'export.txt' ) @{ data = $Data mimeType = $MimeType fileName = $FileName } } function New-UDDatePicker { <# .SYNOPSIS Creates a new date picker. .DESCRIPTION Creates a new date picker. Date pickers can be used stand alone or within New-UDForm. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Label The label to show next to the date picker. .PARAMETER Variant The theme variant to apply to the date picker. .PARAMETER DisableToolbar Disables the date picker toolbar. .PARAMETER OnChange A script block to call with the selected date. The $EventData variable will be the date selected. .PARAMETER Format The format of the date when it is selected. .PARAMETER Value The current value of the date picker. .PARAMETER Locale Change the language of the date picker. .PARAMETER ClassName A CSS class to apply to the date picker. .EXAMPLE Creates a new date picker with the default date value. New-UDDatePicker -Id 'dateDateDefault' -Value '1-2-2020' #> param( [Parameter()] [string]$Id = [Guid]::NewGuid().ToString(), [Parameter()] [string]$Label, [Parameter()] [ValidateSet('inline', 'dialog', 'static')] [string]$Variant = 'inline', [Parameter()] [Switch]$DisableToolbar, [Parameter()] [Endpoint]$OnChange, [Parameter()] [string]$Format = 'MM/dd/yyyy', [Parameter()] [DateTime]$Value = ([DateTime]::Now), [Parameter()] [ValidateSet("en", "de", 'ru', 'fr', 'nl', 'it')] [string]$Locale = "en", [Parameter()] [string]$ClassName, [Parameter()] [DateTime]$MinimumDate, [Parameter()] [DateTime]$MaximumDate, [Parameter()] [System.TimeZoneInfo]$TimeZone, [Parameter()] [Switch]$Disabled ) if ($Variant -eq 'dialog') { Write-Warning "Variant dialog is deprecated. Inline will be used." } if ($OnChange) { $OnChange.Register($Id, $PSCmdlet) } $TZ = $null if ($TimeZone) { $TZ = $TimeZone.GetUtcOffset((Get-Date)).ToString() $TZ = $TZ.Substring(0, $TZ.Length - 3) if (-not $TZ.StartsWith("-")) { $TZ = "+" + $TZ } } $Arguments = @{ id = $Id type = 'mu-datepicker' asset = $MUAssetId isPlugin = $true onChange = $OnChange variant = $Variant format = $Format value = $Value label = $Label locale = $Locale.ToLower() className = $ClassName timeZone = $TZ disabled = $Disabled.IsPresent } if ($PSBoundParameters.ContainsKey('MinimumDate')) { $Arguments['minDate'] = $MinimumDate } if ($PSBoundParameters.ContainsKey('MaximumDate')) { $Arguments['maxDate'] = $MaximumDate } if ($PSBoundParameters.ContainsKey('Value')) { $Arguments['value'] = $Value } $Arguments } function New-UDDateTime { <# .SYNOPSIS This date and time component is used for formatting dates and times using the user's browser settings. .DESCRIPTION This date and time component is used for formatting dates and times using the user's browser settings. Since Universal Dashboard PowerShell scripts run within the server, the date and time settings of the user's system are not taken into account. This component formats date and time within the client's browser to take into account their locale and time zone. .PARAMETER Id The ID of this component. .PARAMETER InputObject The date and time object to format. .PARAMETER Format The format of the date and time. This component uses Day.JS. You can learn more about formatting options on their documentation: https://day.js.org/docs/en/display/format .PARAMETER LocalizedFormat The localized format for the date and time. Use this format if you would like to take the user's browser locale and time zone settings into account. .PARAMETER Locale The locale to use when formatting the date time. Defaults to not set. .EXAMPLE Formats a date and time using the format 'DD/MM/YYYY' New-UDDateTime -InputObject (Get-Date) -Format 'DD/MM/YYYY' #> [CmdletBinding(DefaultParameterSetName = "LocalizedFormat")] param( [Parameter()] [string]$Id = [Guid]::NewGuid(), [Parameter(Mandatory, Position = 0)] [DateTime]$InputObject, [Parameter(ParameterSetName = "Format")] [string]$Format = "DD/MM/YYYY", [Parameter(ParameterSetName = "LocalizedFormat")] [ValidateSet("LT", "LTS", "L", "LL", "LLL", "LLLL", "l", "ll", "lll", "llll")] [string]$LocalizedFormat = "LLL", [Parameter()] [ValidateSet('af', 'am', 'ar-dz', 'ar-iq', 'ar-kw', 'ar-ly', 'ar-ma', 'ar-sa', 'ar-tn', 'ar', 'az', 'be', 'bg', 'bi', 'bm', 'bn', 'bo', 'br', 'bs', 'ca', 'cs', 'cv', 'cy', 'da', 'de-at', 'de-ch', 'de', 'dv', 'el', 'en-au', 'en-ca', 'en-gb', 'en-ie', 'en-il', 'en-in', 'en-nz', 'en-sg', 'en-tt', 'en', 'eo', 'es-do', 'es', 'et', 'eu', 'fa', 'fi', 'fo', 'fr-ca', 'fr-ch', 'fr', 'fy', 'ga', 'gd', 'gl', 'gom-latn', 'gu', 'he', 'hi', 'hr', 'ht', 'hu', 'hy-am', 'id', 'is', 'it-ch', 'it', 'ja', 'jv', 'ka', 'kk', 'km', 'kn', 'ko', 'ku', 'ky', 'lb', 'lo', 'lt', 'lv', 'me', 'mi', 'mk', 'ml', 'mn', 'mr', 'ms-my', 'ms', 'mt', 'my', 'nb', 'ne', 'nl-be', 'nl', 'nn', 'oc-lnc', 'pa-in', 'pl', 'pt-br', 'pt', 'ro', 'ru', 'rw', 'sd', 'se', 'si', 'sk', 'sl', 'sq', 'sr-cyrl', 'sr', 'ss', 'sv-fi', 'sv', 'sw', 'ta', 'te', 'tet', 'tg', 'th', 'tk', 'tl-ph', 'tlh', 'tr', 'tzl', 'tzm-latn', 'tzm', 'ug-cn', 'uk', 'ur', 'uz-latn', 'uz', 'vi', 'x-pseudo', 'yo', 'zh-cn', 'zh-hk', 'zh-tw', 'zh', 'es-pr', 'es-mx', 'es-us')] [string]$Locale ) $f = $Format if ($PSCmdlet.ParameterSetName -eq 'LocalizedFormat') { $f = $LocalizedFormat } @{ type = 'mu-datetime' id = $Id isPlugin = $true assetId = $MUAssetId inputObject = $InputObject.ToString("O") format = $f locale = $Locale.ToLower() } } function Debug-PSUDashboard { <# .SYNOPSIS Provides a utility function for debugging scripts running PowerShell Universal Dashboard. .DESCRIPTION Provides a utility function for debugging scripts running PowerShell Universal Dashboard. This cmdlet integrates with the VS Code PowerShell Universal extension to automatically connect the debugger to endpoints running in UD. .EXAMPLE Creates an element that invokes the Debug-PSUDashboard cmdlet. New-UDElement -Tag div -Endpoint { Debug-PSUDashboard } #> [CmdletBinding()] param() $DebugPreference = 'continue' $Runspace = ([runspace]::DefaultRunspace).id Show-UDModal -Header { New-UDTypography -Text 'Debug Dashboard' -Variant h4 } -Content { Write-Debug "IN DEBUG MODE: Enter-PSHostProcess -Id $PID then Debug-Runspace -Id $Runspace" New-UDTypography -Text "You can run the following PowerShell commands in any PowerShell host to debug this dashboard." New-UDElement -Tag 'pre' -Content { "Enter-PSHostProcess -Id $PID`r`nDebug-Runspace -Id $Runspace" } } -Footer { New-UDLink -Children { New-UDButton -Text 'Debug with VS Code' } -Url "vscode://ironmansoftware.powershell-universal/debug?PID=$PID&RS=$Runspace" New-UDLink -Children { New-UDButton -Text 'Debug with VS Code Insiders' } -Url "vscode-insiders://ironmansoftware.powershell-universal/debug?PID=$PID&RS=$Runspace" New-UDButton -Text 'Close' -OnClick { Hide-UDModal } } Wait-Debugger } function New-UDDivider { <# .SYNOPSIS A divider is a thin line that groups content in lists and layouts. .DESCRIPTION A divider is a thin line that groups content in lists and layouts. .PARAMETER Id ID of this component. .PARAMETER Absolute Absolutely position the element. .PARAMETER Children The content of the component. .PARAMETER FlexItem If true, a vertical divider will have the correct height when used in flex container. (By default, a vertical divider will have a calculated height of 0px if it is the child of a flex container.) .PARAMETER Light If true, the divider will have a lighter color. .PARAMETER Orientation The component orientation. .PARAMETER Sx Custom styling .PARAMETER TextAlign The text alignment. .PARAMETER Variant The variant to use. #> param( [Parameter()] [string]$Id = [Guid]::NewGuid().ToString(), [Parameter()] [Switch]$Absolute, [Parameter()] [Alias("Content")] [scriptblock]$Children = {}, [Parameter()] [switch]$FlexItem, [Parameter()] [switch]$Light, [Parameter()] [ValidateSet("horizontal", "vertical")] [string]$Orientation = "horizontal", [Parameter()] [Hashtable]$Sx, [Parameter()] [ValidateSet("left", "center", "right")] [string]$TextAlign = "center", [Parameter()] [ValidateSet("fullWidth", "inset", "middle")] [string]$Variant = "fullWidth" ) @{ id = $Id type = 'mu-divider' assetId = $MUAssetId isPlugin = $true absolute = $Absolute.IsPresent children = & $Children flexItem = $FlexItem.IsPresent light = $Light.IsPresent orientation = $Orientation.ToLower() sx = $Sx textAlign = $TextAlign.ToLower() variant = $Variant.ToLower() } } function New-UDDrawer { <# .SYNOPSIS Creates a new drawer. .DESCRIPTION Creates a new drawer. A drawer is a navigational component that is typically used for navigating between pages. It can be used with New-UDAppBar to provide a custom nav bar. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Children Navgiation controls to show within the drawer. Use New-UDList and New-UDListItem to generate links within the drawer. .PARAMETER Variant The type of drawer. Valid values include "persistent", "permanent", "temporary" .PARAMETER Anchor Where to anchor the drawer. Valid values incldue "left", "right", "top", "bottom" .PARAMETER ShowCollapse Show the collapse button .PARAMETER ClassName A CSS class to apply to the drawer. .EXAMPLE Creates a custom navbar using New-UDDrawer $Drawer = New-UDDrawer -Id 'drawer' -Children { New-UDList -Content { New-UDListItem -Id 'lstHome' -Label 'Home' -OnClick { Set-TestData 'Home' } -Content { New-UDListItem -Id 'lstNested' -Label 'Nested' -OnClick { Set-TestData 'Nested' } } } } New-UDElement -Tag 'main' -Content { New-UDAppBar -Children { New-UDTypography -Text 'Hello' -Paragraph } -Position relative -Drawer $Drawer } #> param( [Parameter()] [string]$Id = [Guid]::NewGuid(), [Parameter()] [Alias("Content")] [ScriptBlock]$Children, [ValidateSet("persistent", "permanent", "temporary")] [string]$Variant = "temporary", [ValidateSet("left", "right", "top", "bottom")] [string]$Anchor = "left", [Parameter()] [string]$ClassName, [Parameter()] [Switch]$ShowCollapse ) try { $c = & $Children } catch { $c = New-UDError -Message $_ } @{ type = 'mu-drawer' id = $Id isPlugin = $true assetId = $MUAssetId children = $c variant = $Variant.ToLower() anchor = $Anchor.ToLower() className = $ClassName ShowCollapse = $ShowCollapse.IsPresent } } function New-UDDynamic { <# .SYNOPSIS Defines a new dynamic region in a dashboard. .DESCRIPTION Defines a new dynamic region in a dashboard. Dynamic regions are used for loading data when the page is loaded or for loading data dynamically through user interaction or auto-reloading. .PARAMETER Id The ID of this component. .PARAMETER ArgumentList Arguments to pass to this dynamic endpoint. .PARAMETER Content The content of this dynamic region. .PARAMETER AutoRefresh Whether this dynamic region should refresh on an interval. .PARAMETER AutoRefreshInterval The amount of seconds between refreshes for this dynamic region. .PARAMETER LoadingComponent A component to display while this dynamic region is loading. .EXAMPLE A simple dynamic region that executes when the user loads the page. New-UDDynamic -Content { New-UDTypography -Text (Get-Date) } .EXAMPLE A dynamic region that refreshes every 3 seconds New-UDDynamic -Content { New-UDTypography -Text (Get-Date) } -AutoRefresh -AutoRefreshInterval 3 .EXAMPLE A dynamic region that is updated when a button is clicked. New-UDDynamic -Content { New-UDTypography -Text (Get-Date) } -Id 'dynamic' New-UDButton -Text 'Refresh' -OnClick { Sync-UDElement -Id 'dynamic' } #> param( [Parameter()] [string]$Id = [Guid]::NewGuid(), [Parameter()] [object[]]$ArgumentList, [Parameter(Position = 0, Mandatory)] [Endpoint]$Content, [Parameter()] [Switch]$AutoRefresh, [Parameter()] [int]$AutoRefreshInterval = 10, [Parameter()] [scriptblock]$LoadingComponent ) $Content.ArgumentList = $ArgumentList $Content.Register($Id, $PSCmdlet) @{ id = $Id autoRefresh = $AutoRefresh.IsPresent autoRefreshInterval = $AutoRefreshInterval type = "dynamic" isPlugin = $true loadingComponent = if ($LoadingComponent) { & $LoadingComponent } else { $null } } } function New-UDEditor { param( [Parameter()] [string]$Id = ([Guid]::NewGuid()), [Parameter()] [Hashtable]$Data, [Parameter()] [Endpoint]$OnChange, [Parameter()] [ValidateSet("json", "html")] [string]$Format = "json", [Parameter()] [string]$PublishedFolder ) if ($OnChange) { $OnChange.Register($Id, $PSCmdlet); } @{ assetId = $AssetId isPlugin = $true type = "ud-editor" id = $Id onChange = $OnChange data = $Data format = $Format.ToLower() publishedFolder = $PublishedFolder } } function New-UDError { <# .SYNOPSIS Creates a new error card. .DESCRIPTION Creates a new error card. .PARAMETER Message The message to display. .PARAMETER Title A title for the card. .EXAMPLE Displays the error 'Invalid data' on the page. New-UDError -Message 'Invalid data' #> param( [Parameter(Mandatory)] [string]$Message, [Parameter()] [string]$Title ) @{ type = "error" isPlugin = $true assetId = $AssetId errorRecords = @(@{message= $Message}) title = $Title } } function New-UDErrorBoundary { <# .SYNOPSIS Defines a new error boundary around a section of code. .DESCRIPTION Defines a new error boundary around a section of code. Error boundaries are used to trap errors and display them on the page. .PARAMETER Content The content to trap in an error boundary. .EXAMPLE Defines an error boundary that traps the exception that is thrown and displays it on the page. New-UDErrorBoundary -Content { throw 'This is an error' } #> param( [Parameter(Mandatory)] [ScriptBlock]$Content ) try { & $Content } catch { New-UDError -Message $_ } } function Invoke-UDEvent { param( [Parameter( Mandatory = $true, ValueFromPipeline = $true, Position = 0 )] [String]$Id, [Parameter( Mandatory = $true, Position = 1, ParameterSetName = "onClick" )] [ValidateSet("onClick")] [string]$event ) Begin { } Process { if ($PSCmdlet.ParameterSetName -eq "onClick") { Invoke-UDJavaScript -javaScript " document.getElementById('$Id').click(); " } } End { } } function New-UDExpansionPanelGroup { <# .SYNOPSIS Creates a group of expansion panels. .DESCRIPTION Creates a group of expansion panels. Use New-UDExpansionPanel to create children for a group. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Children Expansion panels to include in this group. .PARAMETER Popout Creates a popout style expansion panel group. .PARAMETER Type The type of expansion panel group. .EXAMPLE Creates an expansion panel group. New-UDExpansionPanelGroup -Items { New-UDExpansionPanel -Title "Hello" -Id 'expTitle' -Content {} New-UDExpansionPanel -Title "Hello" -Id 'expContent' -Content { New-UDElement -Tag 'div' -id 'expContentDiv' -Content { "Hello" } } New-UDExpansionPanel -Title "Hello" -Id 'expEndpoint' -Endpoint { New-UDElement -Tag 'div' -id 'expEndpointDiv' -Content { "Hello" } } } #> param( [Parameter()] [String]$Id = ([Guid]::NewGuid()), [Parameter(Mandatory = $true, Position = 0)] [Alias("Content")] [ScriptBlock]$Children, [Parameter()] [Switch]$Popout, [Parameter()] [ValidateSet("Expandable", "Accordion")] [String]$Type = 'Expandable', [Parameter()] [string]$ClassName ) $c = New-UDErrorBoundary -Content $Children @{ type = 'mu-expansion-panel-group' isPlugin = $true assetId = $AssetId id = $id children = $c popout = $Popout.IsPresent accordion = $Type -eq 'Accordion' className = $ClassName } } function New-UDExpansionPanel { <# .SYNOPSIS Creates an expansion panel. .DESCRIPTION Creates an expansion panel. An expansion panel can hide content that isn't necessary to view when a page is loaded. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Title The title show within the header of the expansion panel. .PARAMETER Icon An icon to show within the header of the expansion panel. .PARAMETER Children Children components to put within the expansion panel. .PARAMETER Active Whether the expansion panel is currently active (open). .EXAMPLE Creates an expansion panel with some content. New-UDExpansionPanel -Title "Hello" -Id 'expContent' -Content { New-UDElement -Tag 'div' -id 'expContentDiv' -Content { "Hello" } } #> [CmdletBinding()] param( [Parameter()] [String]$Id = ([Guid]::NewGuid()), [Parameter()] [String]$Title, [Parameter()] $Icon, [Parameter()] [Alias("Content")] [ScriptBlock]$Children, [Parameter()] [Switch]$Active, [Parameter()] [string]$ClassName ) $iconName = $Icon if ($PSBoundParameters.ContainsKey("Icon")) { if ($Icon -is [string]) { $iconName = [UniversalDashboard.Models.FontAwesomeIconsExtensions]::GetIconName($Icon) } } @{ id = $Id title = $Title children = & $Children active = $Active.IsPresent icon = $iconName className = $ClassName } } function New-UDFloatingActionButton { <# .SYNOPSIS Creates a new floating action button. .DESCRIPTION Creates a new floating action button. Floating action buttons are good for actions that make sense for an entire page. They can be pinned to the bottom of a page. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Icon The icon to put within the floating action button. .PARAMETER Size The size of the button. Valid values are: "small", "medium", "large" .PARAMETER OnClick A script block to execute when the floating action button is clicked. .PARAMETER Color The theme color to apply to the button. .PARAMETER ClassName A CSS class to apply to the floating action button. .EXAMPLE Creates a floating action button with a user icon and shows a toast when clicked. New-UDFloatingActionButton -Icon user -OnClick { Show-UDToast -Message 'Hello' } #> param( [Parameter()] [string]$Id = ([Guid]::NewGuid()), [Parameter()] $Icon, [Parameter()] [ValidateSet("small", "medium", "large")] [string]$Size = "large", [Parameter()] [Endpoint]$OnClick, [Parameter()] [string]$ClassName, [Parameter()] [ValidateSet('default', 'primary', 'secondary')] [string]$Color, [Parameter()] [ValidateSet('Relative', 'BottomLeft', 'BottomRight')] [string]$Position = 'BottomRight' ) if ($OnClick) { $OnClick.Register($Id, $PSCmdlet) } @{ type = "mu-fab" assetId = $AssetId isPlugin = $true id = $id size = $Size.tolower() backgroundColor = $ButtonColor.HtmlColor color = $IconColor.HtmlColor icon = $icon onClick = $OnClick className = $ClassName themeColor = $Color.ToLower() position = $Position.ToLower() } } function New-UDForm { <# .SYNOPSIS Creates a new form. .DESCRIPTION Creates a new form. Forms can contain any set of input controls. Each of the controls will report its value back up to the form when the submit button is clicked. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Children Controls that make up this form. This can be any combination of controls. Input controls will report their state to the form. .PARAMETER OnSubmit A script block that is execute when the form is submitted. You can return controls from this script block and the form will be replaced by the script block. The $EventData variable will contain a hashtable of all the input fields and their values. .PARAMETER OnValidate A script block that validates the form. Return the result of a call to New-UDFormValidationResult. .PARAMETER OnProcessing A script block that is called when the form begins processing. The return value of this script block should be a component that displays a loading dialog. The script block will receive the current form data. .PARAMETER OnCancel A script block that is called when a form is cancelled. Useful for closing forms in modals. .PARAMETER SubmitText Text to show within the submit button .PARAMETER CancelText Text to show within the cancel button. .PARAMETER ButtonVariant Type of button to display. .EXAMPLE Creates a form that contains many input controls and displays the $eventdata hashtable as a toast. New-UDForm -Id 'defaultForm' -Content { New-UDTextbox -Id 'txtNameDefault' -Value 'Name' New-UDTextbox -Id 'txtLastNameDefault' -Value 'LastName' New-UDCheckbox -Id 'chkYesDefault' -Label YesOrNo -Checked $true New-UDSelect -Label '1-3' -Id 'selectDefault' -Option { New-UDSelectOption -Name "OneDefault" -Value 1 New-UDSelectOption -Name "TwoDefault" -Value 2 New-UDSelectOption -Name "ThreeDefault" -Value 3 } -DefaultValue '1' New-UDSwitch -Id 'switchYesDefault' -Checked $true New-UDDatePicker -Id 'dateDateDefault' -Value '1-2-2020' New-UDTimePicker -Id 'timePickerDefault' -Value '10:30 AM' New-UDRadioGroup -Label 'group' -Id 'simpleRadioDefault' -Children { New-UDRadio -Value 'Adam' -Label 'Adam' -Id 'adamDefault' New-UDRadio -Value 'Alon' -Label 'Alon' -Id 'alonDefault' New-UDRadio -Value 'Lee' -Label 'Lee' -Id 'leeDefault' } -Value 'Adam' } -OnSubmit { Show-UDToast -Message $Body } #> param( [Parameter()] [string]$Id = [Guid]::NewGuid().ToString(), [Parameter(Mandatory, ParameterSetName = 'form')] [Alias("Content")] [ScriptBlock]$Children, [Parameter(Mandatory, ParameterSetName = 'form')] [Parameter(Mandatory, ParameterSetName = 'schema')] [Endpoint]$OnSubmit, [Parameter(ParameterSetName = 'form')] [Endpoint]$OnValidate, [Parameter(ParameterSetName = 'form')] [ScriptBlock]$OnProcessing, [Parameter(ParameterSetName = 'form')] [Endpoint]$OnCancel, [Parameter(ParameterSetName = 'form')] [string]$SubmitText = 'Submit', [Parameter(ParameterSetName = 'form')] [string]$CancelText = 'Cancel', [ValidateSet('text', 'contained', 'outlined')] [string]$ButtonVariant = 'text', [Parameter(ParameterSetName = 'form')] [string]$ClassName, [Parameter(Mandatory = $true, ParameterSetName = 'schema')] [Hashtable]$Schema, [Parameter(ParameterSetName = 'schema')] [Hashtable]$UiSchema = @{}, [Parameter()] [switch]$DisableSubmitOnEnter, [Parameter(ParameterSetName = 'script')] [string]$Script, [Parameter(ParameterSetName = 'script')] [ValidateSet("Text", "Table")] [string]$OutputType = "Text" ) if ($null -ne $OnValidate) { $OnValidate.Register($id + "validate", $PSCmdlet) } $LoadingComponent = $null if ($null -ne $OnProcessing) { $LoadingComponent = New-UDErrorBoundary -Content $OnProcessing } if ($OnCancel) { $OnCancel.Register($id + 'cancel', $PSCmdlet) } if ($OnSubmit) { $OnSubmit.Register($id, $PSCmdlet) } try { $c = New-UDErrorBoundary -Content $Children } catch { $c = New-UDError -Message $_ } if ($PSCmdlet.ParameterSetName -eq 'schema') { @{ id = $Id assetId = $MUAssetId isPlugin = $true type = "mu-schema-form" onSubmit = $OnSubmit schema = $Schema uiSchema = $UiSchema } } elseif ($PSCmdlet.ParameterSetName -eq 'script') { $ScriptObj = Get-PSUScript -Name $Script -Integrated $Parameters = Get-PSUScriptParameter -Script $ScriptObj -Integrated New-UDForm -Content { New-UDStack -Spacing 1 -Direction 'column' -Content { $Parameters | ForEach-Object { $Parameter = $_ switch ($_.DisplayType) { "String" { New-UDTextbox -Id $Parameter.Name -Label $Parameter.Name } "Integer" { New-UDTextbox -Id $Parameter.Name -Label $Parameter.Name } "Boolean" { New-UDSwitch -Id $Parameter.Name -Label $Parameter.Name } "DateTime" { New-UDDatePicker -Id $Parameter.Name -Label $Parameter.Name } "Select" { New-UDSelect -Id $Parameter.Name -Label $Parameter.Name -Option { $Parameter.ValidValues | ForEach-Object { New-UDSelectOption -Name $_ -Value $_ } } } default { New-UDTextbox -Id $Parameter.Name -Label $Parameter.Name } } } } } -OnSubmit { $Values = @{} $Parameters | ForEach-Object { $Values[$_.Name] = $EventData.($_.Name) } try { $Result = Invoke-PSUScript -Script $ScriptObj -Integrated -Wait @Values -ErrorAction Stop if ($OutputType -eq 'Table' -and $Result) { New-UDTable -Data $Result -ShowPagination } elseif ($OutputType -eq 'Text' -and $Result) { New-UDSyntaxHighlighter -Code ($Result | Out-String) -Language batch } else { New-UDAlert -Text 'Form submitted successfully!' } } catch { New-UDAlert -Text "Failed to submit form! $_" -Severity error } } } else { @{ id = $Id assetId = $MUAssetId isPlugin = $true type = "mu-form" onSubmit = $OnSubmit onValidate = $OnValidate loadingComponent = $LoadingComponent children = $c onCancel = $OnCancel cancelText = $CancelText submitText = $SubmitText buttonVariant = $ButtonVariant className = $ClassName disableSubmitOnEnter = $DisableSubmitOnEnter.IsPresent } } } New-Alias -Name 'New-UDFormValidationResult' -Value 'New-UDValidationResult' function New-UDValidationResult { <# .SYNOPSIS Creates a new validation result. .DESCRIPTION Creates a new validation result. This cmdlet should return its value from the OnValidate script block parameter on New-UDForm or New-UDStepper. .PARAMETER Valid Whether the status is considered valid. .PARAMETER ValidationError An error to display if the is not valid. .PARAMETER Context Update the context based on validation. This is only used for New-UDStepper. .PARAMETER DisablePrevious Disables the previous button. This is only used for New-UDStepper. .PARAMETER ActiveStep Sets the active step. This is only used for New-UDStepper. #> param( [Parameter()] [Switch]$Valid, [Parameter()] [string]$ValidationError = "Form is invalid.", [Parameter()] [HashTable]$Context, [Parameter()] [Switch]$DisablePrevious, [Parameter()] [int]$ActiveStep = -1 ) @{ valid = $Valid.IsPresent validationError = $ValidationError context = $Context disablePrevious = $DisablePrevious.IsPresent activeStep = $ActiveStep } } function Test-UDForm { <# .SYNOPSIS Invokes validation for a form. .DESCRIPTION Invokes validation for a form. .PARAMETER Id Id of the form to invoke validation for. .EXAMPLE New-UDButton -Text 'Validate' -OnClick { Test-UDForm -Id 'myForm' } #> param( [Parameter(Mandatory)] [string]$Id ) $DashboardHub.SendWebSocketMessage($ConnectionId, "testForm", $Id) } function Invoke-UDForm { <# .SYNOPSIS Invokes a form. .DESCRIPTION Invokes a form and optionally validates it. .PARAMETER Id The ID of the form to invoke. .PARAMETER Validate Whether to run form validation. .EXAMPLE Invoke-UDForm -Id "MyForm" -Validate #> param( [Parameter(Mandatory)] [string]$Id, [Parameter()] [Switch]$Validate ) $Data = @{ method = "invokeForm" id = $Id validate = $Validate.IsPresent } $DashboardHub.SendWebSocketMessage($ConnectionId, "invokeMethod", $Data) } function New-UDGridLayout { param( [Parameter()] [string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter()] [int]$RowHeight = 30, [Parameter(Mandatory)] [scriptblock]$Content, [Parameter()] [string]$Layout, [Parameter()] [int]$LargeColumns = 12, [Parameter()] [int]$MediumColumns = 10, [Parameter()] [int]$SmallColumns = 6, [Parameter()] [int]$ExtraSmallColumns = 4, [Parameter()] [int]$ExtraExtraSmallColumns = 2, [Parameter()] [int]$LargeBreakpoint = 1200, [Parameter()] [int]$MediumBreakpoint = 996, [Parameter()] [int]$SmallBreakpoint = 768, [Parameter()] [int]$ExtraSmallBreakpoint = 480, [Parameter()] [int]$ExtraExtraSmallBreakpoint = 0, [Parameter()] [switch]$Draggable, [Parameter()] [switch]$Resizable, [Parameter()] [switch]$Persist, [Parameter()] [switch]$Design ) End { $Breakpoints = @{ lg = $LargeBreakpoint md = $MediumBreakpoint sm = $SmallBreakpoint xs = $ExtraSmallBreakpoint xxs = $ExtraExtraSmallBreakpoint } $Columns = @{ lg = $LargeColumns md = $MediumColumns sm = $SmallColumns xs = $ExtraSmallColumns xxs = $ExtraExtraSmallColumns } @{ type = "ud-grid-layout" isPlugin = $true id = $Id assetId = $MUAssetId className = "layout" rowHeight = $RowHeight children = & $Content layout = $Layout cols = $Columns breakpoints = $Breakpoints isDraggable = $Draggable.IsPresent isResizable = $Resizable.IsPresent persist = $Persist.IsPresent design = $Design.IsPresent } } } function New-UDGrid { <# .SYNOPSIS Creates a grid to layout components. .DESCRIPTION Creates a grid to layout components. The grid is a 24-point grid system that can adapt based on the size of the screen that is showing the controls. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER ExtraSmallSize The size (1-24) for extra small devices. .PARAMETER SmallSize The size (1-24) for small devices. .PARAMETER MediumSize The size (1-24) for medium devices. .PARAMETER LargeSize The size (1-24) for large devices. .PARAMETER ExtraLargeSize The size (1-24) for extra large devices. .PARAMETER Container Whether this is a container. A container can be best described as a row. .PARAMETER Spacing Spacing between the items. .PARAMETER Item Whether this is an item in a container. .PARAMETER Children Components included in this grid item. .PARAMETER ClassName A CSS class to apply to the grid. .EXAMPLE An example .NOTES General notes #> param( [Parameter()] [string]$Id = [Guid]::NewGuid().ToString(), [Alias("Size")] [ValidateRange(1, 12)] [Parameter(ParameterSetName = "Item")] [int]$ExtraSmallSize, [Parameter(ParameterSetName = "Item")] [ValidateRange(1, 12)] [int]$SmallSize, [Parameter(ParameterSetName = "Item")] [ValidateRange(1, 12)] [int]$MediumSize, [Parameter(ParameterSetName = "Item")] [ValidateRange(1, 12)] [int]$LargeSize, [Parameter(ParameterSetName = "Item")] [ValidateRange(1, 12)] [int]$ExtraLargeSize, [Parameter(ParameterSetName = "Container")] [Switch]$Container, [Parameter(ParameterSetName = "Container")] [ValidateRange(0, 10)] [int]$Spacing, [Parameter(ParameterSetName = "Item")] [Switch]$Item, [Parameter()] [Alias("Content")] [ScriptBlock]$Children, [Parameter()] [string]$ClassName ) End { $c = New-UDErrorBoundary -Content $Children @{ id = $Id isPlugin = $true type = "mu-grid" assetId = $MUAssetId xs = $ExtraSmallSize sm = $SmallSize md = $MediumSize lg = $LargeSize xl = $ExtraLargeSize spacing = $Spacing container = $Container.IsPresent item = $Item.IsPresent children = $c className = $ClassName } } } function New-UDHeading { <# .SYNOPSIS Defines a new heading .DESCRIPTION Defines a new heading. This generates a new H tag. .PARAMETER Id The ID of this component. .PARAMETER Content The content of the heading. .PARAMETER Text The text of the heading. .PARAMETER Size This size of this heading. This can be 1,2,3,4,5 or 6. .PARAMETER Color The text color. .PARAMETER ClassName A CSS class to apply to the heading. .EXAMPLE A heading New-UDHeading -Text 'Heading 1' -Size 1 -Color Blue #> param( [Parameter()] [String]$Id = ([Guid]::NewGuid()), [Parameter(ParameterSetName = "Content")] [ScriptBlock]$Content, [Parameter(ParameterSetName = "Text")] [string]$Text, [Parameter()] [ValidateSet("1", "2", "3", "4", "5", "6")] [string]$Size, [Parameter()] [UniversalDashboard.Models.DashboardColor]$Color = 'black', [Parameter()] [string]$ClassName ) if ($PSCmdlet.ParameterSetName -eq "Text") { $Content = { $Text } } New-UDElement -Id $Id -Tag "h$size" -Content $Content -Attributes @{ className = $className style = @{ color = $Color.HtmlColor } } } function New-UDHidden { param( [Parameter()] [string]$Id = [Guid]::NewGuid(), [Parameter(ParameterSetName = 'Down')] [ValidateSet('xs', 'sm', 'md', 'lg', 'xl')] [string]$Down, [Parameter(ParameterSetName = 'Up')] [ValidateSet('xs', 'sm', 'md', 'lg', 'xl')] [string]$Up, [Parameter(ParameterSetName = 'Only')] [ValidateSet('xs', 'sm', 'md', 'lg', 'xl')] [string[]]$Only, [Parameter()] [ScriptBlock]$Content ) $Component = @{ type = 'mu-hidden' id = $Id isPlugin = $true children = & $Content } if ($PSCmdlet.ParameterSetName -eq 'Only') { $Component['only'] = $Only } if ($PSCmdlet.ParameterSetName -eq 'Down') { $Component["$($Down.ToLower())Down"] = $true } if ($PSCmdlet.ParameterSetName -eq 'Up') { $Component["$($Up.ToLower())Up"] = $true } $Component } function New-UDIconButton { <# .SYNOPSIS Creates a button with an icon. .DESCRIPTION Creates a button with an icon. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Icon The icon to display within the button. .PARAMETER OnClick A script block to execute when the button is clicked. .PARAMETER Disabled Whether the button is disabled. .PARAMETER Href A link to navigate to when the button is clicked. .PARAMETER Style The CSS sytle to apply to the icon. .PARAMETER ClassName A CSS class to apply to the icon. .PARAMETER Size The size of the icon button. Valid values are: "small", "medium", "large" .EXAMPLE Creates an icon button with a user icon with a custom style. New-UDIconButton -Icon (New-UDIcon -Icon user -Size sm -Style @{color = '#000'}) -Id 'iconButtonContent' #> param( [Parameter()] [string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter ()] $Icon, [Parameter ()] [Endpoint] $OnClick, [Parameter ()] [Switch] $Disabled, [Parameter ()] [string] $Href, [Parameter ()] [Hashtable] $Style, [Parameter()] [string]$ClassName, [Parameter()] [ValidateSet('small', 'medium', 'large')] [string]$Size = 'medium' ) End { if ($OnClick) { $OnClick.Register($Id, $PSCmdlet) } @{ type = 'mu-icon-button' isPlugin = $true assetId = $MUAssetId id = $Id disabled = $Disabled.IsPresent style = $Style onClick = $OnClick icon = $Icon href = $Href className = $ClassName size = $size.ToLower() } } } [PowerShellUniversal.IconService]::LoadIcons() function Find-UDIcon { <# .SYNOPSIS Find an icon. .DESCRIPTION Find an icon. .PARAMETER Name The name of the icon to find. Wild cards are supported. .EXAMPLE Find-UDIcon -Name 'User' #> param( [Parameter(Mandatory)] $Name ) $Name = $Name.Replace("-", "").Replace("*", ".*") [PowerShellUniversal.IconService]::Icons.Keys | Where-Object { $_ -match $Name } } function New-UDIcon { <# .SYNOPSIS FontAwesome 6 Pro icons. .DESCRIPTION Creates a new icon. .PARAMETER Id The ID of this component. .PARAMETER Icon The Icon to display. This is a FontAwesome 5 icon name. .PARAMETER FixedWidth Whether to use a fixed with. .PARAMETER Inverse Whether to invert the colors of the icon. .PARAMETER Rotation The amount of degrees to rotate the icon. .PARAMETER ClassName Custom CSS class names to apply to the icon. .PARAMETER Transform A CSS transform to apply to the icon. .PARAMETER Flip Whether to flip the icon. .PARAMETER Pull Whether to flip the icon. .PARAMETER ListItem .PARAMETER Spin Whether the icon should spin. .PARAMETER Border Defines the border for this icon. .PARAMETER Pulse Whether this icon should publse. .PARAMETER Size The size of the icon. Valid values are: "xs", "sm", "lg", "1x", "2x", "3x", "4x", "5x", "6x", "7x", "8x", "9x", "10x" .PARAMETER Style A CSS style to apply to the icon. .PARAMETER Title .PARAMETER Solid Uses the solid icon style. .PARAMETER Color The color of this icon. .EXAMPLE PS > New-UDIcon -Icon User -Id 'icon1' Basic Icon|Displays a user icon. .EXAMPLE PS > New-UDStack -Direction 'row' -Content { PS > New-UDIcon -Icon 'AddressBook' -Size 'sm' -Id 'icon2' PS > New-UDIcon -Icon 'AddressBook' -Size 'lg' -Id 'icon3' PS > New-UDIcon -Icon 'AddressBook' -Size '5x' -Id 'icon4' PS > New-UDIcon -Icon 'AddressBook' -Size '10x' -Id 'icon5' PS > } Icon Size|Displays icons in different sizes. .EXAMPLE PS > New-UDIcon -Icon 'AddressBook' -Size '5x' -Rotation 90 -Id 'icon6' Rotated Icon|Rotates an icon 90 degrees. .EXAMPLE PS > New-UDIcon -Icon 'AddressBook' -Size '5x' -Border -Id 'icon7' Border Icon|Adds a border to an icon. .EXAMPLE PS > New-UDIcon -Icon 'AddressBook' -Size '5x' -Color 'red' -Id 'icon8' Color|Adds a color to an icon .EXAMPLE PS > New-UDIcon -Icon 'AddressBook' -Flip 'horizontal' -Size '5x' -Id 'icon9' Flip|Flips an icon horizontally. .EXAMPLE PS > New-UDIcon -Icon 'Spinner' -Spin -Size '5x' -Id 'icon10' Spin|Spins an icon. .EXAMPLE PS > New-UDIcon -Icon 'Spinner' -Pulse -Size '5x' -Id 'icon11' Pulse|Pulses an icon. #> param( [Parameter()] [string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter()] [string]$Icon, [Parameter()] [Switch]$FixedWidth, [Parameter()] [switch]$Inverse, [Parameter()] [int]$Rotation, [Parameter()] [string]$ClassName, [Parameter()] [string]$Transform, [Parameter()] [ValidateSet("horizontal", 'vertical', 'both')] [string]$Flip, [Parameter()] [ValidateSet('right', 'left')] [string]$Pull, [Parameter()] [switch]$ListItem, [Parameter()] [switch]$Spin, [Parameter()] [switch]$Border, [Parameter()] [Alias('Pulse')] [switch]$Beat, [Parameter()] [switch]$Fade, [Parameter()] [switch]$Bounce, [Parameter()] [switch]$BeatFade, [Parameter()] [switch]$Shake, [Parameter ()] [ValidateSet("xs", "sm", "md", "lg", "1x", "2x", "3x", "4x", "5x", "6x", "7x", "8x", "9x", "10x")] [string]$Size = "sm", [Parameter()] [Hashtable]$Style = @{}, [Parameter()] [string]$Title, [Parameter()] [switch]$Solid, [Parameter()] [UniversalDashboard.Models.DashboardColor] $Color ) End { $iconName = $Icon.ToLower().Replace("_", "") if ([PowerShellUniversal.IconService]::Icons.ContainsKey($iconName)) { $IconObj = [PowerShellUniversal.IconService]::Icons[$iconName] $IconName = "" if ($IconObj.Styles[0] -eq 'brands') { $IconName += "fa-brands" } else { if ($Solid -or $IconObj.Styles -notcontains 'regular') { $IconName += "fa-solid" } else { $IconName += "fa-regular" } } $IconName += " fa-" + $IconObj.Name } else { $IconName = "fa-solid fa-circle-question"; } $MUIcon = @{ type = "icon" id = $id size = $Size fixedWidth = $FixedWidth.IsPresent color = $Color.HtmlColor listItem = $ListItem.IsPresent inverse = $Inverse.IsPresent rotation = $Rotation flip = $Flip spin = $Spin.IsPresent beat = $Beat.IsPresent shake = $Shake.IsPresent fade = $Fade.IsPresent bounce = $Bounce.IsPresent beatFade = $BeatFade.IsPresent border = $Border.IsPresent pull = $Pull className = $ClassName transform = $Transform style = $Style title = $Title icon = $IconName } $MUIcon.PSTypeNames.Insert(0, "UniversalDashboard.Icon") | Out-Null $MUIcon } } $scriptBlock = { param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameters) if ($fakeBoundParameters.ContainsKey('Solid')) { $Script:FontAwesomeSolid | Where-Object { $_ -like "$wordToComplete*" } } else { $Script:FontAwesomeRegular | Where-Object { $_ -like "$wordToComplete*" } $Script:FontAwesomeBrands | Where-Object { $_ -like "$wordToComplete*" } } } Register-ArgumentCompleter -CommandName New-UDIcon -ParameterName Icon -ScriptBlock $scriptBlock function New-UDIFrame { <# .SYNOPSIS An HTML IFrame component. .DESCRIPTION An HTML IFrame component. .PARAMETER Id The ID of this component. .PARAMETER Uri The URI for the iframe. .EXAMPLE Defines an IFrame for Google. New-UDIFrame -Uri https://www.google.com #> param( [Parameter()] [String]$Id = ([Guid]::NewGuid()), [Parameter()] [String]$Uri ) New-UDElement -Id $Id -Tag "iframe" -Attributes @{ src = $Uri } } function New-UDImage { <# .SYNOPSIS An image component. .DESCRIPTION An image component. .PARAMETER Id The ID of this component. .PARAMETER Url The URL to the image. .PARAMETER Path The path to a local image. .PARAMETER Height The height in pixels. .PARAMETER Width The width in pixels. .PARAMETER Attributes Additional attributes to apply to the img tag. .PARAMETER ClassName A CSS class to apply to the image. .EXAMPLE Displays an image. New-UDImage -Url 'https://ironmansoftware.com/logo.png' #> [CmdletBinding(DefaultParameterSetName = 'url')] param( [Parameter()] [String]$Id = ([Guid]::NewGuid()), [Parameter(ParameterSetName = 'url')] [String]$Url, [Parameter(ParameterSetName = 'path')] [String]$Path, [Parameter()] [int]$Height, [Parameter()] [int]$Width, [Parameter()] [Hashtable]$Attributes = @{}, [Parameter()] [string]$ClassName ) switch ($PSCmdlet.ParameterSetName) { 'path' { if (-not [String]::IsNullOrEmpty($Path)) { if (-not (Test-Path $Path)) { throw "$Path does not exist." } $mimeType = 'data:image/png;base64, ' if ($Path.EndsWith('jpg') -or $Path.EndsWith('jpeg')) { $mimeType = 'data:image/jpg;base64, ' } $base64String = [Convert]::ToBase64String([System.IO.File]::ReadAllBytes($Path)) $Attributes.'src' = "$mimeType $base64String" } } 'url' { $Attributes.'src' = $Url } } if ($PSBoundParameters.ContainsKey('ClassName')) { $Attributes.'className' = $ClassName } if ($PSBoundParameters.ContainsKey('Height')) { $Attributes.'height' = $Height } if ($PSBoundParameters.ContainsKey('Width')) { $Attributes.'width' = $Width } $Attributes["id"] = $Id New-UDElement -Tag 'img' -Attributes $Attributes } function New-UDLayout { <# .SYNOPSIS Create a layout based on the number of components within the layout. .DESCRIPTION Create a layout based on the number of components within the layout. The component wraps New-UDRow and New-UDColumn to automatically layout components in the content. .PARAMETER Columns The number of columns in this layout. .PARAMETER Content The content for this layout. .EXAMPLE New-UDLayout -Columns 2 -Content { New-UDTypography "Row 1, Col 1" New-UDTypography "Row 1, Col 2" New-UDTypography "Row 2, Col 1" New-UDTypography "Row 2, Col 2" } #> param( [Parameter(Mandatory = $true)] [ValidateRange(1, 12)] [int]$Columns, [Parameter(Mandatory = $true)] [ScriptBlock]$Content ) $Components = $Content.Invoke() if ($Columns -eq 1) { $LargeColumnSize = 12 $MediumColumnSize = 12 $SmallColumnSize = 12 } else { $LargeColumnSize = 12 / $Columns $MediumColumnSize = 12 / ($Columns / 2) $SmallColumnSize = 12 } $Offset = 0 $ComponentCount = ($Components | Measure-Object).Count while ($Offset -lt $ComponentCount) { $ColumnObjects = $Components | Select-Object -Skip $Offset -First $Columns | ForEach-Object { New-UDColumn -SmallSize $SmallColumnSize -MediumSize $MediumColumnSize -LargeSize $LargeColumnSize -Content { $_ } } New-UDRow -Columns { $ColumnObjects } $Offset += $Columns } } function New-UDLink { <# .SYNOPSIS Short description .DESCRIPTION Long description .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Url The URL of the link. .PARAMETER Underline Whether to underline the link. .PARAMETER Style A custom style to apply to the link. .PARAMETER Variant The theme variant to apply to the link. .PARAMETER ClassName The CSS class to apply to the link. .PARAMETER OpenInNewWindow Opens the link in a new window. .PARAMETER Children The components to link. .PARAMETER Text Text to include in the link. .PARAMETER OnClick A script block to invoke when clicked. .PARAMETER Download Adds the download attribute to this link. .EXAMPLE An example .NOTES General notes #> param( [Parameter()] [string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter()] [string]$url, [Parameter()] [ValidateSet('none', 'hover', 'always')] [string]$Underline = "none", [Parameter()] [hashtable]$Style, [Parameter()] [ValidateSet('h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'subtitle1', 'subtitle2', 'body1', 'body2', 'caption', 'button', 'overline', 'srOnly', 'inherit')] [string]$Variant, [Parameter ()] [string]$ClassName, [Parameter()] [switch]$OpenInNewWindow, [Parameter(ParameterSetName = 'content')] [Alias("Content")] [scriptblock]$Children, [Parameter(ParameterSetName = 'text')] [string]$Text, [Parameter()] [Endpoint]$OnClick, [Parameter()] [switch]$Download ) End { if ($OnClick) { $OnClick.Register($Id, $PSCmdlet) } if ($null -ne $Children) { $Object = & $Children } else { $Object = $null } @{ type = 'mu-link' isPlugin = $true assetId = $MUAssetId id = $Id url = $url underline = $underline style = $style variant = $variant className = $ClassName openInNewWindow = $openInNewWindow.IsPresent content = $Object text = $text onClick = $OnClick download = $Download.IsPresent } } } function New-UDList { <# .SYNOPSIS Creates a list. .DESCRIPTION Creates a list. Use New-UDListItem to add new items to the list. Lists are good for links in UDDrawers. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Children The items in the list. .PARAMETER SubHeader Text to show within the sub header. .EXAMPLE Creates a new list with two items and nested list items. New-UDList -Id 'listContent' -Content { New-UDListItem -Id 'listContentItem' -AvatarType Avatar -Source 'https://pbs.twimg.com/profile_images/1065243723217416193/tg3XGcVR_400x400.jpg' -Label 'Adam Driscoll' -Content { New-UDListItem -Id 'list-item-security' -Label 'username and passwords' New-UDListItem -Id 'list-item-api' -Label 'api keys' } } #> param( [Parameter ()] [string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter ()] [Alias("Content")] [scriptblock]$Children, [Parameter ()] [string]$SubHeader, [Parameter()] [string]$ClassName ) End { try { $c = & $Children } catch { $c = New-UDError -Message $_ } @{ type = 'mu-list' isPlugin = $true assetId = $MUAssetId id = $Id children = $c subHeader = $SubHeader style = $Style className = $ClassName } } } function New-UDListItem { <# .SYNOPSIS Creates a new list item. .DESCRIPTION Creates a new list item. List items are used with New-UDList. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER AvatarType The type of avatar to show within the list item. .PARAMETER OnClick A script block to execute when the list item is clicked. .PARAMETER Label The label to show within the list item. .PARAMETER Children Nested list items to show underneath this list item. .PARAMETER SubTitle The subtitle to show within the list item. .PARAMETER Icon The icon to show within the list item. .PARAMETER Switch The switch to show within the list item. .PARAMETER SwitchAlignment How to align the sqitch within the listitem. Valid values are: "left", "right" .PARAMETER CheckBox The checkbox to show within the list item. .PARAMETER CheckBoxAlignment How to align the checkbox within the listitem. Valid values are: "left", "right" .PARAMETER Source Parameter description .PARAMETER SecondaryAction The secondary action to issue with this list item. .EXAMPLE Creates a new list with two items and nested list items. New-UDList -Id 'listContent' -Content { New-UDListItem -Id 'listContentItem' -AvatarType Avatar -Source 'https://pbs.twimg.com/profile_images/1065243723217416193/tg3XGcVR_400x400.jpg' -Label 'Adam Driscoll' -Content { New-UDListItem -Id 'list-item-security' -Label 'username and passwords' New-UDListItem -Id 'list-item-api' -Label 'api keys' } } #> [CmdletBinding()] param( [Parameter ()] [string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter ()] [ValidateSet("Icon", "Avatar")][string]$AvatarType = 'Icon', [Parameter ()] [Endpoint]$OnClick, [Parameter ()] [object]$Label, [Parameter ()] [Alias("Content")] [scriptblock]$Children, [Parameter ()] [string]$SubTitle, [Parameter ()] $Icon, [Parameter ()] [string]$Source, [Parameter ()] [scriptblock]$SecondaryAction, [Parameter()] [string]$ClassName, [Parameter()] [Switch]$Open, [Parameter()] [Switch]$Nested, [Parameter()] [string]$Href, [Parameter ()] $Switch, [ValidateSet("left", "right")] [string]$SwitchAlignment = "right", [Parameter ()] $CheckBox, [ValidateSet("left", "right")] [string]$CheckBoxAlignment = "right" ) begin {} Process {} End { if ($OnClick) { $OnClick.Register($Id, $PSCmdlet) } if ($null -ne $Children) { try { $CardContent = & $Children } catch { $CardContent = New-UDError -Message $_ } } else { $CardContent = $null } if ($null -ne $SecondaryAction) { $Action = $SecondaryAction.Invoke() } else { $Action = $null } @{ type = 'mu-list-item' isPlugin = $true assetId = $MUAssetId id = $Id subTitle = $SubTitle label = if ($Label -is [ScriptBlock]) { & $Label } else { $Label } onClick = $OnClick children = $CardContent secondaryAction = $Action icon = $Icon source = $Source avatarType = $AvatarType labelStyle = $LabelStyle style = $Style className = $ClassName open = $Open.IsPresent nested = $Nested.IsPresent href = $Href switch = $Switch checkBox = $CheckBox switchAlignment = $SwitchAlignment.ToLower() checkBoxAlignment = $CheckBoxAlignment.ToLower() } } } function New-UDMarkdown { <# .SYNOPSIS Converts markdown to HTML. .DESCRIPTION Converts markdown to HTML. .PARAMETER Id The ID of this component. .PARAMETER Markdown The markdown to convert to HTML. #> param( [Parameter()] [String]$Id = ([Guid]::NewGuid()), [Parameter(Mandatory)] [Alias("Markdown")] [String]$Children ) @{ type = 'mu-markdown' id = $Id children = $Children } } function New-UDMenu { <# .SYNOPSIS Creates a pop up menu. .DESCRIPTION Creates a pop up menu. .PARAMETER Id The ID of this component. .PARAMETER Text The text to display in the button that opens this menu. .PARAMETER OnChange An event handler to call when the user selects an item from the menu. $EventData will include the selected item. .PARAMETER Children The items to display in the menu. .PARAMETER ClassName The class name of the menu. .PARAMETER Variant The button variant for the menu. .PARAMETER Size The size of the menu button. Valid values are: "small", "medium" .EXAMPLE New-UDMenu -Text 'Click Me' -OnChange { Show-UDToast $EventData } -Children { New-UDMenuItem -Text 'Test' New-UDMenuItem -Text 'Test2' New-UDMenuItem -Text 'Test3' } Creates a simple menu. #> param( [Parameter()] [string]$Id = [Guid]::NewGuid(), [Parameter(Mandatory)] [string]$Text, [Parameter()] [Endpoint]$OnChange, [Parameter(Mandatory)] [Alias('Items')] [Alias('Content')] [ScriptBlock]$Children, [Parameter] [string]$ClassName, [ValidateSet("text", "outlined", "contained")] [string]$Variant = "contained", [Parameter()] [Hashtable]$Icon, [ValidateSet("small", "medium", "large")] [string]$Size = 'medium' ) if ($OnChange) { $OnChange.Register($Id, $PSCmdlet) } @{ assetId = $MUAssetId id = $Id isPlugin = $true type = 'mu-menu' text = $Text onChange = $OnChange children = & $Children className = $ClassName icon = $Icon variant = $Variant.ToLower() size = $Size.ToLower() } } function New-UDMenuItem { <# .SYNOPSIS Creates a menu item. .DESCRIPTION Creates a menu item. .PARAMETER Text The text to display in the menu item. .PARAMETER Value The value of the menu item. If not specified, the text will be used. .EXAMPLE New-UDMenu -Text 'Click Me' -OnChange { Show-UDToast $EventData } -Children { New-UDMenuItem -Text 'Test' New-UDMenuItem -Text 'Test2' New-UDMenuItem -Text 'Test3' } Creates a simple menu. #> param( [Parameter()] [string]$Id = [Guid]::NewGuid(), [Parameter(Mandatory)] [string]$Text, [Parameter()] [string]$Value, [Parameter()] [Hashtable]$Icon, [Parameter()] [Endpoint]$OnClick ) if ($OnClick) { $OnClick.Register($Id, $PSCmdlet) } @{ assetId = $MUAssetId id = $Id isPlugin = $true type = 'mu-menu-item' text = $Text value = if ($Value) { $Value } else { $Text } icon = $Icon onClick = $OnClick } } function New-UDPaper { <# .SYNOPSIS Creates a paper. .DESCRIPTION Creates a paper. Paper is used to highlight content within a page. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Children The content of this paper element. .PARAMETER Width The width of this paper. .PARAMETER Height The height of this paper. .PARAMETER Square Whether this paper is square. .PARAMETER Style The CSS style to apply to this paper. .PARAMETER Elevation The elevation of this paper. .PARAMETER ClassName A CSS class to apply to the paper. .EXAMPLE Creates paper with a heading, custom style and an elevation of 4. New-UDPaper -Children { New-UDHeading -Text "hi" -Id 'hi' } -Style @{ backgroundColor = '#90caf9' } -Id 'paperElevation' -Elevation 4 .NOTES General notes #> param( [Parameter()][string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter()][Alias("Content")][ScriptBlock]$Children, [Parameter()][string]$Width = '500', [Parameter()][string]$Height = '500', [Parameter()][Switch]$Square, [Parameter()][Hashtable]$Style, [Parameter()][int]$Elevation, [Parameter()] [string]$ClassName ) End { $c = New-UDErrorBoundary -Content $Children @{ type = 'mu-paper' isPlugin = $true assetId = $MUAssetId id = $Id width = $Width children = $c height = $Height square = $Square.IsPresent style = $Style elevation = $Elevation className = $ClassName } } } function New-UDParagraph { <# .SYNOPSIS A paragraph. .DESCRIPTION A paragraph. Used to define a P HTML tag. .PARAMETER Content The content of the paragraph. .PARAMETER Text The text of the paragraph. .PARAMETER Color The font color of the paragraph. .EXAMPLE A simple paragraph. New-UDParagraph -Text 'Hello, world!' #> param( [Parameter(ParameterSetName = 'content')] [ScriptBlock]$Content, [Parameter(ParameterSetName = 'text')] [string]$Text, [Parameter()] [UniversalDashboard.Models.DashboardColor]$Color = 'black' ) if ($PSCmdlet.ParameterSetName -eq 'content') { New-UDElement -Tag 'p' -Content $Content -Attributes @{ style = @{ color = $Color.HtmlColor } } } else { New-UDElement -Tag 'p' -Content { $Text } -Attributes @{ style = @{ color = $Color.HtmlColor } } } } function New-UDProgress { <# .SYNOPSIS Creates a progress dialog. .DESCRIPTION Creates a progress dialog. Progress dialogs can show both determinate and indeterminate progress. They can also be circular or linear. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER PercentComplete The percent complete for the progress. .PARAMETER BackgroundColor The background color. .PARAMETER ProgressColor The progress bar color. .PARAMETER Circular Whether the progress is circular. .PARAMETER Size The size of the progress. Valid values are: "small", "medium", "large" .EXAMPLE Creates a progress bar at 75%. New-UDProgress -PercentComplete 75 #> [CmdletBinding(DefaultParameterSetName = "indeterminate")] param( [Parameter()] [string]$Id = [Guid]::NewGuid().ToString(), [Parameter(ParameterSetName = "determinate")] [ValidateRange(0, 100)] [int32]$PercentComplete, [Parameter(ParameterSetName = "indeterminate")] [Parameter(ParameterSetName = "determinate")] [UniversalDashboard.Models.DashboardColor]$BackgroundColor, [Parameter()] [Alias("Color")] [UniversalDashboard.Models.DashboardColor]$ProgressColor, [Parameter(ParameterSetName = 'circular')] [Switch]$Circular, [Parameter(ParameterSetName = 'circular')] [ValidateSet('small', 'medium', 'large')] [string]$Size ) End { @{ id = $Id assetId = $MUAssetId isPlugin = $true type = "mu-progress" variant = $PSCmdlet.ParameterSetName percentComplete = $PercentComplete backgroundColor = $BackgroundColor.HtmlColor progressColor = $ProgressColor.HtmlColor circular = $Circular.IsPresent color = $Color size = $Size } } } function Protect-UDSection { <# .SYNOPSIS Hides a section of a dashboard if the user is not part of the specified role. .DESCRIPTION Hides a section of a dashboard if the user is not part of the specified role. .PARAMETER Children The content to hide. .PARAMETER Role The role the user must be a part of. .EXAMPLE Protect-UDSection -Content { New-UDTypography 'Admins Only' } -Role @("Administrator") .NOTES General notes #> param( [Parameter(Mandatory)] [Alias('Content')] [ScriptBlock]$Children, [Parameter(Mandatory)] [string[]]$Role ) $MatchingRoles = $Roles | Where-Object { $_ -in $Role } if ($MatchingRoles.Length -gt 0) { & $Children } } function New-UDRadioGroup { <# .SYNOPSIS Creates a group of radio buttons. .DESCRIPTION Creates a group of radio buttons. Within a group, only a single radio will be able to be selected. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Label The label to show for this radio group. .PARAMETER Children The radio buttons to include within this group. .PARAMETER OnChange A script block to call when the radio group selection changes. The $EventData variable will include the value of the radio that is selected. .PARAMETER Value The selected value for this radio group. .EXAMPLE Creates a radio group that shows a toast message when a radio is selected. New-UDRadioGroup -Label 'group' -Id 'onChangeRadio' -Children { New-UDRadio -Value 'Adam' -Label 'Adam' -Id 'adamOnChange' New-UDRadio -Value 'Alon' -Label 'Alon' -Id 'alonOnChange' New-UDRadio -Value 'Lee' -Label 'Lee' -Id 'leeOnChange' } -OnChange { Show-UDToast $EventData } #> param( [Parameter()] [String]$Id = ([Guid]::NewGuid()), [Parameter()] [String]$Label, [Parameter()] [Alias("Content")] [ScriptBlock]$Children, [Parameter()] [Endpoint]$OnChange, [Parameter()] [string]$Value, [Parameter()] [string]$ClassName, [Parameter()] [string]$DefaultValue, [Parameter()] [Switch]$Disabled ) if ($OnChange) { $OnChange.Register($Id, $PSCmdlet) } @{ assetId = $MUAssetId id = $Id isPlugin = $true type = 'mu-radiogroup' onChange = $OnChange value = $Value label = $Label children = & $Children className = $ClassName defaultValue = $DefaultValue disabled = $Disabled.IsPresent } } function New-UDRadio { <# .SYNOPSIS Creates a radio. .DESCRIPTION Creates a radio. Radios should be included within a New-UDRadioGroup. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Label The label to show next to the radio. .PARAMETER Disabled Whether the radio is disabled. .PARAMETER Value The value of the radio. .PARAMETER LabelPlacement The position to place the label in relation to the radio. .PARAMETER Color The theme color to apply to this radio .EXAMPLE Creates a radio group that shows a toast message when a radio is selected. New-UDRadioGroup -Label 'group' -Id 'onChangeRadio' -Children { New-UDRadio -Value 'Adam' -Label 'Adam' -Id 'adamOnChange' New-UDRadio -Value 'Alon' -Label 'Alon' -Id 'alonOnChange' New-UDRadio -Value 'Lee' -Label 'Lee' -Id 'leeOnChange' } -OnChange { Show-UDToast $EventData } #> param( [Parameter()] [String]$Id = ([Guid]::NewGuid()), [Parameter()] [String]$Label, [Parameter()] [Switch]$Disabled, [Parameter()] [string]$Value, [Parameter()] [ValidateSet('start', 'end')] [string]$LabelPlacement = 'end', [Parameter ()] [ValidateSet('default', 'primary', 'secondary')] [string]$Color = 'default' ) @{ assetId = $MUAssetId id = $Id isPlugin = $true type = 'mu-radio' label = $Label disabled = $Disabled.IsPresent value = $value labelPlacement = $LabelPlacement color = $Color.ToLower() } } function New-UDRating { param( [Parameter()] [string]$Id = [Guid]::NewGuid().ToString(), [Parameter()] [double]$DefaultValue, [Parameter()] [Switch]$Disabled, [Parameter()] [string]$EmptyLabelText = "Empty", [Parameter()] [Switch]$HighlightSelectedOnly, [Parameter()] [double]$Max = 5, [Parameter()] [Endpoint]$OnChange, [Parameter()] [double]$Precision = 1, [Parameter()] [ValidateSet("small", "medium", "large")] [string]$Size = 'medium', [Parameter()] [double]$Value ) if ($OnChange) { $OnChange.Register($id, $PSCmdlet) } @{ id = $Id isPlugin = $true type = "mu-rating" defaultValue = $DefaultValue disabled = $Disabled.IsPresent emptyLabelText = $EmptyLabelText highlightSelectedOnly = $HighlightSelectedOnly.IsPresent max = $Max onChange = $OnChange precision = $Precision size = $Size.ToLower() value = $Value } } function New-UDSelect { <# .SYNOPSIS Creates a new select. .DESCRIPTION Creates a new select. Selects can have multiple options and option groups. Selects can also be multi-select. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Option Options to include in this select. This can be either New-UDSelectOption or New-UDSelectGroup. .PARAMETER Label The label to show with the select. .PARAMETER OnChange A script block that is executed when the script changes. $EventData will be an array of the selected values. .PARAMETER DefaultValue The default selected value. .PARAMETER Disabled Whether this select is disabled. .PARAMETER Icon The icon to show next to the textbox. Use New-UDIcon to create an icon. .PARAMETER Multiple Whether you can select multiple values. .PARAMETER FullWidth Stretch the select to the full width of the parent component. .EXAMPLE Creates a new select with 3 options and shows a toast when one is selected. New-UDSelect -Label '1-3' -Id 'select' -Option { New-UDSelectOption -Name "One" -Value 1 New-UDSelectOption -Name "Two" -Value 2 New-UDSelectOption -Name "Three" -Value 3 } -DefaultValue 2 -OnChange { Show-UDToast -Mesage $EventData } #> param( [Parameter()] [String]$Id = ([Guid]::NewGuid()), [Parameter()] [ScriptBlock]$Option, [Parameter()] [String]$Label, [Parameter()] [Endpoint]$OnChange, [Parameter()] $DefaultValue, [Parameter()] [Switch]$Disabled, [Parameter()] [Switch]$Multiple, [Parameter()] [string]$MaxWidth, [Parameter()] [string]$ClassName, [Parameter()] [switch]$FullWidth, [Parameter()] [ValidateSet('filled', 'outlined', 'standard')] [string]$Variant = 'standard', [Parameter()] $Icon ) if ($OnChange) { $OnChange.Register($Id + "onChange", $PSCmdlet) } if ($PSBoundParameters.ContainsKey("Multiple") -and $PSBoundParameters.ContainsKey("DefaultValue") -and $DefaultValue -isnot [array]) { $DefaultValue = @($DefaultValue) } @{ type = 'mu-select' assetId = $MUAssetId isPlugin = $true id = $id options = $Option.Invoke() label = $Label onChange = $OnChange defaultValue = $DefaultValue disabled = $Disabled.IsPresent icon = $icon multiple = $Multiple.IsPresent maxWidth = $MaxWidth className = $ClassName fullWidth = $FullWidth.IsPresent variant = $Variant.ToLower() value = $DefaultValue } } function New-UDSelectGroup { <# .SYNOPSIS Creates a new select group. .DESCRIPTION Creates a new select group. This cmdlet is to be used with New-UDSelect. Pass the result of this cmdlet to the -Option parameter to create a new select group. .PARAMETER Option Options to include in this group. .PARAMETER Name The name of the group. This will be displayed in the select. .EXAMPLE Creates a new select with two select groups. New-UDSelect -Id 'selectGrouped' -Option { New-UDSelectGroup -Name "Category 1" -Option { New-UDSelectOption -Name "One" -Value 1 New-UDSelectOption -Name "Two" -Value 2 New-UDSelectOption -Name "Three" -Value 3 } New-UDSelectGroup -Name "Category 2" -Option { New-UDSelectOption -Name "Four" -Value 4 New-UDSelectOption -Name "Five" -Value 5 New-UDSelectOption -Name "Six" -Value 6 } } -DefaultValue 2 -OnChange { Show-UDToast -Message $EventData } #> param( [Parameter(Mandatory = $true)] [ScriptBlock]$Option, [Parameter(Mandatory = $true)] [String]$Name ) @{ type = 'mu-select-group' name = $Name options = $Option.Invoke() } } function New-UDSelectOption { <# .SYNOPSIS Creates a new select option. .DESCRIPTION Creates a new select option. This cmdlet is to be used with New-UDSelect. Pass the result of this cmdlet to the -Option parameter to create a new select group. .PARAMETER Name The name of the select option. This will be shown in the select. .PARAMETER Value Thevalue of the select option. This will be passed back to New-UDForm -OnSubmit or the $EventData for -OnChange on New-UDSelect. .PARAMETER Icon The icon to show next to the textbox. Use New-UDIcon to create an icon. .EXAMPLE Creates a new select with three options. New-UDSelect -Label '1-3' -Id 'select' -Option { New-UDSelectOption -Name "One" -Value 1 New-UDSelectOption -Name "Two" -Value 2 New-UDSelectOption -Name "Three" -Value 3 } -DefaultValue 2 -OnChange { $EventData = $Body | ConvertFrom-Json Set-TestData $EventData } #> param( [Parameter(Mandatory = $true)] [String]$Name, [Parameter(Mandatory = $true)] [String]$Value, [Parameter()] $Icon ) @{ type = 'mu-select-option' name = $Name value = $Value icon = $icon } } function New-UDSkeleton { <# .SYNOPSIS Creates a loading skeleton .DESCRIPTION Creates a loading skeleton .PARAMETER Id The ID of this component. .PARAMETER Variant The type of skeleton to display. Valid values are "text", "rect", "circle" .PARAMETER Height The static height of the skeleton. .PARAMETER Width The static width of the skeleton. .PARAMETER Animation The type of animation to use for the skeleton. Valid values are: "wave", "disabled", "pulsate" .PARAMETER ClassName A CSS class to apply to the skeleton. #> param( [Parameter()] [String]$Id = ([Guid]::NewGuid()), [Parameter()] [ValidateSet("text", "rect", "circle")] [string]$Variant = 'text', [Parameter()] [int]$Height, [Parameter()] [int]$Width, [Parameter()] [ValidateSet("wave", "disabled", "pulsate")] [string]$Animation = "pulsate", [Parameter()] [string]$ClassName ) @{ type = "mu-skeleton" id = $Id isPlugin = $true assetId = $MUAssetId variant = $Variant.ToLower() height = $Height width = $Width animation = $Animation.ToLower() className = $ClassName } } function New-UDSlider { <# .SYNOPSIS A slider component. .DESCRIPTION A slider component. Sliders can be used to define values within a range or selecting a range of values. You can use this component with New-UDForm. .PARAMETER Id The ID of this component. .PARAMETER Value The value of the slider. .PARAMETER Minimum The minimum value of the slider. .PARAMETER Maximum The maximum value of the slider. .PARAMETER Disabled Whether the slider is disabled. .PARAMETER Marks Whether to display marks on the slider. .PARAMETER OnChange A script block that is invoked when the slider value changes. You can access the slider value within the script block by referencing the $EventData variable. .PARAMETER Orientation The orientation of the slider. .PARAMETER Step Step size of the slider. .PARAMETER ValueLabelDisplay Whether to display value labels. .PARAMETER ClassName A CSS class to apply to the slider. .PARAMETER Color The color of the slider. Defaults to 'primary'. Valid values: "primary", "secondary" .EXAMPLE An example New-UDSlider .NOTES General notes #> param( [Parameter()] [String]$Id = ([Guid]::NewGuid()), [Parameter()] [int[]]$Value = 0, [Parameter()] [int]$Minimum = 0, [Parameter()] [int]$Maximum = 100, [Parameter()] [Switch]$Disabled, [Parameter()] [Switch]$Marks, [Parameter()] [Endpoint]$OnChange, [Parameter()] [ValidateSet('horizontal', 'vertical')] [string]$Orientation = 'horizontal', [Parameter()] [int]$Step = 1, [Parameter()] [ValidateSet('on', 'auto', 'off')] [string]$ValueLabelDisplay = 'auto', [Parameter()] [string]$ClassName, [Parameter()] [ValidateSet("primary", 'secondary')] [string]$Color = 'primary' ) if ($OnChange) { $OnChange.Register($Id, $PSCmdlet) } if (-not $PSCmdlet.MyInvocation.BoundParameters.ContainsKey("Value")) { $Value = $Minimum } if ($Value -lt $Minimum) { throw "Value cannot be less than minimum" } if ($Value -gt $Maximum) { throw "Value cannot be more than maximum" } $Val = $Value if ($Value.Length -eq 1) { $Val = $Value | Select-Object -First 1 } @{ type = 'mu-slider' isPlugin = $true assetId = $MUAssetId id = $Id value = $val min = $Minimum max = $Maximum disabled = $Disabled.IsPresent marks = $Marks.IsPresent onChange = $OnChange orientation = $Orientation step = $Step valueLabelDisplay = $ValueLabelDisplay className = $ClassName color = $Color.ToLower() } } function New-UDSpan { <# .SYNOPSIS A span component. .DESCRIPTION A span component. Defines a span HTML tag. .PARAMETER Id The ID of this component. .PARAMETER Content The content of the span. .EXAMPLE An example New-UDSpan -Content { New-UDTypography -Text 'Text' } #> param( [Parameter()] [String]$Id = ([Guid]::NewGuid()), [Parameter()] [ScriptBlock]$Content ) New-UDElement -Id $Id -Tag "span" -Content { $Content } } function New-UDSplitPane { param( [Parameter()] [string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter(Mandatory)] [ScriptBlock]$Content, [Parameter()] [ValidateSet("vertical", "horizontal")] [string]$Direction = "vertical", [Parameter()] [int]$MinimumSize, [Parameter()] [int]$DefaultSize ) try { $Children = & $Content } catch { $Children = New-UDError -Message $_ } if ($Children.Length -ne 2) { Write-Error "Split pane requires exactly two components in Content" return } $Options = @{ content = $Children id = $Id split = $Direction.ToLower() type = "ud-splitpane" } if ($PSCmdlet.MyInvocation.BoundParameters.ContainsKey("MinimumSize")) { $Options["minSize"] = $MinimumSize } if ($PSCmdlet.MyInvocation.BoundParameters.ContainsKey("DefaultSize")) { $Options["defaultSize"] = $DefaultSize } $Options } function New-UDStack { <# .SYNOPSIS The Stack component manages layout of immediate children along the vertical or horizontal axis with optional spacing and/or dividers between each child. .DESCRIPTION Stack is concerned with one-dimensional layouts, while Grid handles two-dimensional layouts. The default direction is column which stacks children vertically. .PARAMETER Id The ID of this component. .PARAMETER Children The children to stack. .PARAMETER Divider An optional divider component. .PARAMETER Spacing The spacing between the items. .PARAMETER Direction The stack direction. .EXAMPLE New-UDStack -Content { New-UDPaper New-UDPaper New-UDPaper } -Spacing 2 Creates a stack of papers with 2 spacing. #> param( [Parameter()] [String]$Id = ([Guid]::NewGuid()), [Parameter(Mandatory)] [Alias("Content")] [scriptblock]$Children, [Parameter()] [scriptblock]$Divider = {}, [Parameter()] [int]$Spacing, [Parameter()] [ValidateSet('row', 'column', "row-reverse", "column-reverse")] [string]$Direction = 'row', [Parameter()] [switch]$FullWidth, [Parameter()] [ValidateSet('flex-start', 'flex-end', 'center', 'stretch', 'baseline')] [string]$AlignItems ) @{ id = $id assetId = $MUAssetId isPlugin = $true type = "mu-stack" children = & $Children divider = & $Divider spacing = $Spacing alignItems = if ($AlignItems) { $AlignItems.ToLower() } else { $null } direction = $Direction.ToLower() fullWidth = $FullWidth.IsPresent } } function New-UDStepper { <# .SYNOPSIS Creates a new stepper component. .DESCRIPTION Creates a new stepper component. Steppers can be used as multi-step forms or to display information in a stepped manner. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER ActiveStep Sets the active step. This should be the index of the step. .PARAMETER Children The steps for this stepper. Use New-UDStep to create new steps. .PARAMETER NonLinear Allows the user to progress to steps out of order. .PARAMETER AlternativeLabel Places the step label under the step number. .PARAMETER OnFinish A script block that is executed when the stepper is finished. .PARAMETER Orientation Sets the orientation of the stepper. .PARAMETER NextButtonText The text to display in the next button. .PARAMETER BackButtonText The text to display in the back button. .PARAMETER FinsihButtonText The text to display in the finish button. .EXAMPLE Creates a stepper that reports the stepper context with each step. New-UDStepper -Id 'stepper' -Steps { New-UDStep -OnLoad { New-UDElement -tag 'div' -Content { "Step 1" } New-UDTextbox -Id 'txtStep1' } -Label "Step 1" New-UDStep -OnLoad { New-UDElement -tag 'div' -Content { "Step 2" } New-UDElement -tag 'div' -Content { "Previous data: $Body" } New-UDTextbox -Id 'txtStep2' } -Label "Step 2" New-UDStep -OnLoad { New-UDElement -tag 'div' -Content { "Step 3" } New-UDElement -tag 'div' -Content { "Previous data: $Body" } New-UDTextbox -Id 'txtStep3' } -Label "Step 3" } -OnFinish { New-UDTypography -Text 'Nice! You did it!' -Variant h3 New-UDElement -Tag 'div' -Id 'result' -Content {$Body} } #> param( [Parameter()] [String]$Id = ([Guid]::NewGuid()), [Parameter()] [int]$ActiveStep = 0, [Alias("Steps")] [Parameter(Mandatory)] [ScriptBlock]$Children, [Parameter()] [Switch]$NonLinear, [Parameter()] [Switch]$AlternativeLabel, [Parameter(Mandatory)] [Endpoint]$OnFinish, [Parameter()] [Endpoint]$OnCancel, # [Parameter()] # [Endpoint]$OnCompleteStep, [Parameter()] [Endpoint]$OnValidateStep, [Parameter()] [ValidateSet("vertical", "horizontal")] [string]$Orientation = "horizontal", [Parameter()] [string]$NextButtonText = "Next", [Parameter()] [string]$BackButtonText = "Back", [Parameter()] [string]$FinishButtonText = "Finish", [Parameter()] [string]$CancelButtonText = "Cancel", [Parameter()] [string]$ClassName ) $OnFinish.Register($Id + "onFinish", $PSCmdlet) if ($OnCancel) { $OnCancel.Register($Id + "OnCancel", $PSCmdlet) } if ($OnCompleteStep) { $OnCompleteStep.Register($Id + "onComplete", $PSCmdlet) } if ($OnValidateStep) { $OnValidateStep.Register($Id + "onValidate", $PSCmdlet) } $c = New-UDErrorBoundary -Content $Children @{ id = $id isPlugin = $true type = 'mu-stepper' assetId = $MUAssetId children = $c nonLinear = $NonLinear.IsPresent alternativeLabel = $AlternativeLabel.IsPresent onFinish = $OnFinish activeStep = $ActiveStep onValidateStep = $OnValidateStep onCompleteStep = $OnCompleteStep orientation = $Orientation.ToLower() nextButtonText = $NextButtonText finishButtonText = $FinishButtonText backButtonText = $BackButtonText className = $ClassName onCancel = $OnCancel cancelButtonText = $CancelButtonText } } function New-UDStep { <# .SYNOPSIS Creates a new step for a stepper. .DESCRIPTION Creates a new step for a stepper. Add to the Children (alias Steps) parameter for New-UDStepper. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER OnLoad The script block that is executed when the step is loaded. The script block will receive the $Body parameter which contains JSON for the current state of the stepper. If you are using form controls, their data will be availalble in the $Body.Context property. .PARAMETER Label A label for this step. .PARAMETER Optional Whether this step is optional. .PARAMETER Icon The icon to put with the step .PARAMETER RemoveIconStyle Removes circle style around icon .PARAMETER DisablePrevious Disables the back button on the step .EXAMPLE Creates a stepper that reports the stepper context with each step. New-UDStepper -Id 'stepper' -Steps { New-UDStep -OnLoad { New-UDElement -tag 'div' -Content { "Step 1" } New-UDTextbox -Id 'txtStep1' } -Label "Step 1" New-UDStep -OnLoad { New-UDElement -tag 'div' -Content { "Step 2" } New-UDElement -tag 'div' -Content { "Previous data: $Body" } New-UDTextbox -Id 'txtStep2' } -Label "Step 2" New-UDStep -OnLoad { New-UDElement -tag 'div' -Content { "Step 3" } New-UDElement -tag 'div' -Content { "Previous data: $Body" } New-UDTextbox -Id 'txtStep3' } -Label "Step 3" } -OnFinish { New-UDTypography -Text 'Nice! You did it!' -Variant h3 New-UDElement -Tag 'div' -Id 'result' -Content {$Body} } #> param( [Parameter()] [String]$Id = ([Guid]::NewGuid()), [Alias("Content")] [Parameter(Mandatory)] [Endpoint]$OnLoad, [Parameter()] [string]$Label, [Parameter()] [Switch]$Optional, [Parameter()] [Switch]$DisablePrevious, [Parameter ()] $Icon, [Parameter()] [Switch]$RemoveIconStyle ) $OnLoad.Register($Id + "onLoad", $PSCmdlet) @{ id = $id isPlugin = $true type = 'mu-stepper-step' assetId = $MUAssetId onLoad = $OnLoad label = $Label optional = $Optional.IsPresent icon = $Icon disablePrevious = $DisablePrevious.IsPresent removeIconStyle = $RemoveIconStyle.IsPresent } } function New-UDStyle { <# .SYNOPSIS Style a component with CSS styles. .DESCRIPTION Style a component with CSS styles. .PARAMETER Id The ID of this component. .PARAMETER Style The CSS style to apply .PARAMETER Tag The outer HTML tag to use. .PARAMETER Content The content of this style. .PARAMETER Sx A hashtable of theme-aware CSS properties. .PARAMETER Component The root component to apply the Sx component to. .EXAMPLE #> param( [Parameter()] [string]$Id = ([Guid]::NewGuid()), [Parameter(Mandatory = $true, ParameterSetName = 'Style')] [string]$Style, [Parameter(Mandatory = $true, ParameterSetName = 'Sx')] [Hashtable]$Sx, [Parameter(ParameterSetName = 'Sx')] [string]$Component, [Parameter()] [string]$Tag = 'div', [Parameter()] [ScriptBlock]$Content ) End { $Children = $null if ($null -ne $Content) { $Children = & $Content } @{ assetId = $AssetId isPlugin = $true type = "ud-style" id = $Id style = $Style tag = $Tag content = $Children sx = $Sx component = $Component } } } function New-UDSwitch { <# .SYNOPSIS Creates a new switch. .DESCRIPTION Creates a new switch. A switch behaves like a checkbox but looks a little different. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Disabled Whether this switch is disabled. .PARAMETER OnChange A script block that is called when this switch changes. The $EventData variable will contain the checked value ($true\$false). .PARAMETER Checked Whether this switch is checked. .PARAMETER Color The theme color to apply to this switch. .PARAMETER Label The label to display next to the switch .PARAMETER CheckedLabel The label to display for when the switch is checked .PARAMETER UncheckedLabel The label to display for when the switch is unchecked .PARAMETER ClassName A CSS class to apply to the switch. .PARAMETER Size The size of the switch. Valid values are: "small", "medium" .PARAMETER CheckStyle Style switch with check and unchecked icons for the colorblind. .EXAMPLE Creates a switch that shows a toast when changed. New-UDSwitch -Id 'switchOnChange' -OnChange { Show-UDToast -Message $EventData } #> param( [Parameter()] [String]$Id = ([Guid]::NewGuid()), [Parameter()] [Switch]$Disabled, [Parameter()] [Endpoint]$OnChange, [Parameter()] [bool]$Checked, [Parameter()] [string]$ClassName, [Parameter ()] [ValidateSet('default', 'primary', 'secondary')] [string]$Color = 'default', [Parameter()] [string]$Label, [Parameter()] [string]$CheckedLabel, [Parameter()] [string]$UncheckedLabel, [Parameter()] [ValidateSet("small", "medium")] [string]$Size = 'medium', [Parameter()] [ValidateSet("top", "left", "right", "bottom")] [string]$LabelPlacement, [Parameter()] [Switch]$CheckStyle ) if ($OnChange) { $OnChange.Register($Id, $PSCmdlet) } @{ type = 'mu-switch' id = $Id assetId = $MUAssetId isPlugin = $true disabled = $Disabled.IsPresent checked = $Checked onChange = $onChange className = $ClassName color = $Color.ToLower() label = $Label checkedLabel = $CheckedLabel uncheckedLabel = $UncheckedLabel size = $Size.ToLower() labelPlacement = if ($LabelPlacement) { $LabelPlacement.ToLower() } else { $null } checkStyle = $CheckStyle.IsPresent } } function New-UDSyntaxHighlighter { <# .SYNOPSIS Syntax highlighting for text. .DESCRIPTION Syntax highlighting for text. .PARAMETER Id The ID of this component. .PARAMETER Code The code to syntax highlight. .PARAMETER Language The language to highlight the code in. .PARAMETER Style The style to apply to the code. .PARAMETER ShowLineNumbers Whether to show line numbers. #> param( [Parameter()] [string]$Id = [Guid]::NewGuid(), [Parameter(Mandatory)] [string]$Code, [Parameter()] [ValidateSet('abap', 'abnf', 'actionscript', 'ada', 'agda', 'al', 'antlr4', 'apacheconf', 'apex', 'apl', 'applescript', 'aql', 'arduino', 'arff', 'asciidoc', 'asm6502', 'asmatmel', 'aspnet', 'autohotkey', 'autoit', 'avisynth', 'avroIdl', 'bash', 'basic', 'batch', 'bbcode', 'bicep', 'birb', 'bison', 'bnf', 'brainfuck', 'brightscript', 'bro', 'bsl', 'c', 'cfscript', 'chaiscript', 'cil', 'clike', 'clojure', 'cmake', 'cobol', 'coffeescript', 'concurnas', 'coq', 'cpp', 'crystal', 'csharp', 'cshtml', 'csp', 'cssExtras', 'css', 'csv', 'cypher', 'd', 'dart', 'dataweave', 'dax', 'dhall', 'diff', 'django', 'dnsZoneFile', 'docker', 'dot', 'ebnf', 'editorconfig', 'eiffel', 'ejs', 'elixir', 'elm', 'erb', 'erlang', 'etlua', 'excelFormula', 'factor', 'falselang', 'firestoreSecurityRules', 'flow', 'fortran', 'fsharp', 'ftl', 'gap', 'gcode', 'gdscript', 'gedcom', 'gherkin', 'git', 'glsl', 'gml', 'gn', 'goModule', 'go', 'graphql', 'groovy', 'haml', 'handlebars', 'haskell', 'haxe', 'hcl', 'hlsl', 'hoon', 'hpkp', 'hsts', 'http', 'ichigojam', 'icon', 'icuMessageFormat', 'idris', 'iecst', 'ignore', 'inform7', 'ini', 'io', 'j', 'java', 'javadoc', 'javadoclike', 'javascript', 'javastacktrace', 'jexl', 'jolie', 'jq', 'jsExtras', 'jsTemplates', 'jsdoc', 'json', 'json5', 'jsonp', 'jsstacktrace', 'jsx', 'julia', 'keepalived', 'keyman', 'kotlin', 'kumir', 'kusto', 'latex', 'latte', 'less', 'lilypond', 'liquid', 'lisp', 'livescript', 'llvm', 'log', 'lolcode', 'lua', 'magma', 'makefile', 'markdown', 'markupTemplating', 'markup', 'matlab', 'maxscript', 'mel', 'mermaid', 'mizar', 'mongodb', 'monkey', 'moonscript', 'n1ql', 'n4js', 'nand2tetrisHdl', 'naniscript', 'nasm', 'neon', 'nevod', 'nginx', 'nim', 'nix', 'nsis', 'objectivec', 'ocaml', 'opencl', 'openqasm', 'oz', 'parigp', 'parser', 'pascal', 'pascaligo', 'pcaxis', 'peoplecode', 'perl', 'phpExtras', 'php', 'phpdoc', 'plsql', 'powerquery', 'powershell', 'processing', 'prolog', 'promql', 'properties', 'protobuf', 'psl', 'pug', 'puppet', 'pure', 'purebasic', 'purescript', 'python', 'q', 'qml', 'qore', 'qsharp', 'r', 'racket', 'reason', 'regex', 'rego', 'renpy', 'rest', 'rip', 'roboconf', 'robotframework', 'ruby', 'rust', 'sas', 'sass', 'scala', 'scheme', 'scss', 'shellSession', 'smali', 'smalltalk', 'smarty', 'sml', 'solidity', 'solutionFile', 'soy', 'sparql', 'splunkSpl', 'sqf', 'sql', 'squirrel', 'stan', 'stylus', 'swift', 'systemd', 't4Cs', 't4Templating', 't4Vb', 'tap', 'tcl', 'textile', 'toml', 'tremor', 'tsx', 'tt2', 'turtle', 'twig', 'typescript', 'typoscript', 'unrealscript', 'uorazor', 'uri', 'v', 'vala', 'vbnet', 'velocity', 'verilog', 'vhdl', 'vim', 'visualBasic', 'warpscript', 'wasm', 'webIdl', 'wiki', 'wolfram', 'wren', 'xeora', 'xmlDoc', 'xojo', 'xquery', 'yaml', 'yang', 'zig')] [string]$Language = "powershell", [Parameter()] [ValidateSet('coy', 'dark', 'funky', 'okaidia', 'solarizedlight', 'tomorrow', 'twilight', 'prism', 'a11yDark', 'atomDark', 'base16AteliersulphurpoolLight', 'cb', 'coldarkCold', 'coldarkDark', 'coyWithoutShadows', 'darcula', 'dracula', 'duotoneDark', 'duotoneEarth', 'duotoneForest', 'duotoneLight', 'duotoneSea', 'duotoneSpace', 'ghcolors', 'gruvboxDark', 'gruvboxLight', 'holiTheme', 'hopscotch', 'lucario', 'materialDark', 'materialLight', 'materialOceanic', 'nightOwl', 'nord', 'oneDark', 'oneLight', 'pojoaque', 'shadesOfPurple', 'solarizedDarkAtom', 'synthwave84', 'vs', 'vscDarkPlus', 'xonokai', 'zTouch')] [string]$Style = "oneDark", [Parameter()] [Switch]$ShowLineNumbers ) $Styles = @('coy', 'dark', 'funky', 'okaidia', 'solarizedlight', 'tomorrow', 'twilight', 'prism', 'a11yDark', 'atomDark', 'base16AteliersulphurpoolLight', 'cb', 'coldarkCold', 'coldarkDark', 'coyWithoutShadows', 'darcula', 'dracula', 'duotoneDark', 'duotoneEarth', 'duotoneForest', 'duotoneLight', 'duotoneSea', 'duotoneSpace', 'ghcolors', 'gruvboxDark', 'gruvboxLight', 'holiTheme', 'hopscotch', 'lucario', 'materialDark', 'materialLight', 'materialOceanic', 'nightOwl', 'nord', 'oneDark', 'oneLight', 'pojoaque', 'shadesOfPurple', 'solarizedDarkAtom', 'synthwave84', 'vs', 'vscDarkPlus', 'xonokai', 'zTouch') $Languages = @('abap', 'abnf', 'actionscript', 'ada', 'agda', 'al', 'antlr4', 'apacheconf', 'apex', 'apl', 'applescript', 'aql', 'arduino', 'arff', 'asciidoc', 'asm6502', 'asmatmel', 'aspnet', 'autohotkey', 'autoit', 'avisynth', 'avroIdl', 'bash', 'basic', 'batch', 'bbcode', 'bicep', 'birb', 'bison', 'bnf', 'brainfuck', 'brightscript', 'bro', 'bsl', 'c', 'cfscript', 'chaiscript', 'cil', 'clike', 'clojure', 'cmake', 'cobol', 'coffeescript', 'concurnas', 'coq', 'cpp', 'crystal', 'csharp', 'cshtml', 'csp', 'cssExtras', 'css', 'csv', 'cypher', 'd', 'dart', 'dataweave', 'dax', 'dhall', 'diff', 'django', 'dnsZoneFile', 'docker', 'dot', 'ebnf', 'editorconfig', 'eiffel', 'ejs', 'elixir', 'elm', 'erb', 'erlang', 'etlua', 'excelFormula', 'factor', 'falselang', 'firestoreSecurityRules', 'flow', 'fortran', 'fsharp', 'ftl', 'gap', 'gcode', 'gdscript', 'gedcom', 'gherkin', 'git', 'glsl', 'gml', 'gn', 'goModule', 'go', 'graphql', 'groovy', 'haml', 'handlebars', 'haskell', 'haxe', 'hcl', 'hlsl', 'hoon', 'hpkp', 'hsts', 'http', 'ichigojam', 'icon', 'icuMessageFormat', 'idris', 'iecst', 'ignore', 'inform7', 'ini', 'io', 'j', 'java', 'javadoc', 'javadoclike', 'javascript', 'javastacktrace', 'jexl', 'jolie', 'jq', 'jsExtras', 'jsTemplates', 'jsdoc', 'json', 'json5', 'jsonp', 'jsstacktrace', 'jsx', 'julia', 'keepalived', 'keyman', 'kotlin', 'kumir', 'kusto', 'latex', 'latte', 'less', 'lilypond', 'liquid', 'lisp', 'livescript', 'llvm', 'log', 'lolcode', 'lua', 'magma', 'makefile', 'markdown', 'markupTemplating', 'markup', 'matlab', 'maxscript', 'mel', 'mermaid', 'mizar', 'mongodb', 'monkey', 'moonscript', 'n1ql', 'n4js', 'nand2tetrisHdl', 'naniscript', 'nasm', 'neon', 'nevod', 'nginx', 'nim', 'nix', 'nsis', 'objectivec', 'ocaml', 'opencl', 'openqasm', 'oz', 'parigp', 'parser', 'pascal', 'pascaligo', 'pcaxis', 'peoplecode', 'perl', 'phpExtras', 'php', 'phpdoc', 'plsql', 'powerquery', 'powershell', 'processing', 'prolog', 'promql', 'properties', 'protobuf', 'psl', 'pug', 'puppet', 'pure', 'purebasic', 'purescript', 'python', 'q', 'qml', 'qore', 'qsharp', 'r', 'racket', 'reason', 'regex', 'rego', 'renpy', 'rest', 'rip', 'roboconf', 'robotframework', 'ruby', 'rust', 'sas', 'sass', 'scala', 'scheme', 'scss', 'shellSession', 'smali', 'smalltalk', 'smarty', 'sml', 'solidity', 'solutionFile', 'soy', 'sparql', 'splunkSpl', 'sqf', 'sql', 'squirrel', 'stan', 'stylus', 'swift', 'systemd', 't4Cs', 't4Templating', 't4Vb', 'tap', 'tcl', 'textile', 'toml', 'tremor', 'tsx', 'tt2', 'turtle', 'twig', 'typescript', 'typoscript', 'unrealscript', 'uorazor', 'uri', 'v', 'vala', 'vbnet', 'velocity', 'verilog', 'vhdl', 'vim', 'visualBasic', 'warpscript', 'wasm', 'webIdl', 'wiki', 'wolfram', 'wren', 'xeora', 'xmlDoc', 'xojo', 'xquery', 'yaml', 'yang', 'zig') $Style = $styles | Where-Object { $_ -eq $Style } $Language = $Languages | Where-Object { $_ -eq $Language } @{ isPlugin = $true type = "mu-syntax-highlighter" id = $Id code = $code language = $Language style = $style showLineNumbers = $ShowLineNumbers.IsPresent } } function ConvertTo-FlatObject { param( [Parameter(ValueFromPipeline = $true)] $InputObject ) Process { $OutputObject = @{ } if ($null -eq $InputObject) { return } if ($InputObject -is [Hashtable]) { foreach ($key in $InputObject.Keys) { if ($key -and ($key.StartsWith('rendered') -or $key -eq 'rowexpanded')) { $OutputObject[$key] = $InputObject[$key] } else { $Value = $InputObject[$key] if ($Value -is [DateTime]) { $OutputObject[$key] = $Value } else { $OutputObject[$key] = if ($null -ne $Value) { $Value.ToString() } else { "" } } } } [PSCustomObject]$OutputObject } else { $InputObject | Get-Member -MemberType Properties | ForEach-Object { if ($_.Name -and ($_.Name.StartsWith('rendered') -or $_.Name -eq 'rowexpanded')) { $OutputObject[$_.Name] = $InputObject."$($_.Name)" } else { $Value = $InputObject."$($_.Name)" if ($Value -is [DateTime]) { $OutputObject[$_.Name] = $Value } else { $OutputObject[$_.Name] = if ($null -ne $Value) { $Value.ToString() } else { "" } } } } [PSCustomObject]$OutputObject } } } function New-UDTable { <# .SYNOPSIS Creates a table. .DESCRIPTION Creates a table. Tables are used to show both static and dynamic data. You can define columns and data to show within the table. The columns can be used to render custom components based on row data. You can also enable paging, filtering, sorting and even server-side processing. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Title The title to show at the top of the table's card. .PARAMETER Data The data to put into the table. .PARAMETER LoadRows When using dynamic tables, this script block is called. The $Body parameter will contain a hashtable the following options: filters: @() orderBy: string orderDirection: string page: int pageSize: int properties: @() search: string totalCount: int You can use these values to perform server-side processing, like SQL queries, to improve the performance of large grids. After processing the data with these values, output the data via Out-UDTableData. .PARAMETER Columns Defines the columns to show within the table. Use New-UDTableColumn to define these columns. If this parameter isn't specified, the properties of the data that you pass in will become the columns. .PARAMETER Sort Whether sorting is enabled in the table. .PARAMETER Filter Whether filtering is enabled in the table. .PARAMETER Search Whether search is enabled in the table. .PARAMETER Export Whether exporting is enabled within the table. .PARAMETER Icon Sets an icon next to the title. Use New-UDIcon to create the icon. .PARAMETER OnRowSelection A script block to call when a row is selected. $EventData will contain the selected rows. .PARAMETER ShowSort Whether to show sort controls on columns .PARAMETER ShowFilter Whether to show filter controls on columns .PARAMETER ShowSearch Whether to show full table search .PARAMETER Dense Reduces the white-space used within the table. .PARAMETER StickyHeader Makes the header sticky. .PARAMETER PageSize The default page size. .PARAMETER PageSizeOptions An array of available page size options. .PARAMETER ShowSelection Whether to allow selection within the table. .PARAMETER ShowPagination Whether to show pagination controls. .PARAMETER Size The size of the table. Defaults to medium. Valid values are medium and small. .PARAMETER TextOption Customizations to standard text within the table. Use New-UDTextOption to create the text options. .PARAMETER ExportOption An array of export options. .PARAMETER OnExport A script block used to customize how the export is performed. .PARAMETER DisablePageSizeAll Removes the All option from page size options. .PARAMETER DefaultSortDirection The default sort direction. .PARAMETER HideToggleAllRowsSelected Hides the toggle all rows selected button. .PARAMETER DisableMultiSelect Disables multi-select. .PARAMETER DisableSortRemove Removes the sort option for unsorted columns. Columns will always be ascending or descending. .PARAMETER ClassName A CSS class to apply to the table. .PARAMETER PaginationLocation Where to show the pagination controls. Valid values are top, bottom, or both. Defaults to bottom. .PARAMETER AutoRefresh Reloads the table on an interval when -LoadRows is being used. .PARAMETER AutoRefreshInterval The interval to reload data when AutoRefresh is specified. .PARAMETER Language The language. Primarily used for Date and Time filters. .EXAMPLE Creates a static table whether the columns of the table are the properties of the data specified. $Data = @( @{Dessert = 'Frozen yoghurt'; Calories = 159; Fat = 6.0; Carbs = 24; Protein = 4.0} @{Dessert = 'Ice cream sandwich'; Calories = 159; Fat = 6.0; Carbs = 24; Protein = 4.0} @{Dessert = 'Eclair'; Calories = 159; Fat = 6.0; Carbs = 24; Protein = 4.0} @{Dessert = 'Cupcake'; Calories = 159; Fat = 6.0; Carbs = 24; Protein = 4.0} @{Dessert = 'Gingerbread'; Calories = 159; Fat = 6.0; Carbs = 24; Protein = 4.0} ) New-UDTable -Id 'defaultTable' -Data $Data .EXAMPLE Creates a table where there are custom columns defined for that table. $Columns = @( New-UDTableColumn -Property Dessert -Title "A Dessert" New-UDTableColumn -Property Calories -Title Calories New-UDTableColumn -Property Fat -Title Fat New-UDTableColumn -Property Carbs -Title Carbs New-UDTableColumn -Property Protein -Title Protein ) New-UDTable -Id 'customColumnsTable' -Data $Data -Columns $Columns .EXAMPLE Creates a table where the table has custom rendering for one of the columns and an export button. $Columns = @( New-UDTableColumn -Property Dessert -Title Dessert -Render { $Item = $Body | ConvertFrom-Json New-UDButton -Id "btn$($Item.Dessert)" -Text "Click for Dessert!" -OnClick { Show-UDToast -Message $Item.Dessert } } New-UDTableColumn -Property Calories -Title Calories New-UDTableColumn -Property Fat -Title Fat New-UDTableColumn -Property Carbs -Title Carbs New-UDTableColumn -Property Protein -Title Protein ) New-UDTable -Id 'customColumnsTableRender' -Data $Data -Columns $Columns -Sort -Export .EXAMPLE Creates a table within a New-UDDynamic that refreshes automatically on an interval. New-UDDynamic -Content { $DynamicData = @( @{Dessert = 'Frozen yoghurt'; Calories = (Get-Random); Fat = 6.0; Carbs = 24; Protein = 4.0} @{Dessert = 'Ice cream sandwich'; Calories = (Get-Random); Fat = 6.0; Carbs = 24; Protein = 4.0} @{Dessert = 'Eclair'; Calories = (Get-Random); Fat = 6.0; Carbs = 24; Protein = 4.0} @{Dessert = 'Cupcake'; Calories = (Get-Random); Fat = 6.0; Carbs = 24; Protein = 4.0} @{Dessert = 'Gingerbread'; Calories = (Get-Random); Fat = 6.0; Carbs = 24; Protein = 4.0} ) New-UDTable -Id 'dynamicTable' -Data $DynamicData } -AutoRefresh -AutoRefreshInterval 2 .EXAMPLE Creates a table that uses the LoadRows script block to load data dynamically. New-UDTable -Id 'loadDataTable' -Columns $Columns -LoadRows { $Query = $Body | ConvertFrom-Json @( @{Dessert = 'Frozen yoghurt'; Calories = (Get-Random); Fat = 6.0; Carbs = 24; Protein = 4.0} @{Dessert = 'Ice cream sandwich'; Calories = (Get-Random); Fat = 6.0; Carbs = 24; Protein = 4.0} @{Dessert = 'Eclair'; Calories = (Get-Random); Fat = 6.0; Carbs = 24; Protein = 4.0} @{Dessert = 'Cupcake'; Calories = (Get-Random); Fat = 6.0; Carbs = 24; Protein = 4.0} @{Dessert = 'Gingerbread'; Calories = (Get-Random); Fat = 6.0; Carbs = 24; Protein = 4.0} ) | Out-UDTableData -Page 0 -TotalCount 5 -Properties $Query.Properties .NOTES General notes #> [CmdletBinding()] param( [Parameter()] [string]$Id = [Guid]::NewGuid().ToString(), [Parameter()] [string]$Title = "", [Parameter(Mandatory, ParameterSetName = "Static")] [AllowEmptyCollection()] [AllowNull()] [object[]]$Data, [Parameter(Mandatory, ParameterSetName = "Dynamic")] [Alias("LoadData")] [Endpoint]$LoadRows, [Parameter(ParameterSetName = "Static")] [Parameter(Mandatory, ParameterSetName = "Dynamic")] [Hashtable[]]$Columns, [Parameter()] [Endpoint]$OnRowSelection, [Parameter()] [Alias("Sort")] [Switch]$ShowSort, [Parameter()] [Alias("Filter")] [Switch]$ShowFilter, [Parameter()] [Alias("Search")] [Switch]$ShowSearch, [Parameter()] [Switch]$Dense, [Parameter()] [Alias("Export")] [Switch]$ShowExport, [Parameter()] [Switch]$StickyHeader, [Parameter()] [int]$PageSize = 5, [Parameter()] [int[]]$PageSizeOptions = @(), [Parameter()] [ValidateSet("top", "bottom", "both")] [string]$PaginationLocation = "bottom", [Parameter()] [Alias("Select")] [Switch]$ShowSelection, [Parameter()] [Alias("Paging")] [Switch]$ShowPagination, [Parameter()] [ValidateSet("default", "checkbox", "none")] [string]$Padding = "default", [Parameter()] [ValidateSet("small", "medium")] [string]$Size = "medium", [Parameter()] [Hashtable]$TextOption = (New-UDTableTextOption), [Parameter()] [string[]]$ExportOption = @("XLSX", "PDF", "JSON", "CSV"), [Parameter()] [Endpoint]$OnExport, [Parameter()] [Switch]$DisablePageSizeAll, [Parameter()] [ValidateSet('ascending', 'descending')] [string]$DefaultSortDirection = 'ascending', [Parameter()] [Switch]$HideToggleAllRowsSelected, [Parameter()] [Switch]$DisableMultiSelect, [Parameter()] [Switch]$DisableSortRemove, [Parameter()] [Hashtable]$Icon, [Parameter()] [string]$ClassName, [Parameter()] [Switch]$ShowRefresh, [Parameter()] [ScriptBlock]$ToolbarContent, [Parameter()] [ScriptBlock]$OnRowExpand, [int]$MaxHeight, [Parameter(ParameterSetName = "Dynamic")] [Switch]$AutoRefresh, [Parameter(ParameterSetName = "Dynamic")] [int]$AutoRefreshInterval = 10, [Parameter()] [Alias("Locale")] [ValidateSet("en", "de", 'ru', 'fr', 'nl')] [string]$Language = "en", [Parameter()] [Switch]$RemoveCard ) Begin { function getDefaultSortColumn { param( [Parameter()] [object[]]$Columns ) $DefaultSortColumn = $Columns.Where( { $_.DefaultSortColumn }) $DefaultSortColumn.field } } Process { if ($OnExport) { $OnExport.Register($Id + 'Export', $PSCmdlet) } if (($null -eq $Columns) -and ($null -ne $Data)) { $item = $Data | Select-Object -First 1 | ConvertTo-FlatObject if ($item -is [Hashtable]) { $Columns = foreach ($member in $item.Keys) { if ($ShowSearch) { New-UDTableColumn -Property $member -IncludeInSearch } elseif ($ShowExport) { New-UDTableColumn -Property $member -IncludeInExport } elseif ($ShowSearch -and $ShowExport) { New-UDTableColumn -Property $member -IncludeInExport -IncludeInSearch } else { New-UDTableColumn -Property $member } } } else { $Columns = foreach ($member in $item.PSObject.Properties) { if ($ShowSearch) { New-UDTableColumn -Property $member.Name -IncludeInSearch } elseif ($ShowExport) { New-UDTableColumn -Property $member.Name -IncludeInExport } elseif ($ShowSearch -and $ShowExport) { New-UDTableColumn -Property $member.Name -IncludeInExport -IncludeInSearch } else { New-UDTableColumn -Property $member.Name } } } } if ($LoadRows) { $LoadRows.Register($Id, $PSCmdlet, @{ "TableColumns" = $Columns; "OnRowExpand" = $OnRowExpand }) } if ($OnRowSelection) { $OnRowSelection.Register($Id + 'OnRowSelection', $PSCmdlet) } if ($Columns) { $RenderedColumns = $Columns.Where( { $null -ne $_.Render }) if ($Data.Count -ge 1) { foreach ($Item in $Data) { $vars = [System.Collections.Generic.List[PSVariable]]::new() $null = $vars.Add((New-Variable -Name EventData -Value $Item -Force -PassThru)) foreach ($Column in $RenderedColumns) { $RenderedData = $Column.Render.InvokeWithContext(@{}, $vars) if (-not $RenderedData) { $RenderedData = "" } if ($Item -isnot [hashtable]) { Add-Member -InputObject $Item -MemberType NoteProperty -Name "rendered$($Column.field)" -Value $RenderedData -Force } else { $Item["rendered$($Column.field)"] = $RenderedData } } } } } if ($OnRowExpand -and $Data.Count -ge 1) { foreach ($Item in $Data) { $vars = [System.Collections.Generic.List[PSVariable]]::new() $null = $vars.Add((New-Variable -Name EventData -Value $Item -Force -PassThru)) $RenderedData = $OnRowExpand.InvokeWithContext(@{}, $vars) if (-not $RenderedData) { $RenderedData = "" } if ($Item -isnot [hashtable]) { Add-Member -InputObject $Item -MemberType NoteProperty -Name "rowexpanded" -Value $RenderedData -Force } else { $Item["rowexpanded"] = $RenderedData } } } } End { $defaultSortColumn = getDefaultSortColumn($Columns) if ($defaultSortColumn -and -not $DefaultSortDirection) { $DefaultSortDirection = 'ascending' } if ($Data) { $Data = [Array]($Data | ConvertTo-FlatObject) if ($Data -isnot [Array]) { $Data = @($Data) } } else { $Data = @() } @{ id = $Id assetId = $MUAssetId isPlugin = $true type = "mu-table" title = $Title columns = $Columns defaultSortColumn = $defaultSortColumn data = $Data showSort = $ShowSort.IsPresent showFilter = $ShowFilter.IsPresent showSearch = $ShowSearch.IsPresent showExport = $ShowExport.IsPresent showSelection = $ShowSelection.IsPresent showPagination = $ShowPagination.IsPresent stickyHeader = $StickyHeader.IsPresent isDense = $Dense.IsPresent loadData = $LoadRows onRowSelection = $OnRowSelection userPageSize = $PageSize userPageSizeOptions = if ($PageSizeOptions.Count -gt 0) { $PageSizeOptions }else { @(5, 10, 20, 50) } padding = $Padding.ToLower() size = $Size textOption = $TextOption exportOption = $ExportOption | ForEach-Object { $_.ToUpper() } onExport = $OnExport disablePageSizeAll = $DisablePageSizeAll.IsPresent defaultSortDirection = $DefaultSortDirection.ToLower() hideToggleAllRowsSelected = $HideToggleAllRowsSelected.IsPresent disableMultiSelect = $DisableMultiSelect.IsPresent disableSortRemove = $DisableSortRemove.IsPresent icon = $Icon className = $ClassName paginationLocation = $PaginationLocation.ToLower() showRefresh = $ShowRefresh.IsPresent toolbarContent = if ($ToolbarContent) { & $ToolbarContent } else { $null } maxHeight = if ($MaxHeight -eq 0) { $null } else { $MaxHeight } autoRefresh = $AutoRefresh.IsPresent autoRefreshInterval = $AutoRefreshInterval locale = $Language.ToLower() removeCard = $RemoveCard.IsPresent } } } function New-UDTableTextOption { <# .SYNOPSIS Creates a hashtable to set the text options of a table. .DESCRIPTION Creates a hashtable to set the text options of a table. .PARAMETER ExportAllCsv Overrides the Export All to CSV text. .PARAMETER ExportCurrentViewCsv Overrides the Export Current View as CSV text. .PARAMETER ExportAllXLSX Overrides the Export All to XLSX text. .PARAMETER ExportCurrentViewXLSX Overrides the Export Current View as XLSX text. .PARAMETER ExportAllPDF Overrides the Export All to PDF text. .PARAMETER ExportCurrentViewPDF Overrides the Export Current View as PDF text. .PARAMETER ExportAllJson Overrides the Export All to JSON text. .PARAMETER ExportCurrentViewJson Overrides the Export Current View as JSON text. .PARAMETER Search Overrides the Search text. You can use {0} to use as a place holder for the number of rows. .PARAMETER FilterSearch Overrides the column filter text. You can use {0} to use as a place holder for the number of rows. .EXAMPLE $Options = New-UDTableTextOption -Search "Filter all the rows" New-UDTable -Data $Data -TextOption $Ootions .NOTES General notes #> param( [Parameter()] [string]$ExportAllCsv = "Export all as CSV", [Parameter()] [string]$ExportCurrentViewCsv = "Export Current View as CSV", [Parameter()] [string]$ExportAllXLSX = "Export all as XLSX", [Parameter()] [string]$ExportCurrentViewXLSX = "Export Current View as XLSX", [Parameter()] [string]$ExportAllPDF = "Export all as PDF", [Parameter()] [string]$ExportCurrentViewPDF = "Export Current View as PDF", [Parameter()] [string]$ExportAllJson = "Export all as JSON", [Parameter()] [string]$ExportCurrentViewJson = "Export Current View as JSON", [Parameter()] [string]$ExportFileName = "File Name", [Parameter()] [string]$Search = "Search {0} records...", [Parameter()] [string]$FilterSearch = "Search {0} records...", [Parameter()] [string]$Export = "", [Parameter()] [string]$FilterDate = "Filter Date" ) @{ exportAllCsv = $ExportAllCsv exportCurrentViewCsv = $ExportCurrentViewCsv exportAllXlsx = $ExportAllXLSX exportCurrentViewXlsx = $ExportCurrentViewXLSX exportAllPdf = $ExportAllPDF exportCurrentViewPdf = $ExportCurrentViewPDF exportAllJson = $ExportAllJson exportCurrentViewJson = $ExportCurrentViewJson exportFileName = $ExportFileName search = $Search filterSearch = $FilterSearch export = $Export filterDate = $FilterDate } } function New-UDTableColumn { <# .SYNOPSIS Defines a table column. .DESCRIPTION Defines a table column. Use this cmdlet in conjunction with New-UDTable's -Column property. Table columns can be used to control many aspects of the columns within a table. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Property The property to select from the data. .PARAMETER Title The title of the column to show at the top of the table. .PARAMETER Render How to render this table. Use this parameter instead of property to render custom content within a column. The $Body variable will contain the current row being rendered. .PARAMETER ShowSort Whether this column supports sorting. .PARAMETER ShowFilter Whether this column supports filtering. .PARAMETER Search Whether this column supports searching. .PARAMETER Hidden Includes a column in the table but does not show it. This is useful for columns that are used for filtering and exporting but are not meant to be displayed in the table. .PARAMETER FilterType The type of filter to use with this column. Valid values are "text", "select", "fuzzy", "slider", "range", "date", "number", 'autocomplete' .PARAMETER Style A hashtable of style attributes to apply to the column. .PARAMETER Width The width of this column in pixels. .PARAMETER IncludeInSearch Whether to include this column in the search. .PARAMETER IncludeInExport Whether to include this column in the export. .PARAMETER DefaultSortColumn Sets this column as the default sort column. .PARAMETER Align The alignment of the column. Supported values are 'center', 'inherit', 'justify', 'left', 'right'. .PARAMETER Truncate Whether to truncate the text in this column. A -Width is required to use truncate. .PARAMETER SortType Whether to sort this column as a string or datetime. .PARAMETER Options The options to use for a select filter. .EXAMPLE See New-UDTable for examples. #> param( [Parameter()] [string]$Id = [Guid]::NewGuid().ToString(), [Parameter(Mandatory)] [string]$Property, [Parameter()] [string]$Title, [Parameter()] [ScriptBlock]$Render, [Parameter()] [Alias("Sort")] [switch]$ShowSort, [Parameter()] [Alias("Filter")] [switch]$ShowFilter, [Parameter()] [ValidateSet("text", "select", "fuzzy", "slider", "range", "date", "number", 'autocomplete')] [string]$FilterType = "text", [Parameter()] [hashtable]$Style = @{ }, [Parameter()] [int]$Width, [Parameter()] [int]$MinWidth, [Parameter()] [Alias("Search")] [switch]$IncludeInSearch, [Parameter()] [Alias("Export")] [switch]$IncludeInExport, [Parameter()] [switch]$DefaultSortColumn, [Parameter()] [ValidateSet('center', 'inherit', 'justify', 'left', 'right')] [string]$Align = 'inherit', [Parameter()] [Switch]$Truncate, [Parameter()] [ValidateSet('basic', 'datetime', 'alphanumeric')] [string]$SortType = 'alphanumeric', [Parameter()] [Switch]$Hidden, [Parameter()] [string[]]$Options ) if ($null -eq $Title -or $Title -eq '') { $Title = $Property } if ($Width -gt 0) { $style["maxWidth"] = $width $style["width"] = $width } if ($MinWidth -gt 0) { $style["minWidth"] = $width } if ($Truncate) { $style["whiteSpace"] = "nowrap" $style["overflow"] = "hidden" $style["textOverflow"] = "ellipsis" } @{ id = $Id field = $Property.ToLower() title = $Title showSort = $ShowSort.IsPresent showFilter = $ShowFilter.IsPresent filterType = $FilterType.ToLower() includeInSearch = $IncludeInSearch.IsPresent includeInExport = $IncludeInExport.IsPresent isDefaultSortColumn = $DefaultSortColumn.IsPresent render = $Render width = $Width align = $Align style = $Style sortType = $SortType hidden = $Hidden.IsPresent options = $Options } } function Out-UDTableData { <# .SYNOPSIS Formats data to be output from New-UDTable's -LoadRows script block. .DESCRIPTION Formats data to be output from New-UDTable's -LoadRows script block. .PARAMETER Data The data to return from LoadRows. .PARAMETER Page The current page we are on within the table. .PARAMETER TotalCount The total count of items within the data set. .PARAMETER Properties The properties that are currently passed from the table. You can return the array from the $EventData.Properties array. .EXAMPLE See New-UDTable for examples. #> param( [Parameter(ValueFromPipeline = $true, Mandatory)] [object]$Data, [Parameter(Mandatory)] [int]$Page, [Parameter(Mandatory)] [int]$TotalCount, [Parameter(Mandatory)] [Alias("Property")] [string[]]$Properties ) Begin { $DataPage = @{ data = @() page = $Page totalCount = $TotalCount } } Process { $item = @{ } foreach ($property in $Properties) { $RenderedColumn = $TableColumns.Where( { $_.field -eq $property -and $_.Render }) if ($RenderedColumn) { Set-Variable -Name 'EventData' -Value $Data $Render = $RenderedColumn.Render.GetNewClosure() $item["rendered" + $property] = $Render.Invoke() } $item[$property] = $Data.$property } if ($OnRowExpand) { Set-Variable -Name 'EventData' -Value $Item $Render = $OnRowExpand.GetNewClosure() $RenderedData = $Render.Invoke() if (-not $RenderedData) { $RenderedData = "" } if ($Item -isnot [hashtable]) { Add-Member -InputObject $Item -MemberType NoteProperty -Name "rowexpanded" -Value $RenderedData -Force } else { $Item["rowexpanded"] = $RenderedData } } $DataPage.data += $item } End { if ($DataPage.data) { $DataPage.data = [Array]($DataPage.data | ConvertTo-FlatObject) $DataPage } } } function New-UDTabs { <# .SYNOPSIS Creates a new set of tabs. .DESCRIPTION Creates a new set of tabs. Tabs can be used to show lots of content on a single page. .PARAMETER Tabs The tabs to put within this container. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER RenderOnActive Deprecated .PARAMETER Orientation The orientation of the tabs. Valid values are horizontal and vertical. .PARAMETER Variant The variantion of tabs. Valid values are standard, fullWidth and scrollable. .PARAMETER ScrollButtons The behavior of the scrollbuttons. Valid values are on, off, auto and desktop. On will enable scroll buttons no matter what. off will disable all scroll buttons. Auto will show scrollbuttons when necessary. Desktop will show scrollbuttons on medium and large screens. .EXAMPLE Creates a basic set of tabs. New-UDTabs -Tabs { New-UDTab -Text "Tab1" -Id 'Tab1' -Content { New-UDElement -Tag div -Id 'tab1Content' -Content { "Tab1Content"} } New-UDTab -Text "Tab2" -Id 'Tab2' -Content { New-UDElement -Tag div -Id 'tab2Content' -Content { "Tab2Content"} } New-UDTab -Text "Tab3" -Id 'Tab3' -Content { New-UDElement -Tag div -Id 'tab3Content' -Content { "Tab3Content"} } } .EXAMPLE Creates a set of tabs that only render when they are clicked. New-UDTabs -Id 'DynamicTabs' -Tabs { New-UDTab -Text "Tab1" -Id 'DynamicTab1' -Dynamic -Content { New-UDElement -Tag div -Id 'DynamicTab1Content' -Content { Get-Date } } New-UDTab -Text "Tab2" -Id 'DynamicTab2' -Dynamic -Content { New-UDElement -Tag div -Id 'DynamicTab2Content' -Content { Get-Date } } New-UDTab -Text "Tab3" -Id 'DynamicTab2' -Dynamic -Content { New-UDElement -Tag div -Id 'DynamicTab3Content' -Content { Get-Date } } } .EXAMPLE Creates a vertical set of tabs. New-UDTabs -Id 'verticalTabs' -Orientation 'vertical' -Tabs { New-UDTab -Text "Tab1" -Content { New-UDElement -Tag div -Content { Get-Date } } New-UDTab -Text "Tab2" -Content { New-UDElement -Tag div -Content { Get-Date } } New-UDTab -Text "Tab3" -Content { New-UDElement -Tag div -Content { Get-Date } } } #> [CmdletBinding()] param( [Parameter(Mandatory)] [ScriptBlock]$Tabs, [Parameter()] [string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter()] [Switch]$RenderOnActive, [Parameter()] [ValidateSet('horizontal', 'vertical')] [string]$Orientation = "horizontal", [Parameter()] [ValidateSet('fullWidth', 'scrollable', 'standard')] [string]$Variant = 'standard', [Parameter()] [ValidateSet('on', 'off', 'auto', 'desktop')] [string]$ScrollButtons = 'auto', [Parameter()] [switch]$Centered, [Parameter()] [string]$ClassName ) End { if ($RenderOnActive) { Write-Warning "RenderOnActive is deprecated and will be removed in 4.0" } $c = New-UDErrorBoundary -Content $Tabs if ($Variant -eq 'fullWidth') { $Variant = 'fullWidth' } else { $Variant = $Variant.ToLower() } @{ isPlugin = $true assetId = $MUAssetId type = "mu-tabs" tabs = $c id = $id orientation = $Orientation variant = $Variant scrollButtons = $ScrollButtons.ToLower() centered = $Centered.IsPresent className = $ClassName } } } function New-UDTab { <# .SYNOPSIS Creates a new tab. .DESCRIPTION Creates a new tab. Use New-UDTabs as a container for tabs. .PARAMETER Text The text to display for this tab. .PARAMETER Content The content to display when the tab is selected. .PARAMETER Id The ID of this component. .PARAMETER Dynamic Whether this tab is dynamic. Dynamic tabs won't render until they are displayed. .PARAMETER Icon The Icon to display within the tab header. .PARAMETER Disabled Whether this tab is disabled. #> [CmdletBinding()] param( [Parameter()] [string]$Text, [Parameter(Mandatory)] [Endpoint]$Content, [Parameter()] [string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter()] [switch]$Dynamic, [Parameter()] [object]$Icon, [Parameter()] [switch]$Disabled ) End { if ($null -ne $Content -and $Dynamic) { $Content.Register($Id, $PSCmdlet) } else { $c = New-UDErrorBoundary -Content $Content.ScriptBlock } @{ isPlugin = $true assetId = $MUAssetId type = "mu-tab" label = $Text icon = $Icon content = $c id = $Id dynamic = $Dynamic.IsPresent disabled = $Disabled.IsPresent render = if ($Dynamic.IsPresent) { $Content } else { $null } } } } function New-UDTextbox { <# .SYNOPSIS Creates a textbox. .DESCRIPTION Creates a textbox. Textboxes can be used by themselves or within a New-UDForm. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Label A label to show above this textbox. .PARAMETER Placeholder A placeholder to place within the text box. .PARAMETER Value The current value of the textbox. .PARAMETER Type The type of textbox. This can be values such as text, password or email. .PARAMETER Disabled Whether this textbox is disabled. .PARAMETER Icon The icon to show next to the textbox. Use New-UDIcon to create an icon. .PARAMETER Autofocus Whether to autofocus this textbox. .PARAMETER Multiline Creates a multiline textbox .PARAMETER Shrink Whether to shrink label by default. .PARAMETER Rows The number of rows in a multiline textbox. .PARAMETER RowsMax The maximum number of rows in a multiline textbox. .PARAMETER FullWidth Whether to make this textbox take up the full width of the parent control. .PARAMETER Mask The mask to apply over a textbox. .PARAMETER Variant The variant of textbox. Valid values are "filled", "outlined", "standard" .PARAMETER ClassName A CSS class to apply to the textbox. .EXAMPLE Creates a standard textbox. New-UDTextbox -Label 'text' -Id 'txtLabel' .EXAMPLE Creates a password textbox. New-UDTextbox -Label 'password' -Id 'txtPassword' -Type 'password' #> param( [Parameter()] [String]$Id = ([Guid]::NewGuid()), [Parameter()] [string]$Label, [Parameter()] [string]$Placeholder, [Parameter()] [string]$Value, [Parameter()] [ValidateSet('text', 'password', 'email', 'number', 'time', 'datetime-local', 'date', 'color', 'month', 'week')] [String]$Type = 'text', [Parameter()] [Switch]$Disabled, [Parameter()] $Icon, [Parameter()] [Switch]$Autofocus, [Parameter()] [Switch]$Multiline, [Parameter()] [int]$Rows = -1, [Parameter()] [int]$RowsMax = 9999, [Parameter()] [Switch]$FullWidth, [Parameter()] [string]$Mask, [Parameter()] [switch]$Unmask, [Parameter()] [ValidateSet("filled", "outlined", "standard")] [string]$Variant = "standard", [Parameter()] [string]$ClassName, [Parameter()] [Endpoint]$OnEnter, [Parameter()] [Endpoint]$OnBlur, [Parameter()] [Switch]$Shrink, [Parameter()] [Endpoint]$OnValidate ) if ($OnValidate) { $OnValidate.Register($Id + "onBlur", $PSCmdlet) } if ($OnEnter) { $OnEnter.Register($Id + "onEnter", $PSCmdlet) } if ($OnBlur) { $OnBlur.Register($Id + 'onBlur', $PSCmdlet) } @{ id = $id assetId = $MUAssetId isPlugin = $true type = "mu-textbox" label = $Label placeholder = $placeholder value = $value textType = $type.ToLower() disabled = $Disabled.IsPresent autoFocus = $AutoFocus.IsPresent icon = $icon multiline = $Multiline.IsPresent rows = if ($Rows -eq -1) { $null } else { $Rows } maxRows = $RowsMax fullWidth = $FullWidth.IsPresent mask = $Mask unmask = $Unmask.IsPresent variant = $Variant.ToLower() className = $ClassName onEnter = $OnEnter onBlur = $OnBlur shrink = $Shrink.IsPresent onValidate = $OnValidate valid = $true } } $AntDesign = @{ light = @{ palette = @{ text = @{ disabled = "rgba(0, 0, 0, 0.50)" } primary = @{ light = '#69696a' main = '#1890ff' dark = '#1e1e1f' } secondary = @{ light = '#1890ff' main = '#1890ff' dark = '#e62958' } warning = @{ main = '#ffc071' dark = '#ffb25e' } error = @{ xLight = '#ffebee' main = '#f44336' dark = '#d32f2f' } success = @{ xLight = '#e8f5e9' main = '#4caf50' dark = '#388e3c' } background = @{ default = "#f0f2f5" } } typography = @{ fontFamily = "-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,'Helvetica Neue',Arial,'Noto Sans',sans-serif,'Apple Color Emoji','Segoe UI Emoji','Segoe UI Symbol','Noto Color Emoji'" body1 = @{ fontSize = 14 } h6 = @{ fontSize = 14 fontWeight = 400 } } globalStyle = " ::-webkit-scrollbar { width: 10px; } ::-webkit-scrollbar-track { background: #f1f1f1; } ::-webkit-scrollbar-thumb { background: #cccccc; } ::-webkit-scrollbar-thumb:hover { background: #888; } " overrides = @{ MuiAlert = @{ root = @{ borderRadius = '2px' padding = '8px 15px' marginBottom = '16px' } standardError = @{ border = '1px #ffccc7 solid' } standardInfo = @{ border = '1px #91d5ff solid' } standardSuccess = @{ border = '1px #b7eb8f solid' } standardWarning = @{ border = '1px #ffe58f solid' } } MuiAppBar = @{ root = @{ boxShadow = 'none' } colorPrimary = @{ color = '#000' backgroundColor = '#fff' } } MuiButton = @{ root = @{ borderRadius = 0 boxShadow = 'none' textTransform = 'none' '&:hover' = @{ backgroundColor = '#40a9ff' borderColor = '#40a9ff' color = '#fff' boxShadow = 'none' } } contained = @{ color = "#fff" lineHeight = 1.5715 fontWeight = 400 backgroundColor = "#1890ff" borderColor = "#1890ff" transition = "all .3s cubic-bezier(.645,.045,.355,1)" } } MuiCheckbox = @{ root = @{ color = 'rgb(24, 144, 255)' fontWeight = 100 fontSize = '1.1rem' } } MuiCollapse = @{ wrapperInner = @{ backgroundColor = "rgb(250, 250, 250)" } } MuiDataGrid = @{ cell = @{ borderBottom = '1px solid rgb(250, 250, 250)' } columnHeaders = @{ backgroundColor = 'rgb(250, 250, 250)' } root = @{ border = '0px' borderRadius = '0' } } MuiDrawer = @{ paper = @{ border = 'none' } paperAnchorDockedLeft = @{ borderRight = $null } } MuiFormControl = @{ root = @{ #marginTop = '10px' } } MuiExpansionPanel = @{ rounded = @{ "&:first-child" = @{ borderTopLeftRadius = 0 borderTopRightRadius = 0 } "&:last-child" = @{ borderBottomLeftRadius = 0 borderBottomRightRadius = 0 } } } MuiIconButton = @{ root = @{ borderRadius = 0 fontSize = 14 padding = "4px 12px" } } MuiInput = @{ root = @{ lineHeight = 1.5715 "&::before" = @{ border = '0px !important' } "&::after" = @{ border = '0px !important' } } } MuiInputBase = @{ input = @{ border = '1px solid #d9d9d9' borderRadius = '2px' padding = '4px 11px' color = "rgba(0,0,0,.85)" lineHeight = 1.5715 fontSize = 14 "&:hover" = @{ borderColor = "#40a9ff" } "&:focus" = @{ borderColor = '#40a9ff' boxShadow = "0 0 0 2px rgb(24 144 255 / 20%)" } } } MuiInputLabel = @{ root = @{ paddingLeft = '14px' } shrink = @{ transform = 'translate(-10px, -1.5px) scale(0.75)' } outlined = @{ paddingLeft = '0px' transform = 'translate(0, -20px) scale(0.75)' } } MuiListItem = @{ root = @{ transition = "opacity .3s cubic-bezier(.645,.045,.355,1),width .3s cubic-bezier(.645,.045,.355,1),color .3s" cursor = 'pointer' "&:hover" = @{ color = '#1890ff !important' } "&.Mui-selected" = @{ backgroundColor = '#e6f7ff' color = '#1890ff' borderRight = '2px solid #1890ff' } } button = @{ "&:hover" = @{ color = '#1890ff' backgroundColor = "#fff" } } } MuiListItemIcon = @{ root = @{ minWidth = '25px' "&:hover" = @{ color = '#1890ff' } } } MuiListItemText = @{ multiline = @{ marginTop = 0 marginBottom = 0 } } MuiOutlinedInput = @{ root = @{ borderRadius = 0 } input = @{ paddingTop = '4px' paddingBottom = '4px' border = '0px' } "&:focus" = @{ border = '0px' } } MuiPaper = @{ root = @{ boxShadow = 'none' } rounded = @{ borderRadius = 0 } elevation1 = @{ boxShadow = '0px 3px 3px -2px rgb(0 0 0 / 20%), 0px 3px 4px 0px rgb(0 0 0 / 14%), 0px 1px 8px 0px rgb(0 0 0 / 12%)' } elevation2 = @{ boxShadow = '0px 3px 3px -2px rgb(0 0 0 / 20%), 0px 3px 4px 0px rgb(0 0 0 / 14%), 0px 1px 8px 0px rgb(0 0 0 / 12%)' } elevation3 = @{ boxShadow = '0px 3px 3px -2px rgb(0 0 0 / 20%), 0px 3px 4px 0px rgb(0 0 0 / 14%), 0px 1px 8px 0px rgb(0 0 0 / 12%)' } elevation4 = @{ boxShadow = '0px 3px 3px -2px rgb(0 0 0 / 20%), 0px 3px 4px 0px rgb(0 0 0 / 14%), 0px 1px 8px 0px rgb(0 0 0 / 12%)' } elevation5 = @{ boxShadow = '0px 3px 3px -2px rgb(0 0 0 / 20%), 0px 3px 4px 0px rgb(0 0 0 / 14%), 0px 1px 8px 0px rgb(0 0 0 / 12%)' } } MuiSvgIcon = @{ colorPrimary = @{ color = "#000" } } MuiSwitch = @{ root = @{ height = "40px" } thumb = @{ width = "12px" height = "12px" } track = @{ borderRadius = "9px" } switchBase = @{ top = "2px" left = "2px" padding = '12px' '&.Mui-checked' = @{ transform = 'translateX(18px)' } '&.Mui-checked+.MuiSwitch-track' = @{ backgroundColor = '#177ddc' opacity = '1' } } } MuiTab = @{ root = @{ minHeight = 0 textTransform = 'none' } labelIcon = @{ minHeight = 0 } } } } dark = @{ palette = @{ text = @{ primary = 'rgba(255, 255, 255, 0.85)' disabled = "rgba(255, 255, 255, 0.38)" secondary = "rgba(255, 255, 255, 0.38)" } primary = @{ main = 'rgb(31, 31, 31)' } warning = @{ main = '#ffc071' dark = '#ffb25e' } error = @{ xLight = '#ffebee' main = '#f44336' dark = '#d32f2f' } success = @{ xLight = '#e8f5e9' main = '#4caf50' dark = '#388e3c' } background = @{ default = "#000" } } typography = @{ fontFamily = "-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,'Helvetica Neue',Arial,'Noto Sans',sans-serif,'Apple Color Emoji','Segoe UI Emoji','Segoe UI Symbol','Noto Color Emoji'" body1 = @{ fontSize = 14 } h6 = @{ fontSize = 14 fontWeight = 400 } } globalStyle = " ::-webkit-scrollbar { width: 10px; } ::-webkit-scrollbar-track { background: rgb(31, 31, 31); } ::-webkit-scrollbar-thumb { background: #c4c4c4; } ::-webkit-scrollbar-thumb:hover { background: #888; } option { background: rgb(31, 31, 31) !important; } " overrides = @{ MuiAccordionSummary = @{ expandIconWrapper = @{ color = "#fff" } } MuiAlert = @{ root = @{ color = 'rgba(255, 255, 255, 0.85)' borderRadius = '2px' padding = '8px 15px' marginBottom = '16px' } standardError = @{ border = '1px solid #58181c' backgroundColor = '#2a1215' } standardInfo = @{ border = '1px solid #153450' backgroundColor = '#111b26' } standardSuccess = @{ border = '1px solid #274916' backgroundColor = '#162312' } standardWarning = @{ border = '1px #594214 solid' backgroundColor = '#2b2111' } } MuiAppBar = @{ root = @{ boxShadow = 'none' } } MuiButton = @{ root = @{ color = "#fff" '&.Mui-disabled' = @{ color = 'rgba(255, 255, 255, 0.50);' } } contained = @{ color = "#fff" lineHeight = 1.5715 fontWeight = 400 backgroundColor = "#1890ff" borderColor = "#1890ff" borderRadius = 0 boxShadow = $null transition = "all .3s cubic-bezier(.645,.045,.355,1)" textTransform = 'none' '&:hover' = @{ backgroundColor = '#40a9ff' borderColor = '#40a9ff' color = '#fff' boxShadow = $null } } outlined = @{ borderRadius = 0 border = '1px solid #434343' '&:hover' = @{ borderColor = '#165996' color = '#165996' } } } MuiCheckbox = @{ root = @{ color = 'rgb(24, 144, 255)' fontWeight = 100 '&.Mui-checked' = @{ color = 'rgb(24, 144, 255)' } } svg = @{ fontSize = '1.1rem !important' } } MuiChip = @{ root = @{ color = '#3c9ae8' borderColor = '#153956' background = '#111d2c' borderRadius = '2px' } } MuiCollapse = @{ wrapperInner = @{ backgroundColor = "rgb(20,20,20)" } } MuiDataGrid = @{ cell = @{ borderBottom = '1px solid #1d1d1d' } columnHeaders = @{ backgroundColor = '#1d1d1d' } root = @{ border = '0px' borderRadius = '0' backgroundColor = '#141414' } paper = @{ backgroundColor = "rgb(31, 31, 31)" } } MuiDrawer = @{ paper = @{ color = "rgba(255, 255, 255, 0.65);" } paperAnchorDockedLeft = @{ borderRight = 'none' } } MuiExpansionPanel = @{ rounded = @{ "&:first-child" = @{ borderTopLeftRadius = 0 borderTopRightRadius = 0 } "&:last-child" = @{ borderBottomLeftRadius = 0 borderBottomRightRadius = 0 } } } MuiFormControl = @{ root = @{ #marginTop = '10px' } } MuiLink = @{ root = @{ color = 'rgba(255, 255, 255, 0.85)' } } MuiIconButton = @{ root = @{ borderRadius = 0 fontSize = 14 padding = "4px 12px" color = 'rgba(255, 255, 255, 0.85)' '&.Mui-disabled' = @{ color = 'rgba(255, 255, 255, 0.25)' } } } MuiInput = @{ root = @{ '&::before' = @{ borderBottom = '0px' } "&::after" = @{ border = '0px !important' } border = '1px solid #d9d9d9' lineHeight = 1.5715 } input = @{ border = '0px' } } MuiInputAdornment = @{ root = @{ marginLeft = '10px' color = '#d9d9d9' } } MuiInputBase = @{ input = @{ border = '1px solid #d9d9d9' borderRadius = '2px' padding = '4px 11px' color = "#fff" lineHeight = 1.5715 fontSize = 14 "&:hover" = @{ borderColor = "#40a9ff" } "&:focus" = @{ borderColor = '#40a9ff' boxShadow = "0 0 0 2px rgb(24 144 255 / 20%)" } } } MuiInputLabel = @{ root = @{ color = "#fff" paddingLeft = '14px' "&.Mui-focused" = @{ color = "#d9d9d9" } } shrink = @{ color = "#fff" transform = 'translate(-10px, -1.5px) scale(0.75)' } outlined = @{ paddingLeft = '0px' transform = 'translate(0, -20px) scale(0.75)' } } MuiListItem = @{ root = @{ cursor = 'pointer' "&.Mui-selected" = @{ backgroundColor = '#177ddc' color = '#fff' } } } MuiListItemIcon = @{ root = @{ minWidth = '25px' color = "#fff" "&:hover" = @{ color = '#fff' } } } MuiListItemText = @{ secondary = @{ #color = "rgba(255, 255, 255, 0.3)" } multiline = @{ marginTop = 0 marginBottom = 0 } } MuiNativeSelect = @{ icon = @{ color = 'white' } } MuiOutlinedInput = @{ root = @{ borderRadius = 0 border = '1px solid #d9d9d9' } input = @{ paddingTop = '4px' paddingBottom = '4px' border = '0px' } "&:focus" = @{ border = '0px' } } MuiPaper = @{ root = @{ color = '#fff' backgroundColor = 'rgb(31, 31, 31)' boxShadow = 'none' } rounded = @{ borderRadius = 0 } elevation1 = @{ boxShadow = '0px 3px 3px -2px rgb(0 0 0 / 20%), 0px 3px 4px 0px rgb(0 0 0 / 14%), 0px 1px 8px 0px rgb(0 0 0 / 12%)' } elevation2 = @{ boxShadow = '0px 3px 3px -2px rgb(0 0 0 / 20%), 0px 3px 4px 0px rgb(0 0 0 / 14%), 0px 1px 8px 0px rgb(0 0 0 / 12%)' } elevation3 = @{ boxShadow = '0px 3px 3px -2px rgb(0 0 0 / 20%), 0px 3px 4px 0px rgb(0 0 0 / 14%), 0px 1px 8px 0px rgb(0 0 0 / 12%)' } elevation4 = @{ boxShadow = '0px 3px 3px -2px rgb(0 0 0 / 20%), 0px 3px 4px 0px rgb(0 0 0 / 14%), 0px 1px 8px 0px rgb(0 0 0 / 12%)' } elevation5 = @{ boxShadow = '0px 3px 3px -2px rgb(0 0 0 / 20%), 0px 3px 4px 0px rgb(0 0 0 / 14%), 0px 1px 8px 0px rgb(0 0 0 / 12%)' } } MuiRadio = @{ root = @{ '&.Mui-checked' = @{ color = '#177ddc' } } } MuiPickersDay = @{ root = @{ backgroundColor = 'rgb(31, 31, 31)' } } MuiSelect = @{ root = @{ border = '1px solid #434343' borderRadius = '1px' } iconStandard = @{ color = "#fff" } } MuiSlider = @{ root = @{ color = "#40a9ff" } } MuiStepIcon = @{ root = @{ '&.Mui-active' = @{ color = "#1890ff" } } } MuiSwitch = @{ root = @{ height = "40px" } thumb = @{ width = "12px !important" height = "12px !important" } track = @{ opacity = "1 !important"; backgroundColor = '#177ddc !important' borderRadius = "9px !important" height = '16px' } switchBase = @{ top = "2px !important" left = "2px !important" padding = '12px !important' '&.Mui-checked' = @{ transform = 'translateX(18px) !important' } } } MuiRating = @{ icon = @{ color = "#faaf00" } } MuiSvgIcon = @{ colorPrimary = @{ color = "rgba(255, 255, 255, 0.65)" } } MuiTab = @{ root = @{ minHeight = 0 textTransform = 'none' color = '#fff' '&.Mui-selected' = @{ "color " = "#177ddc" } } labelIcon = @{ minHeight = 0 } } } } } $Paperbase = @{ palette = @{ primary = @{ light = '#63ccff' main = '#009be5' dark = '#006db3' } } typography = @{ h5 = @{ fontWeight = 500 fontSize = 26 letterSpacing = 0.5 } } shape = @{ borderRadius = 8 } mixins = @{ toolbar = @{ minHeight = 48 } } overrides = @{ MuiDrawer = @{ paper = @{ backgroundColor = '#081627' } } MuiButton = @{ label = @{ textTransform = 'none' } contained = @{ boxShadow = 'none' '&:active' = @{ boxShadow = 'none' } } } MuiTabs = @{ root = @{ marginLeft = 1 } indicator = @{ height = 3 borderTopLeftRadius = 3 borderTopRightRadius = 3 backgroundColor = '#000' } } MuiTab = @{ root = @{ textTransform = 'none' margin = '0 16px' minWidth = 0 padding = 0 } } MuiIconButton = @{ root = @{ padding = 1 } } MuiTooltip = @{ tooltip = @{ borderRadius = 4 } } MuiDivider = @{ root = @{ backgroundColor = 'rgb(255,255,255,0.15)' } } MuiListItemButton = @{ root = @{ '&.Mui-selected' = @{ color = '#4fc3f7' } } } MuiListItemText = @{ primary = @{ color = 'rgba(255, 255, 255, 0.7) ' fontSize = 14 fontWeight = 500 } } MuiListItemIcon = @{ root = @{ color = 'rgba(255, 255, 255, 0.7) ' minWidth = 'auto' marginRight = 2 '& svg' = @{ fontSize = 20 } } } MuiAvatar = @{ root = @{ width = 32 height = 32 } } } } $Sand = @{ palette = @{ primary = @{ light = '#ffe8d6' main = '#ddbea9' dark = '#cb997e' } secondary = @{ light = '#b7b7a4' main = '#a5a58d' dark = '#6b705c' } } } $Compliment = @{ palette = @{ primary = @{ light = '#e9c46a' main = '#2a9d8f' dark = '#264653' } secondary = @{ light = '#e9c46a' main = '#f4a261' dark = '#e76f51' } } } function ConvertTo-UDTheme { param($Name, $NavigationStyle) [string]$CSS = Get-ThemeCss $colors = Get-UDThemeColors -Theme $Name | Group-Object -Property "mode" | ForEach-Object { $_.Group | Select-Object -First 1 } $common = $colors | Where-Object Mode -eq common $dark = $colors | Where-Object Mode -eq dark # add some defaults $light = $colors | Where-Object Mode -eq light if (-not $light) { $colors += [pscustomobject]@{ "Mode" = "light" "Enabled" = "true" "Main" = "#f6f8fa" "MainSecondary" = "#DEDEDE" "MainGamma" = "#B8B8C2" "MainDelta" = "#c6c8ca" "Opposite" = "#24292f" "OppositeSecondary" = "#57606a" "HighContrast" = "#000000" } } if (-not $dark) { $colors += [pscustomobject]@{ "Mode" = "dark" "Enabled" = "true" "Main" = "#0D0F31" "MainSecondary" = "#070825" "MainGamma" = "#454761" "MainDelta" = "#A2A2AA" "Opposite" = "#c9d1d9" "OppositeSecondary" = "#8b949e" "HighContrast" = "#ffffff" } $dark = $colors | Where-Object Mode -eq dark } $shadows = @() 1..25 | ForEach-Object { $shadows += "none" } $themes = @{} ForEach ($theme in $colors) { switch ($NavigationStyle) { "theme" { $Navigation = $theme } "dark" { $Navigation = $dark } "light" { $Navigation = $light } "opposite" { if ($theme.mode -eq 'dark') { $navigation = $Light } if ($theme.mode -eq 'light') { $navigation = $Dark } } } $themes += @{ $theme.Mode = @{ globalStyle = $CSS palette = @{ mode = $theme.Mode background = @{ default = $theme.Main } text = @{ primary = $theme.Opposite secondary = $theme.OppositeSecondary disabled = $theme.OppositeSecondary } primary = @{ main = $common.Blue dark = $theme.BlueRGBA15 light = $common.Blue contrastText = $common.Black } secondary = @{ main = $common.Cyan dark = $theme.CyanRGBA15 light = $common.CyanRGBA15 contrastText = $common.Black } warning = @{ main = $common.Yellow dark = $theme.YellowRGBA15 light = $common.Yellow contrastText = $common.Black } error = @{ main = $common.Red dark = $theme.RedRGBA15 light = $common.Red contrastText = $common.Black } success = @{ main = $common.Green dark = $theme.GreenRGBA15 light = $common.Green contrastText = $common.Black } info = @{ main = $common.Purple dark = $theme.PurpleRGBA15 light = $common.Purple contrastText = $common.Black } } shape = @{ borderRadius = $common.BorderRadius } shadows = $shadows typography = @{ fontFamily = $common.FontFamily # Additional styles for fonts can be found in theme.css } overrides = @{ MuiAppBar = @{ root = @{ backgroundColor = $theme.MainSecondary backgroundImage = 'none' borderBottom = '1px solid ' + $theme.MainGamma paddingRight = '18px' paddingLeft = '18px' } } MuiDrawer = @{ paper = @{ backgroundColor = $Navigation.MainSecondary color = $Navigation.Opposite #zIndex = 1202 # Comment out this line in order to show the default header with logo flex = '0 0 250px' maxWidth = '250px' minWidth = '250px' width = '250px !important' borderRight = '1px solid ' + $Navigation.MainGamma '.MuiList-subheader' = @{ paddingLeft = '.5rem' paddingRight = '.5rem' } '.MuiList-root' = @{ paddingTop = 0 } '.MuiListItem-root' = @{ paddingLeft = '18px !important' cursor = "pointer" '&:hover' = @{ background = $Navigation.MainGamma borderRadius = $common.BorderRadius } } '#drawerSettings + .MuiCollapse-root' = @{ paddingLeft = '18px' } '.MuiListItemIcon-root, .MuiSvgIcon-root' = @{ color = $Navigation.Opposite } '.MuiToolbar-root' = @{ #backgroundImage = 'url(/assets/logo.png)' backgroundSize = '80%' backgroundRepeat = 'no-repeat' marginLeft = '18px' marginTop = '1px' backgroundPosition = 'left center' } } } MuiPaper = @{ root = @{ backgroundColor = $theme.MainSecondary backgroundImage = 'none' } } MuiToolbar = @{ root = @{ #paddingLeft = '0 !important' #paddingRight = '0 !important' } } MuiListItem = @{ root = @{ #paddingLeft = 0 } } MuiListItemIcon = @{ root = @{ color = $theme.Opposite minWidth = 'auto' marginRight = '1rem' } } MuiCard = @{ root = @{ border = '1px solid ' + $theme.MainGamma } } MuiCardHeader = @{ root = @{ paddingBottom = 0 } } MuiFormControl = @{ root = @{ #width = '100%' } } MuiInput = @{ root = @{ '&:before' = @{ borderBottom = '2px solid ' + $theme.MainGamma } } } MuiFormLabel = @{ root = @{ color = $theme.Opposite } } MuiSwitch = @{ switchBase = @{ color = $theme.MainGamma } } MuiGrid = @{ root = @{ '&.transfer-list' = @{ '.MuiPaper-root' = @{ border = '1px solid ' + $theme.MainGamma } 'button + button' = @{ #marginLeft = '0 !important' } } } } MuiStepIcon = @{ text = @{ fill = $dark.Main } root = @{ color = $dark.Opposite } } MuiAlert = @{ icon = @{ opacity = 1 } standardWarning = @{ backgroundColor = $common.YellowRGBA15 borderColor = $common.Yellow color = $theme.HighContrast } standardError = @{ backgroundColor = $common.RedRGBA15 borderColor = $common.Red color = $theme.HighContrast } standardSuccess = @{ backgroundColor = $common.GreenRGBA15 borderColor = $common.Green color = $theme.HighContrast } standardInfo = @{ backgroundColor = $common.PurpleRGBA15 borderColor = $common.Purple color = $theme.HighContrast } # Additional styles for alerts can be found in theme.css } MuiTableContainer = @{ root = @{ backgroundColor = "unset" borderRadius = 0; backgroundImage = 'none' margin = '0 !important' 'div[class*="makeStyles-search-"]' = @{ background = $theme.MainGamma marginRight = 0 } 'h5, .MuiTypography-h5' = @{ marginBottom = '0 !important' } } } MuiTable = @{ root = @{ borderCollapse = 'separate' } } MuiTablePagination = @{ toolbar = @{ #paddingLeft = '0 !important' #paddingRight = '0 !important' } spacer = @{ display = 'none' } displayedRows = @{ marginRight = 'auto' } } MuiTableCell = @{ head = @{ backgroundColor = $theme.MainGamma } root = @{ borderBottom = '1px solid ' + $theme.MainGamma } footer = @{ borderTop = '1px solid ' + $theme.MainGamma } } MuiTableBody = @{ root = @{ 'tr:nth-child(even)' = @{ backgroundColor = $theme.Main } 'tr:nth-child(odd)' = @{ backgroundColor = $theme.MainSecondary } } } MuiTableRow = @{ root = @{ '&:last-child td' = @{ borderBottom = 0 } } } MuiButton = @{ root = @{ # fontWeight = 600 # margin = '0 0 .25rem !important' # '+ .MuiButton-root' = @{ # marginLeft = '0.5rem !important' # } } contained = @{ color = $common.Black } outlined = @{ '&:hover' = @{ color = $common.Black } } containedInherit = @{ backgroundColor = $theme.MainGamma color = $theme.Opposite '&:hover' = @{ backgroundColor = $theme.MainDelta } } containedPrimary = @{ '&:hover' = @{ backgroundColor = $common.BlueHover } } containedSecondary = @{ '&:hover' = @{ backgroundColor = $common.CyanHover } } containedInfo = @{ '&:hover' = @{ backgroundColor = $common.PurpleHover } } containedWarning = @{ '&:hover' = @{ backgroundColor = $common.YellowHover } } containedError = @{ '&:hover' = @{ backgroundColor = $common.RedHover } } containedSuccess = @{ '&:hover' = @{ backgroundColor = $common.GreenHover } } outlinedInherit = @{ borderColor = $theme.MainGamma '&:hover' = @{ backgroundColor = $theme.MainGamma color = $theme.Opposite } } outlinedPrimary = @{ borderColor = $common.Blue '&:hover' = @{ backgroundColor = $common.Blue } } outlinedSecondary = @{ borderColor = $common.Cyan '&:hover' = @{ backgroundColor = $common.Cyan } } outlinedInfo = @{ borderColor = $common.Purple '&:hover' = @{ backgroundColor = $common.Purple } } outlinedWarning = @{ borderColor = $common.Yellow '&:hover' = @{ backgroundColor = $common.Yellow } } outlinedError = @{ borderColor = $common.Red '&:hover' = @{ backgroundColor = $common.Red } } outlinedSuccess = @{ borderColor = $common.Green '&:hover' = @{ backgroundColor = $common.Green } } } } } } } $themes } function Get-UDThemeColors { param( [Parameter(Mandatory)] $Theme ) Get-Content -Path (Join-Path -Path (Get-ThemeFolder) -ChildPath "$theme.json") | ConvertFrom-Json } function Get-ThemeFolder { Join-Path -Path $PSScriptRoot -ChildPath themes } function Get-ThemeCss { $ThemeFolder = Get-ThemeFolder $CssPath = Join-Path -Path $ThemeFolder -ChildPath theme.css Get-Content $CssPath -Raw } function Get-AllThemes { $ThemeFolder = Get-ThemeFolder (Get-ChildItem -Path $ThemeFolder -Filter *.json).BaseName } function Get-Rgb { [cmdletbinding()] param( [string[]]$Color ) # Clean up if ($first = $Color[1]) { $cleanedcolor = $Color -join "," if ($first -notmatch "rgb" -and $first -notmatch "\(") { $cleanedcolor = "rgb($cleanedcolor)" } } else { $cleanedcolor = "$Color" } $cleanedcolor = $cleanedcolor.Replace('#', '') $cleanedcolor = $cleanedcolor.Replace(' ', '') if ($cleanedcolor -match '^rgb') { try { # If RGB --> store the red, green, blue values in separate variables $rgb = $cleanedcolor -match '^rgba?\((\d+),\s*(\d+),\s*(\d+)(?:,\s*(\d+(?:\.\d+)?))?\)$' if (-not $rgb) { $rgb = $cleanedcolor -match '^([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])$' } $r = [convert]::ToInt32($matches[1]) $g = [convert]::ToInt32($matches[2]) $b = [convert]::ToInt32($matches[3]) } catch { Write-Warning "$cleanedcolor isnt a valid rgb color for the purposes of the script: $PSItem" return } } else { try { $null = [int]::Parse($cleanedcolor, [System.Globalization.NumberStyles]::HexNumber) if ($cleanedcolor.Length -eq 3) { # if someone passed in a shortcut html, expand it $cleanedcolor = $cleanedcolor[0] + $cleanedcolor[0] + $cleanedcolorex[1] + $cleanedcolor[1] + $cleanedcolor[2] + $cleanedcolor[2] } $r = $cleanedcolor.Remove(2, 4) $g = $cleanedcolor.Remove(4, 2) $g = $g.remove(0, 2) $b = $cleanedcolor.Remove(0, 4) $r = [convert]::ToInt32($r, 16) $g = [convert]::ToInt32($g, 16) $b = [convert]::ToInt32($b, 16) } catch { Write-Warning "$cleanedcolor is not a valid hex for the purposes of the script" return } } $r, $g, $b } function Get-Hsp { [cmdletbinding()] param( [string]$Color ) $r, $g, $b = Get-Rgb $Color # HSP equation from http://alienryderflex.com/hsp.html [math]::Sqrt( 0.299 * ($r * $r) + 0.587 * ($g * $g) + 0.114 * ($b * $b) ) } function Get-Contrast { [cmdletbinding()] param( [string]$Color1, [string]$Color2 ) $one = Get-Hsp $Color1 $two = Get-Hsp $Color2 if ($one -ge $two) { $first = $one $second = $two } else { $first = $two $second = $one } $first - $second } function Test-Contrast { [cmdletbinding()] param( [string]$Color1, [string]$Color2 ) $diff = Get-Contrast $Color1 $Color2 if ($diff -gt 50) { $true } else { $false } } function Test-DarkColor { <# .SYNOPSIS Tests an rgb or hex value to see if it's considered light or dark .PARAMETER Color The color to test in Hex or RGB .NOTES Thanks to: https://github.com/EvotecIT/PSSharedGoods/blob/master/Public/Converts/Convert-Color.ps1 https://awik.io/determine-color-bright-dark-using-javascript/ .EXAMPLE Test-DarkColor ffffff False .EXAMPLE Test-DarkColor 000000 True .EXAMPLE Test-DarkColor "rgb(255,255,255)" False .EXAMPLE Test-DarkColor "rgb(255,255,255)" VERBOSE: 255 VERBOSE: 255 VERBOSE: 255 VERBOSE: 255 False #> [cmdletbinding()] param( [string[]]$Color ) # Clean up if ($first = $Color[1]) { $cleanedcolor = $Color -join "," if ($first -notmatch "rgb" -and $first -notmatch "\(") { $cleanedcolor = "rgb($cleanedcolor)" } } else { $cleanedcolor = "$Color" } $cleanedcolor = $cleanedcolor.Replace('#', '') $cleanedcolor = $cleanedcolor.Replace(' ', '') $r, $g, $b = Get-Rgb $cleanedcolor $hsp = Get-Hsp $cleanedcolor # Using the HSP value, determine whether the color is light or dark if ($hsp -gt 127.5) { $hsp | Write-Verbose return $false } else { $hsp | Write-Verbose return $true } } function Get-InvertedColor { [cmdletbinding()] param( [Alias("Color")] $Hex ) $hex = $hex -replace "#" if ($hex.Length -eq 3) { # if someone passed in a shortcut html, expand it $hex = $hex[0] + $hex[0] + $hex[1] + $hex[1] + $hex[2] + $hex[2] } $rgb = "#" for ($i = 0; $i -lt 3; $i++) { $number = $i * 2 $what = $hex.substring($number, 2) $c = [convert]::ToInt32($what, 16) $opposite = (255 - $c) $c = '{0:X4}' -f $opposite $rgb += ("00" + $c).SubString($c.length) } -join $rgb } $Themes = @{ AntDesign = $AntDesign Paperbase = $Paperbase Sand = $Sand Compliment = $Compliment } function Get-UDTheme { <# .SYNOPSIS Returns predefined themes. .DESCRIPTION Returns predefined themes. .PARAMETER Name The name of the theme. .PARAMETER NavigationStyle The style of the navigation. .EXAMPLE $Theme = Get-UDTheme -Name 'AntDesign' .NOTES General notes #> param( [Parameter()] $Name, [Parameter()] [ValidateSet("theme", "dark", "light", "opposite")] [string]$NavigationStyle = "theme" ) if ($Name -eq 'MaterialDesign') { return @{} } if ($Name) { if ($Themes.Keys -contains $Name) { return $Themes[$Name] } ConvertTo-UDTheme -Name $Name -NavigationStyle $NavigationStyle } else { Get-AllThemes } } function New-UDTimeline { param( [Parameter()] [string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter()] [Alias("Content")] [scriptblock]$Children, [Parameter()] [ValidateSet("right", 'left', 'alternate')] [string]$Position = "right" ) @{ isPlugin = $true assetId = $MUAssetId type = "mu-timeline" id = $id children = & $Children position = $Position.ToLower() } } function New-UDTimelineItem { param( [Parameter()] [ScriptBlock]$Content = {}, [Parameter()] [ScriptBlock]$OppositeContent = {}, [Parameter()] [Hashtable]$Icon, [Parameter()] [ValidateSet("error", 'grey', 'info', 'inherit', 'primary', 'secondary', 'success', 'warning')] [string]$Color = 'grey', [Parameter()] [ValidateSet('filled', 'outlined')] [string]$Variant = 'filled' ) @{ content = & $Content oppositeContent = & $OppositeContent icon = $icon color = $Color.ToLower() variant = $Variant.ToLower() } } <# New-UDTimeline -Children { New-UDTimelineItem -Content { 'Breakfast' } -OppositeContent { '7:45 AM' } New-UDTimelineItem -Content { 'Welcome Message' } -OppositeContent { '9:00 AM' } New-UDTimelineItem -Content { 'State of the Shell' } -OppositeContent { '9:30 AM' } New-UDTimelineItem -Content { 'General Session' } -OppositeContent { '11:00 AM' } } #> function New-UDTimePicker { <# .SYNOPSIS Creates a time picker. .DESCRIPTION Creates a time picker. This component can be used stand alone or within New-UDForm. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Label The label to show with the time picker. .PARAMETER OnChange A script block to call when the time is changed. The $EventData variable contains the currently selected time. .PARAMETER Value The current value of the time picker. .PARAMETER Locale Change the language of the time picker. .PARAMETER ClassName A CSS class to apply to the time picker. .PARAMETER DisableAmPm Use 24-hour time instead of them AM/PM ante meridiem. .EXAMPLE Creates a new time picker New-UDTimePicker -Id 'timePicker' #> param( [Parameter()] [string]$Id = [Guid]::NewGuid().ToString(), [Parameter()] [string]$Label, [Parameter()] [Endpoint]$OnChange, [Parameter()] [string]$Value, [Parameter()] [ValidateSet("en", "de", 'ru', 'fr', 'nl', 'it')] [string]$Locale = "en", [Parameter()] [string]$ClassName, [Parameter()] [Switch]$DisableAmPm, [Parameter()] [System.TimeZoneInfo]$TimeZone ) if ($OnChange) { $OnChange.Register($Id, $PSCmdlet) } $TZ = $null if ($TimeZone) { $TZ = $TimeZone.GetUtcOffset((Get-Date)).ToString() $TZ = $TZ.Substring(0, $TZ.Length - 3) if (-not $TZ.StartsWith("-")) { $TZ = "+" + $TZ } } @{ id = $Id type = 'mu-timepicker' asset = $MUAssetId isPlugin = $true onChange = $OnChange value = $Value label = $Label locale = $Locale.ToLower() className = $ClassName ampm = -not ($DisableAmPm.IsPresent) timeZone = $TZ } } function New-UDTooltip { <# .SYNOPSIS A tooltip component. .DESCRIPTION A tooltip component. Tooltips can be placed over an other component to display a popup when the user hovers over the nested component. .PARAMETER Id The ID of this component. .PARAMETER Place Where to place the tooltip. .PARAMETER Type The type of tooltip. .PARAMETER Effect An effect to apply to the tooltip. .PARAMETER TooltipContent Content to display within the tooltip. .PARAMETER Content Content that activates the tooltip when hovered. .EXAMPLE A simple tooltip. New-UDTooltip -Content { New-UDTypography -Text 'Hover me' } -TooltipContent { New-UDTypography -Text 'I'm a tooltip' } #> param( [Parameter()] [string]$Id = [Guid]::NewGuid(), [Parameter()] [ValidateSet("top", "bottom", "left", "right")] [string]$Place = "top", [Parameter()] [ValidateSet("dark", "success", "warning", "error", "info", "light")] [string]$Type = "dark", [Parameter()] [ValidateSet("float", "solid")] [string]$Effect, [Parameter(Mandatory)] [ScriptBlock]$TooltipContent, [Parameter(Mandatory)] [ScriptBlock]$Content ) @{ type = "ud-tooltip" tooltipType = $Type effect = $Effect place = $Place id = $Id tooltipContent = New-UDErrorBoundary -Content $TooltipContent content = New-UDErrorBoundary -Content $Content } } function New-UDTransferList { <# .SYNOPSIS Creates a transfer list component. .DESCRIPTION A transfer list (or "shuttle") enables the user to move one or more list items between lists. .PARAMETER Id The ID of this component. .PARAMETER Item A list of items that can be transferred between lists. Use New-UDTransferListItem to create an item. .PARAMETER SelectedItem A list of selected items. Use the value of item to transfer items between lists. .PARAMETER OnChange A script block that is executed when the user changes the selected items. .EXAMPLE New-UDTransferList -Item { New-UDTransferListItem -Name 'test1' -Value 1 New-UDTransferListItem -Name 'test2' -Value 2 New-UDTransferListItem -Name 'test3' -Value 3 New-UDTransferListItem -Name 'test4' -Value 4 New-UDTransferListItem -Name 'test5' -Value 5 } Creates a basic transfer list. .EXAMPLE New-UDTransferList -Item { New-UDTransferListItem -Name 'test1' -Value 1 New-UDTransferListItem -Name 'test2' -Value 2 New-UDTransferListItem -Name 'test3' -Value 3 New-UDTransferListItem -Name 'test4' -Value 4 New-UDTransferListItem -Name 'test5' -Value 5 } -OnChange { Show-UDToast ($EventData | ConvertTo-Json) } Creates a basic transfer list that shows a toast when the values are changed. .EXAMPLE New-UDForm -Content { New-UDTransferList -Item { New-UDTransferListItem -Name 'test1' -Value 1 New-UDTransferListItem -Name 'test2' -Value 2 New-UDTransferListItem -Name 'test3' -Value 3 New-UDTransferListItem -Name 'test4' -Value 4 New-UDTransferListItem -Name 'test5' -Value 5 } } -OnSubmit { Show-UDToast ($EventData | ConvertTo-Json) } Creates a transfer list that is part of a form. #> param( [Parameter()] [string]$Id = [Guid]::NewGuid(), [Parameter()] [ScriptBlock]$Item, [Parameter()] [string[]]$SelectedItem = @(), [Parameter()] [Endpoint]$OnChange, [Parameter()] [string]$ClassName, [Parameter()] [Switch]$Disabled ) if ($OnChange) { $OnChange.Register($Id + "onChange", $PSCmdlet) } @{ type = 'mu-transfer-list' assetId = $MUAssetId isPlugin = $true id = $id item = $Item.Invoke() selectedItem = $SelectedItem onChange = $OnChange className = $ClassName disabled = $Disabled.IsPresent } } function New-UDTransferListItem { <# .SYNOPSIS Creates an item for use in a transfer list. .DESCRIPTION Creates an item for use in a transfer list. .PARAMETER Name The display name of the item. .PARAMETER Value The value of the item. #> param( [Parameter(Mandatory = $true)] [String]$Name, [Parameter(Mandatory = $true)] [String]$Value, [Parameter()] [Switch]$Disabled ) @{ name = $Name value = $Value disabled = $Disabled.IsPresent } } function New-UDTransition { <# .SYNOPSIS Creates a transition effect. .DESCRIPTION Creates a transition effect. .PARAMETER Id The ID of this component. .PARAMETER Collapse Creates a collapse transition. .PARAMETER CollapseHeight The height of the content when collapsed. .PARAMETER Fade Creates a fade transition. .PARAMETER Grow Creates a grow transition. .PARAMETER Slide Creates a slide transition. .PARAMETER SlideDirection The direction of the slide transition. .PARAMETER Zoom Creates a zoom transition. .PARAMETER Children The content or children to transition. .PARAMETER In Whether the content is transitioned in. You can use Set-UDElement to trigger a transition. .PARAMETER Timeout The number of milliseconds it takes to transition. #> param( [Parameter()] [string]$Id = [Guid]::NewGuid().ToString(), [Parameter(ParameterSetName = "Collapse")] [Switch]$Collapse, [Parameter(ParameterSetName = "Collapse")] [int]$CollapseHeight, [Parameter(ParameterSetName = "Fade")] [Switch]$Fade, [Parameter(ParameterSetName = "Grow")] [Switch]$Grow, [Parameter(ParameterSetName = "Slide")] [Switch]$Slide, [Parameter(ParameterSetName = "Slide")] [ValidateSet("Left", "Right", "Down", "Up")] [string]$SlideDirection = "Down", [Parameter(ParameterSetName = "Zoom")] [Switch]$Zoom, [Parameter(Mandatory)] [Alias("Content")] [scriptblock]$Children, [Parameter()] [Switch]$In, [Parameter()] [int]$Timeout ) @{ type = "mu-transition" id = $Id asset = $MUAssetId isPlugin = $true transition = $PSCmdlet.ParameterSetName.ToLower() collapseHeight = $CollapseHeight slideDirection = $SlideDirection timeout = $Timeout in = $In.IsPresent children = & $Children } } function New-UDTreeView { <# .SYNOPSIS Creates a new tree view. .DESCRIPTION Creates a new tree view. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Node A collection of root nodes to show within the tree view. .PARAMETER OnNodeClicked A script block that is called when a node is clicked. $EventData will contain the node that was clicked. .EXAMPLE Creates a basic tree view. New-UDTreeView -Node { New-UDTreeNode -Id 'Root' -Name 'Root' -Children { New-UDTreeNode -Id 'Level1' -Name 'Level 1' -Children { New-UDTreeNode -Id 'Level2' -Name 'Level 2' } New-UDTreeNode -Name 'Level 1' -Children { New-UDTreeNode -Name 'Level 2' } New-UDTreeNode -Name 'Level 1' -Children { New-UDTreeNode -Name 'Level 2' } } New-UDTreeNode -Id 'Root2' -Name 'Root 2' } #> param( [Parameter()] [string]$Id = [Guid]::NewGuid(), [Parameter(Mandatory)] [ScriptBlock]$Node, [Parameter()] [Endpoint]$OnNodeClicked, [Parameter()] [Hashtable]$Style, [Parameter()] [string]$ClassName, [Parameter()] [Switch]$Expanded ) End { if ($OnNodeClicked) { $OnNodeClicked.Register($Id, $PSCmdlet) } @{ assetId = $AssetId isPlugin = $true id = $Id type = 'mu-treeview' node = & $Node onNodeClicked = $OnNodeClicked style = $Style className = $ClassName expanded = $Expanded.IsPresent } } } function New-UDTreeNode { <# .SYNOPSIS Creates a tree node. .DESCRIPTION Creates a tree node. This cmdlet should be used with New-UDTreeView. .PARAMETER Name The name of the node. This is displayed within the UI. .PARAMETER Id The ID of the node. This is passed to the $EventData property when the OnNodeClicked script block is set. .PARAMETER Children The children of this node. This should be a collection of New-UDTreeNodes. .PARAMETER Leaf This is a leaf node and should not display children. Added in PSU 2.6. .PARAMETER Icon The icon to display for this node. Use New-UDIcon to create this icon. Added in PSU 2.6. .PARAMETER ExpandedIcon The icon to display for this node when it is expanded. Use New-UDIcon to create this icon. Added in PSU 2.6. .EXAMPLE See New-UDTreeView for examples. #> param( [Parameter(Mandatory, Position = 1)] [string]$Name, [Parameter()] [string]$Id = [Guid]::NewGuid(), [Parameter()] [ScriptBlock]$Children, [Parameter()] [Switch]$Leaf, [Parameter()] [object]$Icon, [Parameter()] [object]$ExpandedIcon, [Parameter()] [Switch]$Expanded ) End { $ChildrenArray = $null if ($PSBoundParameters.ContainsKey("Children")) { $ChildrenArray = & $Children } @{ name = $Name id = $Id children = $ChildrenArray icon = $Icon expandedIcon = $ExpandedIcon leaf = $Leaf.IsPresent expanded = $Expanded.IsPresent } } } function New-UDTypography { <# .SYNOPSIS Creates typography. .DESCRIPTION Creates typography. Typography allows you to configure text within a dashboard. .PARAMETER Id The ID of the component. It defaults to a random GUID. .PARAMETER Variant The type of text to display. .PARAMETER Text The text to format. .PARAMETER Content The content to format. .PARAMETER Style A set of CSS styles to apply to the typography. .PARAMETER ClassName A CSS className to apply to the typography. .PARAMETER Align How to align the typography. .PARAMETER GutterBottom The gutter bottom. .PARAMETER NoWrap Disables text wrapping. .PARAMETER Paragraph Whether this typography is a paragraph. .PARAMETER Sx Theme-based styling hashtable. .EXAMPLE New-UDTypography -Text 'Hello' -Paragraph #> [CmdletBinding(DefaultParameterSetName = "text")] param( [Parameter()] [string]$Id = ([Guid]::NewGuid()).ToString(), [Parameter()] [ValidateSet ("h1", "h2", "h3", "h4", "h5", "h6", "subtitle1", "subtitle2", "body1", "body2", "caption", "button", "overline", "srOnly", "inherit", "display4", "display3", "display2", "display1", "headline", "title", "subheading")] [string]$Variant, [Parameter(ParameterSetName = "text", Position = 0)] [string]$Text, [Parameter(ParameterSetName = "content")] [scriptblock]$Content, [Parameter()] [Hashtable]$Style = @{}, [Parameter()] [string]$ClassName, [Parameter()] [ValidateSet ("inherit", "left", "center", "right", "justify")] [string]$Align, [Parameter()] [Switch]$GutterBottom, [Parameter()] [Switch]$NoWrap, [Parameter()] [ValidateSet('normal', 'bold', 'lighter', 'bolder', '100', '200', '300', '400', '500', '600', '700', '800', '900')] [string]$FontWeight, [Parameter()] [Hashtable]$Sx ) End { if ($FontWeight) { $Style["fontWeight"] = $FontWeight } $MUTypography = @{ type = "mu-typography" isPlugin = $true assetId = $MUAssetId id = $Id className = $ClassName variant = $Variant noWrap = $NoWrap.IsPresent text = $Text style = $Style align = $Align content = if ($Content) { & $Content } else { $null } gutterBottom = $GutterBottom.IsPresent sx = $sx } $MUTypography.PSTypeNames.Insert(0, 'UniversalDashboard.MaterialUI.Typography') | Out-Null $MUTypography } } function New-UDUpload { <# .SYNOPSIS Upload files .DESCRIPTION Upload files. This component works with UDForm and UDStepper. .PARAMETER Id The ID of the uploader. .PARAMETER Accept The type of files to accept. By default, this component accepts all files. .PARAMETER OnUpload A script block to execute when a file is uploaded. This $body parameter will contain JSON in the following format: { data: 'base64 encoded string of file data', name: 'filename', type: 'type of file, if known' } $EventData will contain a class with the following properties: public string Name { get; set; } public string FileName { get; set; } public DateTime TimeStamp { get; set; } public string ContentType { get; set; } public string Type => ContentType; .PARAMETER Text The text to display on the upload button. .PARAMETER Variant The variant of button. Defaults to contained. Valid values: "text", "outlined", "contained" .PARAMETER Color The color of the button. Defaults to 'default'. Valid values: "default", "primary", "secondary", "inherit" .PARAMETER ClassName A CSS class to apply to the button. .PARAMETER HideUploadedFileName Hides the file name text that is shown after upload .PARAMETER Icon The icon to show instead of the default icon. Use New-UDIcon to create an icon. .PARAMETER IconAlignment How to align the icon within the button. Valid values are: "left", "right" .EXAMPLE A file uploader New-UDDashboard -Title "Hello, World!" -Content { New-UDUpload -Text "Upload" -OnUpload { Show-UDToast $Body } } .EXAMPLE A file uploader in a form New-UDDashboard -Title "Hello, World!" -Content { New-UDForm -Content { New-UDUpload -Text "Upload" } -OnSubmit { Show-UDToast $Body } } #> param( [Parameter()] [string]$Id = [Guid]::NewGuid(), [Parameter()] [string]$Accept = "*", [Parameter()] [Endpoint]$OnUpload, [Parameter()] [string]$Text, [Parameter()] [ValidateSet("text", "outlined", "contained")] [string]$Variant = "contained", [Parameter()] [ValidateSet('default', 'inherit', 'primary', 'secondary', 'success', 'error', 'info', 'warning')] [string]$Color = "primary", [Parameter()] [string]$ClassName, [Parameter()] [Switch]$HideUploadedFileName, [Parameter()] $Icon, [Parameter ()] [ValidateSet("left", "right")] [string]$IconAlignment = "left" ) if ($OnUpload) { $OnUpload.Register($Id, $PSCmdlet) } if ($Color -eq 'default') { $Color = 'inherit' } @{ type = "mu-upload" isPlugin = $true assetId = $MUAssetId id = $id accept = $Accept onUpload = $OnUpload text = $Text variant = $Variant.ToLower() color = $Color.ToLower() className = $ClassName hideUploadedFileName = $HideUploadedFileName.IsPresent icon = $Icon iconAlignment = $IconAlignment.ToLower() } } function Add-UDElement { <# .SYNOPSIS Adds an element to a parent element. .DESCRIPTION Adds an element to a parent element. This cmdlet may behave differently depending on the type of parent element. .PARAMETER ParentId The parent element ID to add the item to. .PARAMETER Content The content to add to the parent element. .PARAMETER Broadcast Whether to update all connected dashboards (all users). .EXAMPLE New-UDElement -Tag 'div' -Id 'parent' -Content { } New-UDButton -Text 'Click Me' -OnClick { Add-UDElement -ParentId 'parent' -Content { New-UDTypography -Text 'Hello World' } } #> param( [Parameter(Mandatory)] [string]$ParentId, [Parameter(Mandatory)] [ScriptBlock]$Content, [Parameter()] [Switch]$Broadcast ) $NewContent = & $Content $Data = @{ componentId = $ParentId elements = $NewContent } if ($Broadcast) { $DashboardHub.SendWebSocketMessage("addElement", $Data) } else { $DashboardHub.SendWebSocketMessage($ConnectionId, "addElement", $Data) } } function Clear-UDElement { <# .SYNOPSIS Removes all children from the specified element. .DESCRIPTION Removes all children from the specified element. This cmdlet may behave differently depending on the type of parent element. .PARAMETER Id The ID of the element to clear. .PARAMETER Broadcast Whether to clear the element on all connected clients. .EXAMPLE New-UDElement -Tag 'div' -Id 'parent' -Content { New-UDTypography -Text 'Hello World' } New-UDButton -Text 'Click Me' -OnClick { Clear-UDElement -Id 'parent' } #> param( [Parameter(Mandatory)] [string]$Id, [Parameter()] [Switch]$Broadcast ) if ($Broadcast) { $DashboardHub.SendWebSocketMessage("clearElement", $Id) } else { $DashboardHub.SendWebSocketMessage($ConnectionId, "clearElement", $Id) } } function Get-UDElement { <# .SYNOPSIS Get the state of the specified element. .DESCRIPTION Get the state of the specified element. This cmdlet may behave differently depending on the type of parent element. .PARAMETER Id The ID of the element to retreive the state of. .EXAMPLE New-UDCodeEditor -Id 'editor' -Code 'Hello World' New-UDButton -Text 'Click Me' -OnClick { Show-UDToast (Get-UDElement).Code } #> [CmdletBinding()] param( [Parameter(Mandatory, Position = 0)] [string]$Id, [Parameter(Position = 1)] [string]$Property ) $requestId = '' $requestId = [Guid]::NewGuid().ToString() $Data = @{ requestId = $requestId componentId = $Id } $DashboardHub.SendWebSocketMessage($ConnectionId, "requestState", $Data) $Object = ConvertFrom-Json -InputObject ($stateRequestService.Get($requestId)) if ($Property) { $Object | Select-Object -ExpandProperty $Property } else { $Object } } function Hide-UDModal { [CmdletBinding()] param( ) $DashboardHub.SendWebSocketMessage($ConnectionId, "closeModal", $null) } function Hide-UDToast { param( [Parameter(Mandatory, Position = 0)] [string]$Id ) if ($id -notmatch '^[a-zA-Z0-9]+$') { throw "Invalid ID. ID must be alphanumeric." } $DashboardHub.SendWebSocketMessage($ConnectionId, "hideToast", "x" + $Id) } function Invoke-UDJavaScript { <# .SYNOPSIS Invokes JavaScript within the browser. .DESCRIPTION Invokes JavaScript within the browser. JavaScript is executed with eval() .PARAMETER JavaScript The JavaScript to execute. .EXAMPLE New-UDButton -Text 'Click Me' -OnClick { Invoke-UDJavaScript 'alert("Hello World!")' } #> param( [Parameter(Mandatory)] [string]$JavaScript ) $DashboardHub.SendWebSocketMessage($ConnectionId, "invokejavascript", $JavaScript) } function Invoke-UDRedirect { <# .SYNOPSIS Redirect the user to another page. .DESCRIPTION Redirect the user to another page. .PARAMETER Url The URL to redirect the user to. .PARAMETER OpenInNewWindow Whether to open the URL in a new window. .PARAMETER Native Performs a native redirect. This is useful when using relative paths that aren't part of the dashboard. .EXAMPLE New-UDButton -Text 'Click Me' -OnClick { Invoke-UDRedirect 'https://www.google.com' } #> param( [Parameter(Mandatory)] [string]$Url, [Parameter()] [Switch]$OpenInNewWindow, [Parameter()] [Switch]$Native ) $Data = @{ url = $Url openInNewWindow = $OpenInNewWindow.IsPresent native = $Native.IsPresent } $DashboardHub.SendWebSocketMessage($ConnectionId, "redirect", $Data) } function Remove-UDElement { <# .SYNOPSIS Removes an element from the page. .DESCRIPTION Removes an element from the page. .PARAMETER Id The ID of the element to remove. .PARAMETER ParentId Not used .PARAMETER Broadcast Whether to remove this element from the page of all connected users. .EXAMPLE New-UDElement -Id 'myElement' -Tag 'div' -Content { New-UDTypography -Text 'Hello World' } New-UDButton -Text 'Click Me' -OnClick { Remove-UDElement -Id 'myElement' } #> param( [Parameter(Mandatory)] [string]$Id, [Parameter()] [string]$ParentId, [Parameter()] [Switch]$Broadcast ) $Data = @{ componentId = $Id parentId = $ParentId } if ($Broadcast) { $DashboardHub.SendWebSocketMessage("removeElement", $Data) } else { $DashboardHub.SendWebSocketMessage($ConnectionId, "removeElement", $Data) } } function Select-UDElement { <# .SYNOPSIS Selects the specified element. .DESCRIPTION Selects the specified element. This cmdlet is useful for selecting input fields. .PARAMETER Id The ID of the element to select. .PARAMETER ScrollToElement Whether to scroll to the element. .EXAMPLE New-UDTextbox -Id 'txtName' -Label 'Name' New-UDButton -Text 'Click Me' -OnClick { Select-UDElement -Id 'txtName' } #> param( [Parameter(Mandatory, ParameterSetName = "Normal")] [string]$Id, [Parameter(ParameterSetName = "Normal")] [Switch]$ScrollToElement ) $Data = @{ id = $Id scrollToElement = $ScrollToElement } $DashboardHub.SendWebSocketMessage($ConnectionId, "select", $Data) } function Set-UDClipboard { <# .SYNOPSIS Sets string data into the clipboard. .DESCRIPTION Sets string data into the clipboard. .PARAMETER Data The data to set into the clipboard. .PARAMETER ToastOnSuccess Show a toast if the clipboard data was sent successfully. .PARAMETER ToastOnError Show a toast if the clipboard data was not sent successfully. .EXAMPLE New-UDButton -Text 'Click Me' -OnClick { Set-UDClipboard -Data 'Hello World!' -ShowToastOnSuccess } #> param( [Parameter(Mandatory)] [string]$Data, [Parameter()] [Switch]$ToastOnSuccess, [Parameter()] [Switch]$ToastOnError ) $cpData = @{ data = $Data toastOnSuccess = $ToastOnSuccess.IsPresent toastOnError = $ToastOnError.IsPresent } $DashboardHub.SendWebSocketMessage($ConnectionId, "clipboard", $cpData) } function Set-UDElement { <# .SYNOPSIS Set properties of an element. .DESCRIPTION Set the properties of an element. .PARAMETER Id The element to set properites on. .PARAMETER Properties The properties to set in the form of a hashtable. .PARAMETER Broadcast Whether to update this element on all connected clients. .PARAMETER Content Content to set within the element. .EXAMPLE New-UDButton -Id 'button' -Text 'Disable Me' -OnClick { Set-UDElement -Id 'button' -Properties @{ 'disabled' = $true } } #> param( [Parameter(Mandatory)] [string]$Id, [Alias("Attributes")] [Parameter()] [Hashtable]$Properties, [Parameter()] [Switch]$Broadcast, [Parameter()] [ScriptBlock]$Content ) if ($Content -and -not $Properties) { $Properties = @{} } if ($Content) { $Properties['content'] = [Array](& $Content) } $Data = @{ componentId = $Id state = $Properties } if ($Broadcast) { $DashboardHub.SendWebSocketMessage("setState", $data) } else { $DashboardHub.SendWebSocketMessage($ConnectionId, "setState", $Data) } } function Set-UDTheme { <# .SYNOPSIS Sets the current theme of the dashboard. .DESCRIPTION Sets the current theme of the dashboard. .PARAMETER Name A named theme to apply. .PARAMETER Theme A custom theme to apply. .PARAMETER Theme The light or dark variant of the theme. #> param( [Parameter(ParameterSetName = "Name")] [string]$Name, [Parameter(ParameterSetName = "Theme")] [Hashtable]$Theme, [Parameter()] [ValidateSet("light", "dark")] [string]$Variant = "light" ) $Data = @{ name = $Name variant = $Variant.ToLower() theme = $Theme | ConvertTo-Json -Depth 10 } $DashboardHub.SendWebSocketMessage($ConnectionId, "setTheme", $Data) } function Show-UDModal { <# .SYNOPSIS Show a modal. .DESCRIPTION Show a modal. .PARAMETER FullScreen Create a full screen modal. .PARAMETER Footer The footer components for the modal. .PARAMETER Header The header components for the modal. .PARAMETER Content The content of the modal. .PARAMETER Persistent Whether the modal can be closed by clicking outside of it. .PARAMETER FullWidth Whether the modal is full width. .PARAMETER MaxWidth The max width of the modal. .PARAMETER HeaderStyle The CSS style for the header portion of the modal. .PARAMETER Dividers Places a divider between header and footer content .EXAMPLE New-UDButton -Text 'Click Me' -OnClick { Show-UDModal -Content { New-UDTypography -Text "Hello World" } } #> param( [Parameter()] [Switch]$FullScreen, [Parameter()] [ScriptBlock]$Footer = {}, [Parameter()] [ScriptBlock]$Header = {}, [Parameter()] [ScriptBlock]$Content = {}, [Parameter()] [Switch]$Persistent, [Parameter()] [Switch]$FullWidth, [Parameter()] [ValidateSet("xs", "sm", "md", "lg", "xl")] [string]$MaxWidth, [Parameter()] [Hashtable]$Style, [Parameter()] [Hashtable]$HeaderStyle, [Parameter()] [Hashtable]$ContentStyle, [Parameter()] [Hashtable]$FooterStyle, [Parameter()] [Switch]$Dividers ) $Modal = @{ dismissible = -not $Persistent.IsPresent fullWidth = $FullWidth.IsPresent fullScreen = $FullScreen.IsPresent style = $Style headerStyle = $HeaderStyle contentStyle = $ContentStyle footerStyle = $FooterStyle dividers = $Dividers.IsPresent maxWidth = $MaxWidth } $Endpoint = [Endpoint]::new() $Endpoint.ScriptBlock = {} $Endpoint.Register('UDModal', $PSCmdlet) if ($null -ne $Footer) { $Modal['footer'] = & $Footer $Endpoint } if ($null -ne $Header) { $Modal['header'] = & $Header $Endpoint } if ($null -ne $Content) { $Modal['content'] = & $Content $Endpoint } $DashboardHub.SendWebSocketMessage($ConnectionId, "showModal", $modal) } function Show-UDSnackbar { param( [Parameter(Mandatory)] [string]$Message, [Parameter()] [int]$AutoHideDuration = 5000, [Parameter()] [Switch]$Persist, [Parameter()] [ValidateSet('default', 'error', 'success', 'warning', 'info')] [string]$Variant = 'default' ) $DashboardHub.SendWebSocketMessage($ConnectionId, "showSnackbar", @{ message = $message autoHideDuration = $AutoHideDuration persist = $Persist.IsPresent variant = $Variant.ToLower() }) } function Show-UDToast { <# .SYNOPSIS Displays a toast message to the user. .DESCRIPTION Displays a toast message to the user. .PARAMETER Message The message to display. .PARAMETER MessageColor The text color of the message. .PARAMETER MessageSize The size of the message. .PARAMETER Duration The duration in milleseconds before the message disappears. .PARAMETER Title The title to display. .PARAMETER TitleColor The text color of the title. .PARAMETER TitleSize The size of the title. .PARAMETER Id The ID of the toast. For use with Hide-UDToast. .PARAMETER BackgroundColor The background color of the toast. .PARAMETER Theme Light or dark theme. .PARAMETER Icon The icon to display in the toast. .PARAMETER IconColor The color of the icon. .PARAMETER Position Where to display the toast. .PARAMETER HideCloseButton Hides the close button. .PARAMETER CloseOnClick Closes the toast when clicked. .PARAMETER CloseOnEscape Closes the toast when esc is pressed. .PARAMETER ReplaceToast Replaces an existing toast if one is already showing. .PARAMETER RightToLeft Right to left text. .PARAMETER Balloon Creates a balloon toast. .PARAMETER Overlay Displays an overlay behind the toast. .PARAMETER OverlayClose Allow the user to close the overlay. .PARAMETER OverlayColor The color of the overlay. .PARAMETER TransitionIn The transition in effect. .PARAMETER TransitionOut The transition out effect. .PARAMETER Broadcast Broadcasts the toast to all connected users. .PARAMETER Persistent Prevents the toast from closing due to the duration. .EXAMPLE Show-UDToast -Message 'Hello, World!' Shows a toast message. #> param( [Parameter(Mandatory, Position = 0)] [string]$Message, [Parameter()] [DashboardColor]$MessageColor, [Parameter()] [string]$MessageSize, [Parameter()] [int]$Duration = 1000, [Parameter()] [string]$Title, [Parameter()] [DashboardColor]$TitleColor, [Parameter()] [string]$TitleSize, [Parameter()] [string]$Id = [Guid]::NewGuid(), [Parameter()] [DashboardColor]$BackgroundColor, [Parameter()] [ValidateSet("light", "dark")] [string]$Theme, [Parameter()] [object]$Icon, [Parameter()] [DashboardColor]$IconColor, [Parameter()] [ValidateSet("bottomRight", "bottomLeft", "topRight", "topLeft", "topCenter", "bottomCenter", "center")] [string]$Position = "topRight", [Parameter()] [Switch]$HideCloseButton, [Parameter()] [Switch]$CloseOnClick, [Parameter()] [Switch]$CloseOnEscape, [Parameter()] [Switch]$ReplaceToast, [Parameter()] [Switch]$RightToLeft, [Parameter()] [Switch]$Balloon, [Parameter()] [Switch]$Overlay, [Parameter()] [Switch]$OverlayClose, [Parameter()] [DashboardColor]$OverlayColor, [Parameter()] [ValidateSet("bounceInLeft", "bounceInRight", "bounceInUp", "bounceInDown", "fadeIn", "fadeInDown", "fadeInUp", "fadeInLeft", "fadeInRight", "flipInX")] [string]$TransitionIn = "fadeInUp", [Parameter()] [ValidateSet("bounceInLeft", "bounceInRight", "bounceInUp", "bounceInDown", "fadeIn", "fadeInDown", "fadeInUp", "fadeInLeft", "fadeInRight", "flipInX")] [string]$TransitionOut = "fadeOut", [Parameter()] [Switch]$Broadcast, [Parameter()] [Switch]$Persistent ) $faIcon = $null if ($Icon -is [Hashtable]) { $UDIcon = $Icon } else { if ($PSBoundParameters.ContainsKey('Icon') -and -not $Icon.StartsWith('fa')) { $faIcon = "fa fa-$($Icon.ToLower().Replace("_", "-"))" } elseif ($PSBoundParameters.ContainsKey('Icon')) { $faIcon = $Icon } } if ($Persistent) { $Duration = $false } # if ($id -notmatch '^[a-zA-Z0-9]+$') { # throw "Invalid ID. ID must be alphanumeric." # } $options = @{ close = -not $HideCloseButton.IsPresent id = "x" + $Id message = $Message messageColor = $MessageColor.HtmlColor messageSize = $MessageSize title = $Title titleColor = $TitleColor.HtmlColor titleSize = $TitleSize timeout = $Duration position = $Position backgroundColor = $BackgroundColor.HtmlColor theme = $Theme icon = $faIcon iconColor = $IconColor.HtmlColor displayMode = if ($ReplaceToast.IsPresent) { 2 } else { 0 } rtl = $RightToLeft.IsPresent balloon = $Balloon.IsPresent overlay = $Overlay.IsPresent overlayClose = $OverlayClose.IsPresent overlayColor = $OverlayColor.HtmlColor closeOnClick = $CloseOnClick.IsPresent closeOnEscape = $CloseOnEscape.IsPresent transitionIn = $TransitionIn transitionOut = $TransitionOut udIcon = $UDIcon } if ($Broadcast) { $DashboardHub.SendWebSocketMessage("showToast", $options) } else { $DashboardHub.SendWebSocketMessage($ConnectionId, "showToast", $options) } } function Start-UDDownload { <# .SYNOPSIS Starts the download of a file within the dashboard. .DESCRIPTION Starts the download of a file within the dashboard. Only text files are supported .PARAMETER FileName The name of the file. .PARAMETER StringData The data to be written to the file. .PARAMETER ContentType The content type of the file. .PARAMETER Url A URL to download as string data and send to the user. .EXAMPLE New-UDButton -Text 'Click Me' -OnClick { Start-UDDownload -FileName 'myfile.txt' -StringData 'Hello World' -ContentType 'text/plain' } #> param( [Parameter()] [string]$FileName = "text.txt", [Parameter(Mandatory, ParameterSetName = 'String')] [string]$StringData, [Parameter()] [string]$ContentType = "text/plain", [Parameter(Mandatory, ParameterSetName = 'Url')] [string]$Url ) if ($Url) { $WebRequest = Invoke-WebRequest -Uri $Url $StringData = $WebRequest.Content $ContentType = $WebRequest.Headers["Content-Type"] } $Data = @{ fileName = $FileName stringData = $StringData contentType = $ContentType } $DashboardHub.SendWebSocketMessage($ConnectionId, "download", $data) } function Sync-UDElement { <# .SYNOPSIS Causes an element to update. .DESCRIPTION Causes an element to update. Not all elements can be updated. For elements that cannot be updated, wrap them in New-UDDynamic and update that. .PARAMETER Id The ID of the element to update. .PARAMETER Broadcast Whether to broadcast the update to all clients. .EXAMPLE New-UDDyanmic -Id 'dateTime' -Content { Get-Date } New-UDButton -Text 'Refresh' -Content { Sync-UDElement 'dateTime' } #> param( [Parameter(Mandatory, ValueFromPipeline)] [string[]]$Id, [Parameter()] [Switch]$Broadcast ) Process { foreach ($i in $Id) { if ($Broadcast) { $DashboardHub.SendWebSocketMessage("syncElement", $I) } else { $DashboardHub.SendWebSocketMessage($ConnectionId, "syncElement", $I) } } } } function Wait-UDDebugger { param( [Parameter()] $Variable = "*" ) $Variables = Get-Variable -Name $Variable -Scope 2 | Where-Object { $null -ne $_.Name } | ForEach-Object { ConvertTo-TreeData -Variable $_ -Prefix '$' } # | Group-Object -Property Name, Path | ForEach-Object { $_.Group | Select-Object -First 1 } $data = @{ Callstack = Get-PSCallStack | Out-String Id = [Guid]::NewGuid() RunspaceId = $Host.Runspace.Id ProcessId = $PID Variables = $Variables } $DashboardHub.SendWebSocketMessage($ConnectionId, "debugger", $data) $UDDebugger.Wait($data.Id) } function ConvertTo-TreeData { [CmdletBinding()] param( [Parameter()] [string]$Path = '', [Parameter(Mandatory, ValueFromPipeline)] $Variable, [Parameter()] $Depth = 3, [Parameter()] $Items, [Parameter()] $Prefix ) Process { $root = $null -eq $Items if ($Depth -eq 0) { return } if ($null -eq $Items) { $Items = [System.Collections.Generic.Dictionary[string, object]]::new() } $ChildPath = $Path $ChildPath += $Prefix + $Variable.Name $Type = $null if ($null -ne $Variable.Value) { $Type = $Variable.Value.GetType().Name } $Object = [PSCustomObject]@{ Name = $Variable.Name DisplayValue = [string]$Variable.Value Type = $Type Path = $ChildPath Id = [Guid]::NewGuid() } if (-not $Items.ContainsKey($ChildPath)) { $Items.Add($ChildPath, $Object) } if ($Variable.Value -is [System.Collections.Hashtable] -or $Variable.Value -is [System.Collections.IDictionary]) { $index = 0 $Variable.Value.Keys | ForEach-Object { $Type = $null if ($null -ne $Variable.Value[$_]) { $Var = @{ Name = $_ Value = $Variable.Value[$_] } ConvertTo-TreeData -Path $ChildPath -Variable $Var -Depth ($Depth - 1) -Items $Items -Prefix '/' $Type = $Variable.Value[$_].GetType().Name } $Object = [PSCustomObject]@{ Name = "[$_]" DisplayValue = [string]$_ Type = $Type Path = $ChildPath + '/' + "[$_]" Id = [Guid]::NewGuid() } if (-not $Items.ContainsKey($ChildPath)) { $Items.Add($ChildPath, $Object) } $Index++ } } elseif (($Variable.Value -is [System.Collections.IEnumerable]) -and $Variable.Value -isnot [string]) { $index = 0 $Variable.Value | ForEach-Object { if ($null -ne $_) { $Var = @{ Name = "[$index]" Value = $_ } ConvertTo-TreeData -Path $ChildPath -Variable $Var -Depth ($Depth - 1) -Items $Items -Prefix '/' } $Type = $null if ($null -ne $_) { $Type = $_.GetType().Name } $Object = [PSCustomObject]@{ Name = "[$index]" DisplayValue = [string]$_ Type = $Type Path = $ChildPath + '/' + "[$index]" Id = ([Guid]::NewGuid()) } if (-not $Items.ContainsKey($ChildPath)) { $Items.Add($ChildPath, $Object) } $Index++ } } else { $Variable.Value.PSObject.Properties | ForEach-Object { if ($null -ne $_.Value -and $_.Value -isnot [string]) { ConvertTo-TreeData -Path $ChildPath -Variable $_ -Depth ($Depth - 1) -Items $Items -Prefix '/' } $Object = [PSCustomObject]@{ Name = $_.Name DisplayValue = [string]$_.Value Type = $_.TypeNameOfValue Path = $ChildPath + '/' + $_.Name Id = ([Guid]::NewGuid()) } if (-not $Items.ContainsKey($ChildPath)) { $Items.Add($ChildPath, $Object) } } } if ($root) { $Items.Values } } } function New-UDMapBaseLayer { param( [Parameter()] [string]$Id = ([Guid]::NewGuid()), [Parameter(Mandatory)] [string]$Name, [Parameter(Mandatory)] [ScriptBlock]$Content, [Parameter()] [Switch]$Checked ) @{ type = "map-base-layer" isPlugin = $true assetId = $AssetId id = $Id name = $Name content = & $Content checked = $Checked.IsPresent } } function New-UDMapMarkerClusterLayer { param( [Parameter()] [string]$Id = ([Guid]::NewGuid()), [Parameter()] [Hashtable[]]$Markers, [Parameter()] [int]$MinimumClusterSize = 2, [Parameter()] [int]$GridSize = 60 ) @{ type = "map-cluster-layer" isPlugin = $true assetId = $assetId id = $id markers = $Markers minClusterSize = $MinimumClusterSize gridSize = $GridSize } } function New-UDMapFeatureGroup { param( [Parameter()] [string]$Id = ([Guid]::NewGuid()), [Parameter()] [Hashtable]$Popup, [Parameter(Mandatory)] [ScriptBlock]$Content ) End { @{ type = 'map-feature-group' id = $id isPlugin = $true assetId = $AssetId content = & $Content popup = $Popup } } } function ConvertFrom-GeoJson { param( [Parameter(Mandatory, ValueFromPipeline)] [PSCustomObject[]]$GeoJson, [Parameter()] [PSCustomObject[]]$Icons ) Process { $Json = $GeoJson $Json | ForEach-Object { if ($_.type -eq 'FeatureCollection') { $features = foreach($Feature in $_.features) { $Feature | ConvertFrom-GeoJson -Icons $Icons } New-UDMapOverlay -Name $_.properties.name -Content { New-UDMapFeatureGroup -Content { $features } } -Checked } if ($_.type -eq 'feature') { $Geometry = $_.geometry | ConvertFrom-GeoJson -Icons $Icons if ($_.properties.DisplayText) { $Geometry.Popup = New-UDMapPopup -Content { New-UDHtml $_.properties.DisplayText } } if ($_.style.color -and $Geometry.type -ne "map-marker") { $Geometry.FillColor = $_.style.color $Geometry.Color = $_.style.color if ($_.style.weight) { $Geometry.Weight = $_.style.weight } } if ($_.style.color -and $Geometry.type -eq "map-marker") { $iconName = $_.style.color $Icon = $Icons | Where-Object { $_.IconName -eq $iconName } if ($null -ne $Icon) { $Geometry.Icon = New-UDMapIcon -Url "http://emaps.papertransport.com/e_img/$($Icon.IconFileName)" -Width $Icon.IconWidth -Height $Icon.IconHeight -AnchorX $Icon.IconAnchorX -AnchorY $Icon.IconHeight -PopupAnchorX $Icon.IconPopupX -PopupAnchorY $Icon.IconPopupY } } $Geometry } if ($_.type -eq 'polygon') { $Coordinates = @() $_.coordinates[0] | ForEach-Object { $temp = $_[0] $_[0] = $_[1] $_[1] = $temp $Coordinates += ,$_ } New-UDMapVectorLayer -Polygon -Positions $Coordinates -FillOpacity .5 } if ($_.type -eq 'point') { $Coordinates = $_.coordinates New-UDMapMarker -Latitude $coordinates[1] -Longitude $coordinates[0] -Zindex $_.style.zIndexOffset } if ($_.type -eq 'linestring') { $Coordinates = $_.coordinates New-UDMapMarker -Latitude $coordinates[1] -Longitude $coordinates[0] -Zindex $_.style.zIndexOffset } if ($_.type -eq 'MultiLineString') { $Coordinates = @() foreach($array in $_.coordinates) { foreach($arrayInArray in $array) { $temp = $arrayInArray[0] $arrayInArray[0] = $arrayInArray[1] $arrayInArray[1] = $temp $Coordinates += ,$arrayInArray } } New-UDMapVectorLayer -Polyline -Positions $Coordinates } } } } function New-UDMapHeatmapLayer { param( [Parameter(Mandatory)] $Points, [Parameter()] [string]$Id = ([Guid]::NewGuid()), [Parameter()] [double]$MaxIntensity, [Parameter()] [double]$Radius, [Parameter()] [int]$MaxZoom, [Parameter()] [double]$MinOpacity, [Parameter()] [int]$Blur, [Parameter()] [Hashtable]$Gradient ) $Options = @{ type = 'map-heatmap-layer' isPlugin = $true assetId = $AssetId } foreach($boundParameter in $PSCmdlet.MyInvocation.BoundParameters.GetEnumerator()) { $Options[[char]::ToLowerInvariant($boundParameter.Key[0]) + $boundParameter.Key.Substring(1)] = $boundParameter.Value } $Options } function New-UDMapIcon { param( [Parameter(Mandatory)] [string]$Url, [Parameter()] [int]$Height, [Parameter()] [int]$Width, [Parameter()] [int]$AnchorX, [Parameter()] [int]$AnchorY, [Parameter()] [int]$PopupAnchorX, [Parameter()] [int]$PopupAnchorY ) $Options = @{ } foreach($boundParameter in $PSCmdlet.MyInvocation.BoundParameters.GetEnumerator()) { $Options[[char]::ToLowerInvariant($boundParameter.Key[0]) + $boundParameter.Key.Substring(1)] = $boundParameter.Value } $Options } function New-UDMapLayerControl { param( [Parameter()] [string]$Id = ([Guid]::NewGuid()), [Parameter()] [ValidateSet("topright", "topleft", "bottomright", "bottomleft")] [string]$Position = "topright", [Parameter()] [ScriptBlock]$Content ) @{ type = 'map-layer-control' isPlugin = $true assetId = $AssetId id = $Id content = & $Content position = $Position } } function New-UDMap { param( [Parameter()] [string]$Id = ([Guid]::NewGuid()), [Parameter()] [float]$Longitude, [Parameter()] [float]$Latitude, [Parameter()] [int]$Zoom, [Parameter()] [string]$Height = '500px', [Parameter()] [string]$Width = '100%', [Parameter(Mandatory)] [Endpoint]$Endpoint, [ValidateSet("topright", "topleft", "bottomright", "bottomleft")] [string]$ZoomControlPosition = "topright", [ValidateSet("topright", "topleft", "bottomright", "bottomleft", "hide")] [string]$ScaleControlPosition = "bottomleft", [Parameter()] [Switch]$Animate, [Parameter()] [int]$MaxZoom = 18 ) End { $Endpoint.Register($Id, $PSCmdlet) @{ assetId = $AssetId isPlugin = $true type = "ud-map" id = $Id longitude = $Longitude latitude = $Latitude zoom = $Zoom height = $Height width = $Width zoomControlPosition = $ZoomControlPosition animate = $Animate.IsPresent scaleControlPosition = $ScaleControlPosition maxZoom = $MaxZoom endpoint = $Endpoint } } } function New-UDMapMarker { param( [Parameter()] [string]$Id = ([Guid]::NewGuid()), [Parameter(ParameterSetName = "LatLng", Mandatory)] [float]$Longitude, [Parameter(ParameterSetName = "LatLng", Mandatory)] [float]$Latitude, [Parameter()] [string]$Attribution, [Parameter()] [int]$Opacity, [Parameter()] [int]$ZIndex, [Parameter()] [Hashtable]$Popup, [Parameter()] [Hashtable]$Icon, [Parameter(ParameterSetName = "GeoJSON", Mandatory)] [string]$GeoJSON ) if ($PSCmdlet.ParameterSetName -eq 'GeoJSON') { $Json = $GeoJSON | ConvertFrom-Json $Coordinates = $Json.Geometry.Coordinates $Latitude = $Coordinates[1] $Longitude = $Coordinates[0] } @{ type = "map-marker" isPlugin = $true assetId = $AssetId id = $id longitude = $Longitude latitude = $Latitude attribution = $Attribution opacity = $Opacity zIndex = $ZIndex popup = $Popup icon = $Icon } } function New-UDMapOverlay { param( [Parameter()] [string]$Id = ([Guid]::NewGuid()), [Parameter(Mandatory)] [string]$Name, [Parameter(Mandatory)] [ScriptBlock]$Content, [Parameter()] [Switch]$Checked ) @{ type = 'map-overlay' isPlugin = $true assetId = $AssetId id = $id name = $Name content = & $Content checked = $Checked.IsPresent } } function New-UDMapPopup { param( [Parameter()] [string]$Id = ([Guid]::NewGuid()), [Parameter()] [ScriptBlock]$Content, [Parameter()] [float]$Longitude, [Parameter()] [float]$Latitude, [Parameter()] [int]$MaxWidth, [Parameter()] [int]$MinWidth ) $Options = @{ type = "map-popup" isPlugin = $true assetId = $AssetId id = $id content = & $Content maxWidth = $MaxWidth minWidth = $MinWidth } if ($PSCmdlet.MyInvocation.BoundParameters.ContainsKey("Longitude")) { $Options["longitude"] = $Longitude } if ($PSCmdlet.MyInvocation.BoundParameters.ContainsKey("Latitude")) { $Options["latitude"] = $Latitude } $Options } function New-UDMapRasterLayer { param( [Parameter()] [string]$Id = ([Guid]::NewGuid()), [Parameter(ParameterSetName = "Generic")] [string]$TileServer = 'https://a.tile.openstreetmap.org/{z}/{x}/{y}.png', [Parameter(ParameterSetName = "Bing", Mandatory)] [string]$ApiKey, [Parameter(ParameterSetName = "Bing")] [ValidateSet("Aerial", "AerialWithLabels", "AerialWithLabelsOnDemand", "CanvasDark", "CanvasLight", "CanvasGray", "Road")] [string]$Type = "Aerial", [Parameter(ParameterSetName = "Bing", Mandatory)] [Switch]$Bing, [Parameter()] [string]$Attribution, [Parameter()] [int]$Opacity, [Parameter()] [int]$ZIndex, [Parameter()] [string]$Name ) @{ type = "map-raster-layer" isPlugin = $true assetId = $AssetId id = $id tileServer = $TileServer apiKey = $ApiKey attribution = $Attribution opacity = $Opactiy zIndex = $ZIndex name = $Name bing = $Bing.IsPresent mapType = $Type } } function New-UDMapVectorLayer { param( [Parameter()] [string]$Id = ([Guid]::NewGuid()), [Parameter()] [UniversalDashboard.Models.DashboardColor]$Color = 'black', [Parameter()] [UniversalDashboard.Models.DashboardColor]$FillColor = 'black', [Parameter()] [double]$FillOpacity = 0.5, [Parameter()] [int]$Weight = 3, [Parameter()] [double]$Opacity = 1.0, [Parameter(ParameterSetName = 'Circle', Mandatory)] [Switch]$Circle, [Parameter(ParameterSetName = 'Circle', Mandatory)] [double]$Latitude, [Parameter(ParameterSetName = 'Circle', Mandatory)] [double]$Longitude, [Parameter(ParameterSetName = 'Circle', Mandatory)] [int]$Radius, [Parameter(ParameterSetName = 'Polyline', Mandatory)] [Switch]$Polyline, [Parameter(ParameterSetName = 'Polygon', Mandatory)] [Switch]$Polygon, [Parameter(ParameterSetName = 'Polyline', Mandatory)] [Parameter(ParameterSetName = 'Polygon', Mandatory)] [object]$Positions, [Parameter(ParameterSetName = 'Rectangle', Mandatory)] [Switch]$Rectangle, [Parameter(ParameterSetName = 'Rectangle', Mandatory)] [double]$LatitudeTopLeft, [Parameter(ParameterSetName = 'Rectangle', Mandatory)] [double]$LongitudeTopLeft, [Parameter(ParameterSetName = 'Rectangle', Mandatory)] [double]$LatitudeBottomRight, [Parameter(ParameterSetName = 'Rectangle', Mandatory)] [double]$LongitudeBottomRight, [Parameter(ParameterSetName = 'Circle')] [object]$Popup, [Parameter(ParameterSetName = 'GeoJSON', Mandatory)] [string]$GeoJSON ) if ($PSCmdlet.ParameterSetName -eq 'GeoJSON') { $Json = $GeoJSON | ConvertFrom-Json if ($Json.Geometry.Type -eq 'multilinestring') { $Coordinates = @() foreach($array in $json.geometry.coordinates) { foreach($arrayInArray in $array) { $temp = $arrayInArray[0] $arrayInArray[0] = $arrayInArray[1] $arrayInArray[1] = $temp } $Coordinates += ,$array } $Positions = $Coordinates $Polyline = [Switch]::Present } if ($Json.Geometry.Type -eq 'linestring') { $Coordinates = @() $json.geometry.coordinates | ForEach-Object { $temp = $_[0] $_[0] = $_[1] $_[1] = $temp $Coordinates += ,$_ } $Positions = $Coordinates $Polyline = [Switch]::Present } if ($Json.Geometry.Type -eq 'polygon') { $Coordinates = @() $json.geometry.coordinates[0] | ForEach-Object { $temp = $_[0] $_[0] = $_[1] $_[1] = $temp $Coordinates += ,$_ } $Positions = $Coordinates $Polygon = [Switch]::Present } } @{ type = "map-vector-layer" isPlugin = $true assetId = $AssetId id = $Id color = $Color.HtmlColor fillColor = $FillColor.HtmlColor fillOpacity = $FillOpacity weight = $Weight opacity = $Opacity circle = $Circle.IsPresent latitude = $Latitude longitude = $Longitude radius = $Radius polyline = $Polyline.IsPresent polygon = $Polygon.IsPresent positions = $Positions rectangle = $Rectangle.IsPresent latitudeTopLeft = $LatitudeTopLeft longitudeTopLeft = $LongitudeTopLeft latitudeBottomRight = $LatitudeBottomRight longitudeBottomRight = $LongitudeBottomRight popup = $Popup } } |