Skip to content
This repository has been archived by the owner on Oct 11, 2022. It is now read-only.

Latest commit

 

History

History
77 lines (59 loc) · 5.05 KB

README.md

File metadata and controls

77 lines (59 loc) · 5.05 KB
Raw

Maui XAML and Object Model Suggestions

This is a repo to hold suggestions for MAUI architecural and naming considerations as it is being developed. The origin and inspiration for this repository is formed from the discussion in dotnet/maui#43.

As a quick example, here is the comparison between a traditional XAML control for text TextBlock next to the Xamarin.Forms text control Label

Platform Hiearchy
UWP TextBlock UWP TextBlock
Xamarin.Forms Label Xamarin.Forms Label

Contributing

Please add your suggesitons/fixes, pull request is super-easy and fast on GitHub

  1. Click the little Pencil button at the top-right of this document
    • This will automatically fork the repo and you can start editing immediately.
  2. Make your additions and open a Pull Request
    • The commit button at the bottom of the page will start a pull request for you.

Suggestions

General

Xamarin.Forms XAML Traditional XAML Proposal
ContentPage Page Page
Object Object Object
BindableObject DependencyObject DependencyObject
BindableProperty DependencyProperty DependencyProperty
Element UIElement UIElement
NavigatableElement ? ?
VisualElement FrameworkElement FrameworkElement
View ContentControl ContentControl
ContentView UserControl UserControl
ContentPresenter ContentPresenter ContentPresenter

Controls

Xamarin.Forms XAML Traditional XAML Proposal
Label TextBlock TextBlock
Entry TextBox TextBox
Editor RichTextBox RichTextBox
Picker ComboBox ComboBox
StackLayout StackPanel StackPanel
ScrollView ScrollViewer ScrollViewer
Switch ToggleSwitch ToggleSwitch
Stepper NumericUpDown NumberBox
Frame Border Border
Slider Slider Slider
ActivityIndicator ProgressRing ProgressRing
? ProgressBar ProgressBar

Common Properties

Xamarin.Forms XAML Traditional XAML Proposal
HorizontalOptions HorizontalAlignment HorizontalAlignment
VerticalOptions VerticalAlignment VerticalAlignment
BindingContext DataContext DataContext
BackgroundColor Background Background
TextColor Foreground Foreground
HeightRequest Height Height
WidthRequest Width Width
IsVisible Visibility Visibility

Object Model

Community Suggestions. Visit the origin to see full discussions around the idea.

Suggestion Origin
Base Architecture (fork from): UWP Pull Request #4
XAML-defined animations (without attaching behaviors) Issue #1