🧪 [Experiment] Ribbon
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức phù hợp với người mới
- 25/100
- Loại issue
- Tính năng
- Độ rõ ràng
- Khá rõ ràng
- Mức độ hoạt động
- Đình trệ
- Công nghệ
- csharp
- Lĩnh vực
- desktop-dev, frontend
Hướng nghiên cứu
Bắt đầu bằng cách xác định các component Ribbon, RibbonGroup, RibbonCollapsibleGroup và RibbonPanel cùng tệp RibbonStyle.xaml của chúng. Issue đánh dấu các unit test, phản hồi từ cộng đồng và đánh giá kỹ thuật là chưa hoàn tất; để hoàn thành, cần xử lý những phần còn lại đó cho thử nghiệm WinUI 3, nhưng không có tệp test hay entry point cụ thể nào được nêu tên.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Approved from Discussion
https://github.com/CommunityToolkit/Labs-Windows/discussions/544
Problem Statement
Office and applications like Paint are using a "large" ribbon to display all their available commands. Those ribbons display all the available commands in groups. Those groups can automatically be collapsed if there is not enough space available to display them all based on a priority order.
The toolkit already provides a "small" ribbon through the TabbedCommandBar (See https://github.com/CommunityToolkit/Labs-Windows/discussions/500 and https://github.com/CommunityToolkit/Windows/pull/243) but does not have any way to display the "large" ribbon.
Overview
This experiment adds the following components:
- Ribbon the ribbon control.
- RibbonGroup an always displayed group container.
- RibbonCollapsibleGroup a group container which can be collapsed based on a priority order if there is not enough space available to fully display the group.
- RibbonPanel a custom panel for the Ribbon to automatically expand or collapse the RibbonCollapsibleGroups
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.Ribbon/overview/0.0.1
- WinUI 3: https://dev.azure.com/dotnet/CommunityToolkit/_artifacts/feed/CommunityToolkit-Labs/NuGet/CommunityToolkit.Labs.WinUI.Ribbon/overview/0.0.1
Read more about Preview Packages here.
Code
<Ribbon>
<RibbonGroup Label="Selection" />
<RibbonCollapsibleGroup Label="Edit" Style="{StaticResource RibbonLeftCollapsibleGroupStyle}" Priority="1">
<!-- group content -->
</RibbonCollapsibleGroup>
<RibbonCollapsibleGroup Label="Shapes" Style="{StaticResource RibbonLeftCollapsibleGroupStyle}" Priority="2">
<!-- group content -->
</RibbonCollapsibleGroup>
</Ribbon>
Result
Additional info
The control comes with a list of predefined styles from its RibbonStyle.xaml file. All the different parts of the Ribbon should support light templating.
The RibbonLeftGroupStyle/RibbonRightGroupStyle and RibbonLeftCollapsibleGroupStyle/ RibbonRightCollapsibleGroupStyle can be used to add a separator before or after the group.
Implementation Requirements
- Working Prototype
- Feature Complete
- Documentation
- Samples
- Unit Tests
- Community Feedback / Usage Testimonies
Tested Platforms
- UWP
- WinAppSDK / WinUI 3
- Web Assembly (WASM)
- Android
- iOS
- MacOS
- Linux / GTK
Technical Review
- Accessibility Audit
- API/Naming Review
- Code Quality/Style
- Dependency Review
- Design/Style Review
- Final Approval
Community Help?
Yes
- Ngôn ngữ chính
- C#
- Star
- 484
- Fork
- 89
- Merge trung bình
- 2 ngày 18 giờ
- Pull request đã merge (30 ngày)
- 1
Chuẩn bị môi trường
Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.
- Không có Dockerfile hay tệp Docker Compose
- Không có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của CommunityToolkit/Labs-Windows
-
bug :bug:
Độ khó 1/5 1-3 giờ Mức phù hợp với người mới 80/100
CommunityToolkit/Labs-Windows#815 ·
-
bug :bug:
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 38/100
CommunityToolkit/Labs-Windows#816 ·
-
bug :bug:
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 55/100
CommunityToolkit/Labs-Windows#814 ·
-
experiment :test_tube:
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 48/100
CommunityToolkit/Labs-Windows#812 ·
-
ux :paintbrush:
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 52/100
CommunityToolkit/Labs-Windows#808 · 1 bình luận ·
Tất cả issue của CommunityToolkit/Labs-Windows
Issue tương tự
-
bug priority: P2
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Parameterless constructor is not a must-provided by user when a struct has a field initializerĐang mở:watch: Not Triaged dotnet-csharp/svc fundamentals/subsvc
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 88/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Wrong values of Kernel32.FileShare.Delete and Kernel32.FileAttributes.PosixSemanticsCó thể đã có người làm @ElectLive đã nhận hôm nay. Đang mởbug good first issue help wanted
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 83/100
ForNeVeR/TruePath#241 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 66/100
files-community/Files#19047 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
Maintainer thường phản hồi trong vòng 1 ngày