-
Notifications
You must be signed in to change notification settings - Fork 123
Building XAML Controls
Arlo Godfrey edited this page Mar 12, 2024
·
1 revision
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.

- Home ๐
- Welcome ๐
- Principles โ๏ธ
- Roadmap ๐บ
- .NET Foundation
- Why Microsoft supports this project
- License ๐
- Getting Started ๐
- Sample App ๐ฑ
- NuGet Packages ๐ฆ
- Preview Packages ๐
- Toolkit Labs ๐งช
- Questions โ
- Discussions ๐ฅ
- Submitting an Issue โ๏ธ
- Good First Issue ๐
- Help Wanted ๐
- Bug Fixes ๐
- Feature Requests ๐ซ
- Component Quality Evaluation ๐ฎ
- Create and Submit PullRequest ๐
- Documentation ๐
- Review PR ๐
- Avoid Roadblocks ๐ง
- Required Dependencies ๐
- Quick Start โก
- Sample Development ๐ฑ
- Testing ๐งช
- Accessibility Guideline โฟ
- Coding Style and Conventions โ
- Building XAML Controls ๐
- CI and Infrastructure ๐พ
- Updating ToolkitLabs.dev ๐
- Migration Guide from v7 to v8 ๐
- How the Project is Organized ๐๏ธ
- Join the Toolkit Organization ๐ช
- Hall of Fame ๐