-
Notifications
You must be signed in to change notification settings - Fork 1.4k
Building XAML Controls
Rosario Pulella edited this page Sep 23, 2020
·
4 revisions
We encourage developers to follow the following guidelines when submitting pull requests for controls:
- Your control must be usable and efficient with the keyboard only.
- Tab order must be logical.
- Focused controls must be visible.
- Action must be triggered when hitting the Enter key.
- Do not use custom colors but instead rely on theme colors so high contrasts themes can be used with your control.
- Add AutomationProperties.Name on all controls to define the controlβs purpose (Name is minimum, but there are some other things too that can help the screen reader).
- Don't use the same Name on two different elements unless they have different control types.
- Use Narrator Dev mode (Launch Narrator [WinKey+Enter], then CTRL+F12) to test the screen reader experience. Is the information sufficient, meaningful and helps the user navigate and understand your control.
- Ensure that you have run your XAML file changes through Xaml Styler (version 2.3+), which can be downloaded from here. Do not worry about the settings for this as they are set at the project level (settings.xamlstyler).
You can find more information about these topics here
This is to help as part of our effort to build an accessible toolkit (starting with 1.2)
Fork the repo and Send the PR ππ
Any changes to the wiki made directly here on GitHub will be overwritten by the wiki repo commits
- Home π
- Welcome π
- Windows Community Toolkit π§°
- Features π¬
- Principles βοΈ
- Roadmap πΊ
- .NET Foundation
- Why Microsoft supports this project
- License π
- Sample App π±
- Getting Started π
- NuGet Packages π¦
- Preview Packages π
- Toolkit Labs π§ͺ
- Questions β
- Discussions π₯
- Submitting an Issue βοΈ
- Good First Issue π
- Help Wanted π
- Bug Fixes π
- Feature Requests π«
- Create and Submit PullRequest π
- Documentation π
- Review PR π
- Avoid Roadblocks π§
- Quick Start β‘
- Required Dependencies π
- Coding Style and Conventions β
- Testing π§ͺ
- Sample Development π±
- Accessibility Guideline βΏ
- Building XAML Controls π
- Fabric Bot Services π€
- CI and Infrastructure πΎ
- How the Project is Organized ποΈ
- Join the Toolkit Organization πͺ
- Hall of Fame π