-
Notifications
You must be signed in to change notification settings - Fork 644
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
feat: Add XAML Fundamentals section with pages and examples #1661
base: main
Are you sure you want to change the base?
Conversation
… and navigation updates 1. Added sample code files for Resources, ResourceDictionary, Theme Resources, XAML Styles, Binding, and Templates. 2. Added new assets for theme resource examples and updated control images. 3. Updated `ControlInfoData.json` to include the new "XAML Fundamentals" section. 4. Added pages for Resources, ResourceDictionary, Theme Resources, XAML Styles, Binding, and Templates, each with practical examples. 5. Updated navigation to include the new section and handle its items programmatically.
…vs Binding comparison section
…xaml` with theme adaptability
This comment was marked as resolved.
This comment was marked as resolved.
Adjusted as suggested. |
This comment was marked as resolved.
This comment was marked as resolved.
@niels9001 @karkarl (off-topic) I feel issue #1542 is quickly getting more and more important! |
Did you know? Note Starting in Windows 10, version 1607, the XAML framework provides a built in Boolean to Visibility converter. The converter maps true to the Visible enumeration value and false to Collapsed so you can bind a Visibility property to a Boolean without creating a converter. Note that this is not a feature of function binding, only property binding. To use the built in converter, your app's minimum target SDK version must be 14393 or later. You can't use it when your app targets earlier versions of Windows 10. For more info about target versions, see Version adaptive code. https://learn.microsoft.com/windows/uwp/xaml-platform/x-bind-markup-extension#remarks |
Co-authored-by: Jay <[email protected]>
@Jay-o-Way |
… theme resources. - Simplified the comparison table between `x:Bind` and `Binding` and reduce repetition by using styles. - Added the default binding mode for each type in the comparison table for better clarity. - Removed hardcoded colors and replaced them with theme resources. - Added two new examples: * Demonstrating converters using `x:Bind`. * Showing `Binding` with `FallbackValue` and `TargetNullValue`. - Made minor design tweaks.
… `Function` Co-authored-by: Jay <[email protected]>
Co-authored-by: Jay <[email protected]>
Co-authored-by: Jay <[email protected]>
…nges to enhance readability
Co-authored-by: Jay <[email protected]>
…inUI-Gallery into XAML-Fundamentals
WinUIGallery/ControlPages/XamlFundamentals/XamlResourcesPage.xaml
Outdated
Show resolved
Hide resolved
WinUIGallery/ControlPages/XamlFundamentals/XamlStylesPage.xaml.cs
Outdated
Show resolved
Hide resolved
Co-authored-by: Niels Laute <[email protected]>
Co-authored-by: Niels Laute <[email protected]>
Co-authored-by: Niels Laute <[email protected]>
…ng} comparison table.
Co-authored-by: Niels Laute <[email protected]>
Co-authored-by: Niels Laute <[email protected]>
Co-authored-by: Niels Laute <[email protected]>
Co-authored-by: Niels Laute <[email protected]>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM! Amazing work @Zakariathr22!
@niels9001 |
@Zakariathr22 We've reviewed the PR and saw some (minor) improvements we could make. Would you mind getting the latest changes from |
The latest changes from Sure, feel free to go ahead, thanks for helping out! |
@niels9001 |
Description
This pull request introduces the "XAML Fundamentals" section, including pages and examples for XAML Resources, XAML Styles, Binding, and Templates, main changes are:
Added
sample code files for XAML Resources, XAML Styles, Binding, and Templates.Added
new assets for theme resource examples and updated control images.Updated
ControlInfoData.json
to include the new "XAML Fundamentals" section.Added
pages for XAML Resources, XAML Styles, Binding, and Templates, each with practical examples.Updated
navigation to include the new section and handle its items programmatically.Motivation and Context
I noticed that many learners, especially those new to WinUI 3, often turn to the WinUI 3 Gallery application as their starting point. While the app provides excellent explanations of controls and code samples, it sometimes introduces concepts that may be unfamiliar to beginners.
To address this, I had created a dedicated section in the application called XAML Fundamentals. This section is organized into key topics, including: XAML Resources, XAML Styles, Binding, and Templates.
The goal is to help learners better understand these foundational concepts by providing clear explanations, practical examples, and links to relevant documentation.
How Has This Been Tested?
This code was tested manually, and no issues were encountered during the testing. The changes are isolated to the new section and do not affect other areas of the app.
Screenshots:
XAML Resouces Page
XAML Styles
Binding
Templates
Search Page
Types of changes