MaterialDesignInXAML / MaterialDesignInXAML/MaterialDesignInXamlToolkit

Add documentation for combobox

Open
#1,177 13 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

good first issue Hacktoberfest up-for-grabs wiki
Dominant language
C#
Stars
16.3k
Forks
3.5k
Avg merge
1d 22h
Merged PRs (30d)
8

Description

There are several additional features provided by the combo box that are not that easy to discover and should be documented.

  • Add a page to the Wiki for ComboBox
  • Add a link to it in the sidebar under Controls
  • Document the two possible styles for ComboBox (MaterialDesignComboBox - this is the default, and MaterialDesignFloatingHintComboBox)
  • Document that in addition to the default brushes on ComboBox there are a couple attached properties for changing colors. These are TextFieldAssist.UnderlineBrush for changing the color of the underline when the ComboBox is editable and the user is editing. HintAssist.Foreground for changing the color of the hint (when it is used).
  • Document the ComboBoxAssist.ClassicMode attached property. When this is set to true it will cause the popup with the items to display strictly outside of the ComboBox rather than around it. This is more closely aligned with the default WPF ComboBox.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the repository Wiki and the sidebar entry under Controls, then use the issue checklist as the requirements. Confirm the ComboBox page covers both styles, the TextFieldAssist.UnderlineBrush and HintAssist.Foreground properties, and ComboBoxAssist.ClassicMode; done means all listed items are documented and linked.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.