New-UDBadge

Badge generates a small badge to the top-right of its child(ren).

Synopsis

Badge generates a small badge to the top-right of its child(ren).

Syntax

New-UDBadge [[-Id] <String>] [[-Color] <String>] [[-Children] <ScriptBlock>] [[-BadgeContent] <ScriptBlock>] [-Invisible] [[-Max] <Int32>] [[-Overlap] <String>] [-ShowZero] [[-Variant] <String>] [[-Location] <String>] [[-Sx] <Hashtable>] [<CommonParameters>]

Description

Badge generates a small badge to the top-right of its child(ren).

Parameters

-Id

The ID of the component. It defaults to a random GUID.

Required?                    false
Position?                    1
Default value                ([Guid]::NewGuid()).ToString()
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Color

The color of the badge. Valid values are: "default", "primary", "secondary", "error", "info", "success", "warning"

Required?                    false
Position?                    2
Default value                primary
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Children

The content that the badge is attached to.

Required?                    false
Position?                    3
Default value                {}
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-BadgeContent

The content to display within the badge.

Required?                    false
Position?                    4
Default value                {}
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

    -Invisible [<SwitchParameter>]
        Whether the badge is invisible.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Max

The maximum number to display. If the number is greater than this, it will display as "99+". Default is 99.

Required?                    false
Position?                    5
Default value                99
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Overlap

The overlap of the badge. Valid values are: "circular", "rectangular"

Required?                    false
Position?                    6
Default value                rectangular
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

    -ShowZero [<SwitchParameter>]
        Whether to show the badge when the badgeContent is 0.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Variant

The variant of the badge. Valid values are: "standard", "dot"

Required?                    false
Position?                    7
Default value                standard
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Location

The location of the badge. Valid values are: "topright", "topleft", "bottomright", "bottomleft"

Required?                    false
Position?                    8
Default value                topright
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Sx

Required?                    false
Position?                    9
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer, PipelineVariable, and OutVariable. For more information, see
        about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Notes

General notes

    [Component("Badge", "Badge", "Creates a new badge.")]

-------------------------- EXAMPLE 1 --------------------------

PS >New-UDBadge -Color primary -BadgeContent { 4 } -Children {
PS >   New-UDButton -Text "Primary"
PS > } -Id 'badge1'

Primary badge|Displays a badge with the text "4" on a primary button.




-------------------------- EXAMPLE 2 --------------------------

PS >New-UDBadge -Color secondary -BadgeContent { 4 } -Children {
PS >   New-UDIcon -Icon Envelope -Size 2x
PS > } -Id 'badge2'
PS > New-UDBadge -Color error -BadgeContent { 4 } -Children {
PS >   New-UDIcon -Icon Envelope -Size 2x
PS > } -Id 'badge3'

Color|Changes the color of the badge.




-------------------------- EXAMPLE 3 --------------------------

PS >New-UDBadge -ShowZero -BadgeContent { 0 } -Children {
PS >   New-UDIcon -Icon Envelope -Size 2x
PS > } -Id 'badge4'

ShowZero|Shows the badge when the badgeContent is 0.




-------------------------- EXAMPLE 4 --------------------------

PS >New-UDBadge -Max 10 -BadgeContent { 11 } -Children {
PS >   New-UDIcon -Icon Envelope -Size 2x
PS > } -Id 'badge5'

Max|The maximum number to display. If the number is greater than this, it will display as "99+". Default is 99.




-------------------------- EXAMPLE 5 --------------------------

PS >New-UDBadge -Overlap circular -BadgeContent { 4 } -Children {
PS >   New-UDIcon -Icon Envelope -Size 2x
PS > } -Id 'badge6'

Overlap|The overlap of the badge.




-------------------------- EXAMPLE 6 --------------------------

PS >New-UDBadge -Variant dot -BadgeContent { 4 } -Children {
PS >   New-UDIcon -Icon Envelope -Size 2x
PS > } -Id 'badge7'

Dot|Display a dot badge.