From cea36384dec0c2cf792e5cbf64a6f7a024eea8e8 Mon Sep 17 00:00:00 2001 From: Lucas Schmutzler <9322695+g4m3r0@users.noreply.github.com> Date: Sun, 5 Oct 2025 04:18:19 -0300 Subject: [PATCH 1/4] docs: Add ComboBox style documentation Expanded ComboBox documentation with detailed styling options including watermark, clear text button, floating watermark, custom button content, editable mode, and grouping. --- input/docs/styles/combobox.md | 139 +++++++++++++++++++++++++++++++++- 1 file changed, 135 insertions(+), 4 deletions(-) diff --git a/input/docs/styles/combobox.md b/input/docs/styles/combobox.md index 99cfcf0c..c91d8536 100644 --- a/input/docs/styles/combobox.md +++ b/input/docs/styles/combobox.md @@ -1,5 +1,136 @@ -Title: ComboBox -Description: The ComboBox styles ---- +## Title: ComboBox -_coming soon_ +# Default Style + +The standard `ComboBox` is automatically styled when you include the MahApps.Metro library. You can enhance it with helper properties from `TextBoxHelper`. + +----- + +## Watermark + +You can add placeholder text, known as a watermark, which appears when the `ComboBox` has no selected item. + +Add the following attribute to your `ComboBox`: `mah:TextBoxHelper.Watermark="Your placeholder text..."` + +```xml + + + + +``` + +----- + +## ClearText Button + +A button to clear the selected item can be added to the `ComboBox`. + +Set `mah:TextBoxHelper.ClearTextButton="True"` to make the button always visible. + +```xml + + + + +``` + +Alternatively, you can bind its visibility to the `SelectedItem` property, so it only appears when an item is selected. + +```xml + + + + +``` + +----- + +## Floating Watermark + +The watermark can be configured to float above the `ComboBox` like a label when an item is selected. This also works for editable `ComboBoxes`. + +Add the following attribute to apply this style: `mah:TextBoxHelper.UseFloatingWatermark="True"` + +```xml + + + + +``` + +----- + +## Custom Button Content + +You can replace the default dropdown arrow with custom content, such as an icon. This is useful for creating search or filter-like inputs. + +Use the `ButtonCommand`, `ButtonContent`, and `ButtonContentTemplate` properties from `TextBoxHelper` to customize the button. + +```xml + + + + + + + + + +``` + +----- + +## Editable / Auto-Completion + +Set `IsEditable="True"` to allow users to type directly into the `ComboBox`. When combined with an `ItemsSource`, this enables auto-completion. + +For `ComboBoxes` with a large number of items, use the virtualized style for better performance. + +Add the following to a `ComboBox` to apply this style: `Style="{DynamicResource MahApps.Styles.ComboBox.Virtualized}"` + +```xaml + +``` + +----- + +## Grouping + +Items within the dropdown can be grouped under custom headers. This is achieved by setting the ``. + +```xml + + + + + + + + + + + +``` From 6d092bc49a29b263d3f5d562c05891deda2a2382 Mon Sep 17 00:00:00 2001 From: Lucas Schmutzler <9322695+g4m3r0@users.noreply.github.com> Date: Sun, 5 Oct 2025 04:22:15 -0300 Subject: [PATCH 2/4] docs: Update ComboBox styles documentation format Update file with expected header format (Title, Description) --- input/docs/styles/combobox.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/input/docs/styles/combobox.md b/input/docs/styles/combobox.md index c91d8536..b9df680a 100644 --- a/input/docs/styles/combobox.md +++ b/input/docs/styles/combobox.md @@ -1,4 +1,6 @@ -## Title: ComboBox +Title: ComboBox +Description: The ComboBox styles +--- # Default Style From c3f46143166ea3cdea94994d61cfa99961ee0897 Mon Sep 17 00:00:00 2001 From: Lucas Schmutzler <9322695+g4m3r0@users.noreply.github.com> Date: Sun, 5 Oct 2025 04:23:18 -0300 Subject: [PATCH 3/4] docs: Change header from H1 to H2 for ComboBox style --- input/docs/styles/combobox.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/input/docs/styles/combobox.md b/input/docs/styles/combobox.md index b9df680a..0b8aa08c 100644 --- a/input/docs/styles/combobox.md +++ b/input/docs/styles/combobox.md @@ -2,7 +2,7 @@ Title: ComboBox Description: The ComboBox styles --- -# Default Style +## Default Style The standard `ComboBox` is automatically styled when you include the MahApps.Metro library. You can enhance it with helper properties from `TextBoxHelper`. From 32569ba7d28cd53ee157b869969925c6b7ec5732 Mon Sep 17 00:00:00 2001 From: punker76 Date: Mon, 6 Oct 2025 08:51:22 +0200 Subject: [PATCH 4/4] fix(ci): install OpenSSL --- .github/workflows/wyam.yml | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/.github/workflows/wyam.yml b/.github/workflows/wyam.yml index 94d8aaf1..dff9a644 100644 --- a/.github/workflows/wyam.yml +++ b/.github/workflows/wyam.yml @@ -9,7 +9,9 @@ on: jobs: build: runs-on: ubuntu-latest - + env: + # Necessary for installing OpenSSL 1.1 + DOTNET_SYSTEM_GLOBALIZATION_INVARIANT: 1 steps: - name: Checkout uses: actions/checkout@v3 @@ -21,6 +23,10 @@ jobs: dotnet-version: | 2.1.818 6.0.x + - name: Install OpenSSL 1.1 + run: | + wget http://security.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.1f-1ubuntu2.24_amd64.deb + sudo dpkg -i libssl1.1_1.1.1f-1ubuntu2.24_amd64.deb - name: Run the Cake script uses: cake-build/cake-action@v1 with: