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:
diff --git a/input/docs/styles/combobox.md b/input/docs/styles/combobox.md
index 99cfcf0c..0b8aa08c 100644
--- a/input/docs/styles/combobox.md
+++ b/input/docs/styles/combobox.md
@@ -2,4 +2,137 @@ Title: ComboBox
Description: The ComboBox styles
---
-_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
+
+
+
+
+
+
+
+
+
+
+
+```