MaterialDesignInXAML/MaterialDesignInXamlToolkit

Add documentation for combobox

Open

#1,177 opened on Jan 22, 2019

View on GitHub
 (13 comments) (0 reactions) (0 assignees)C# (3,500 forks)batch import
Hacktoberfestgood first issueup-for-grabswiki

Repository metrics

Stars
 (16,143 stars)
PR merge metrics
 (Avg merge 20h 25m) (8 merged PRs in 30d)

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

Research direction
Create a new Wiki page for ComboBox under the Controls section. Document the two styles, attached properties (TextFieldAssist.UnderlineBrush, HintAssist.Foreground), and ComboBoxAssist.ClassicMode. Follow existing Wiki pages for formatting. No linked PRs exist; work is standalone.
Tech stack
csharp
Domain
documentation
Issue type
Documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
Basic knowledge of WPFUnderstanding of ComboBox
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
85