Public/Elements/New-AMColumnSet.ps1
|
function New-AMColumnSet { <# .SYNOPSIS Creates a ColumnSet element for an Adaptive Card. .DESCRIPTION Creates a ColumnSet element that allows you to arrange content in multiple columns. ColumnSets are one of the primary layout elements in Adaptive Cards and enable side-by-side content arrangement. A ColumnSet contains one or more Column objects, each created with the New-AMColumn function. Each column can contain its own set of elements (text, images, etc.). .PARAMETER Id A unique identifier for the ColumnSet. This ID can be used to reference the ColumnSet when adding elements to it, or when targeting it with visibility toggle actions. .PARAMETER Columns An array of Column objects created using the New-AMColumn function. These columns will be displayed side-by-side within the ColumnSet. .EXAMPLE # Create a simple two-column layout $leftColumn = New-AMColumn -Width "1" -Items @( (New-AMTextBlock -Text "Left Column Content" -Wrap $true) ) $rightColumn = New-AMColumn -Width "1" -Items @( (New-AMTextBlock -Text "Right Column Content" -Wrap $true) ) $columnSet = New-AMColumnSet -Id "two-column-layout" -Columns @($leftColumn, $rightColumn) Add-AMElement -Card $card -Element $columnSet .EXAMPLE # Create a profile card with image and info $imageColumn = New-AMColumn -Width "auto" -Items @( (New-AMImage -Url "https://example.com/profile.jpg" -Size "Small") ) $infoColumn = New-AMColumn -Width "stretch" -Items @( (New-AMTextBlock -Text "Jane Smith" -Size "Medium" -Weight "Bolder"), (New-AMTextBlock -Text "Senior Engineer" -Spacing "None"), (New-AMTextBlock -Text "Department: R&D" -Spacing "Small") ) $profileLayout = New-AMColumnSet -Id "profile-card" -Columns @($imageColumn, $infoColumn) Add-AMElement -Card $card -Element $profileLayout .EXAMPLE # Create a three-column layout with different widths $col1 = New-AMColumn -Width "2" -Items @( (New-AMTextBlock -Text "Column 1 (Width 2)") ) $col2 = New-AMColumn -Width "1" -Items @( (New-AMTextBlock -Text "Column 2 (Width 1)") ) $col3 = New-AMColumn -Width "1" -Items @( (New-AMTextBlock -Text "Column 3 (Width 1)") ) $threeColumnLayout = New-AMColumnSet -Id "proportional-columns" -Columns @($col1, $col2, $col3) Add-AMElement -Card $card -Element $threeColumnLayout .INPUTS None. You cannot pipe input to New-AMColumnSet. .OUTPUTS System.Collections.Hashtable Returns a hashtable representing the ColumnSet element. .NOTES ColumnSets are powerful layout tools in Adaptive Cards. Some key points: - You can create responsive layouts by using proportional widths ("1", "2", etc.) - Use "auto" width for columns that should be sized to their content - Use "stretch" width for columns that should fill remaining space - Each column can have its own vertical alignment The resulting ColumnSet can be added directly to a card body or to another container element using Add-AMElement. .LINK https://adaptivecards.io/explorer/ColumnSet.html #> param ( [Parameter(Mandatory = $true)] [string]$Id, [Parameter(Mandatory = $true)] [array]$Columns ) $columnSet = @{ type = "ColumnSet" id = $Id columns = @() } foreach ($column in $Columns) { $columnSet.columns += $column } return $columnSet } Export-ModuleMember -Function New-AMColumnSet |