Separated Select options into their own Option and OptionGroup elements; Added -HelpText for Range, Checkbox, Radio, and Select elements; Added a new Datalist element

[Badgerati]

Description of the Change

This reworks how Selects and Options work - to enable support for the Datalist element, further control over Option attributes (like the missing Disabled), and also support for Option Grouping via <optgroup>. Also, the -HelpText parameter has been added to the Range, Checkbox, Radio, and Select elements - including Datalist.

For example, the following previous Select element:

New-PodeWebSelect -Name 'Example' -Options @('Option1', 'Option2') -SelectedValue 'Option1'

Would now be the following instead:

New-PodeWebSelect -Name 'Example' -Options @(
    New-PodeWebOption -Name 'Option1' -Selected
    New-PodeWebOption -Name 'Option2'
)

To assist with most migrations there is a helper function: ConvertTo-PodeWebOption. You can pipe an original raw string array into this, along with an optional -SelectedOption value, and it will convert to strings into Option elements for you:

New-PodeWebSelect -Name 'Example' -Options @(
    @('Option1', 'Option2') | ConvertTo-PodeWebOption -SelectedOption 'Option1'
)

The migration guide has been updated, including docs.

Related Issue

• Resolves Combobox / Datalist / select #602
• Resolves -HelpText for New-PodeWebSelect #620