-
Notifications
You must be signed in to change notification settings - Fork 76
Description
Approved from Toolkit
Problem Statement:
THere are currently no controls in WinUI or the Toolkit that allows for creating consistent settings experiences that can be found across Windows 11. This experiment introduces a SettingsCard component that allows to display simple cards.
SettingsExpander will be an follow-up experiment to introduce collapsible cards.
Overview
This experiment adds the following components:
- SettingsCard a simple card component that allows for displaying a setting. The
IsClickEnabled
property can be used to turn it into a Button-like control. - SettingsExpander a control that uses the same properties as
SettingsCard
, andSettingsCard
can be used to set the SettingsExpander.Items. Binding is also supported.
Media1.mp4
Using
You can try it out via the NuGet Packages here:
- UWP: https://dev.azure.com/dotnet/CommunityToolkit/_artifacts/feed/CommunityToolkit-Labs/NuGet/CommunityToolkit.Labs.Uwp.SettingsControls
- WinUI 3: https://dev.azure.com/dotnet/CommunityToolkit/_artifacts/feed/CommunityToolkit-Labs/NuGet/CommunityToolkit.Labs.WinUI.SettingsControls
SettingsCard (doc + samples)
SettingsExpander (doc + samples)
Read more about Preview Packages here.
CommunityToolkit members can also try it out with Codespaces.
TO DO
- Tests
Implementation Requirements
Not all these items are required to submit a PR. This list is here to help track what is remaining to implement before a technical review and discussion of moving into the main repository can occur.
- Working Prototype
- Feature Complete
- Documentation
- Samples
- Tests
- Community Feedback / Usage Testimonies
Tested Platforms
- UWP
- WinAppSDK / WinUI 3
- Web Assembly (WASM)
- Android
- iOS
- MacOS
- Linux / GTK
Technical Review
These items can sometimes be done ahead of time, but are usually started and completed after all implementation details are finished.
- Accessibility Audit
- API/Naming Review
- Code Quality/Style
- Dependency Review
- Design/Style Review
- Final Approval
Metadata
Metadata
Assignees
Labels
Type
Projects
Status
Status