Semantics and some structure changes

src/Compatibility/ControlGallery/src/Android/FormsAppCompatActivity.cs

@@ -59,8 +59,7 @@ protected override void OnCreate(Bundle bundle)
 			Handlers.ViewHandler
 				.ViewMapper[nameof(IView.AutomationId)] = (h, v) =>
 				{
-					(h.NativeView as global::Android.Views.View).ContentDescription =
-						v.AutomationId;
+					h.NativeView.ContentDescription = v.AutomationId;
 				};
 #endif
 

src/Compatibility/Core/src/Android/RendererToHandlerShim.cs

@@ -1,13 +1,13 @@
 using System;
 using Android.Views;
 using Microsoft.Maui.Controls.Compatibility.Platform.Android;
-using AbstractViewHandler = Microsoft.Maui.Handlers.AbstractViewHandler<Microsoft.Maui.IView, Android.Views.View>;
+using ViewHandler = Microsoft.Maui.Handlers.ViewHandler<Microsoft.Maui.IView, Android.Views.View>;
 using IVisualElementRenderer = Microsoft.Maui.Controls.Compatibility.Platform.Android.IVisualElementRenderer;
 using VisualElementChangedEventArgs = Microsoft.Maui.Controls.Compatibility.Platform.Android.VisualElementChangedEventArgs;
 
 namespace Microsoft.Maui.Controls.Compatibility
 {
-	public class RendererToHandlerShim : AbstractViewHandler
+	public class RendererToHandlerShim : ViewHandler
 	{
 		internal IVisualElementRenderer VisualElementRenderer { get; private set; }
 

src/Compatibility/Core/src/Windows/RendererToHandlerShim.cs

@@ -1,12 +1,12 @@
 using System;
-using AbstractViewHandler = Microsoft.Maui.Handlers.AbstractViewHandler<Microsoft.Maui.IView, Microsoft.UI.Xaml.FrameworkElement>;
+using ViewHandler = Microsoft.Maui.Handlers.ViewHandler<Microsoft.Maui.IView, Microsoft.UI.Xaml.FrameworkElement>;
 using Microsoft.Maui.Handlers;
 using Microsoft.Maui.Controls.Compatibility.Platform.UWP;
 using Microsoft.UI.Xaml;
 
 namespace Microsoft.Maui.Controls.Compatibility
 {
-	public class RendererToHandlerShim : AbstractViewHandler
+	public class RendererToHandlerShim : ViewHandler
 	{
 		internal IVisualElementRenderer VisualElementRenderer { get; private set; }
 

src/Compatibility/Core/src/iOS/RendererToHandlerShim.cs

@@ -1,12 +1,12 @@
 using System;
-using AbstractViewHandler = Microsoft.Maui.Handlers.AbstractViewHandler<Microsoft.Maui.IView, UIKit.UIView>;
+using ViewHandler = Microsoft.Maui.Handlers.ViewHandler<Microsoft.Maui.IView, UIKit.UIView>;
 using UIKit;
 using Microsoft.Maui.Controls.Compatibility.Platform.iOS;
 using Microsoft.Maui.Handlers;
 
 namespace Microsoft.Maui.Controls.Compatibility
 {
-	public class RendererToHandlerShim : AbstractViewHandler
+	public class RendererToHandlerShim : ViewHandler
 	{
 		internal IVisualElementRenderer VisualElementRenderer { get; private set; }
 
@@ -21,7 +21,7 @@ public static IViewHandler CreateShim(object renderer)
 			return new RendererToHandlerShim();
 		}
 
-		public RendererToHandlerShim() : base(ViewHandler.ViewMapper)
+		public RendererToHandlerShim() : base(Handlers.ViewHandler.ViewMapper)
 		{
 		}
 

src/Controls/samples/Controls.Sample/Pages/MainPage.cs

@@ -41,6 +41,9 @@ void SetupMauiLayout()
 			var label = new Label { Text = "End-aligned text", BackgroundColor = Color.Fuchsia, HorizontalTextAlignment = TextAlignment.End };
 			label.Margin = new Thickness(15, 10, 20, 15);
 
+			SemanticProperties.SetHint(label, "Hint Text");
+			SemanticProperties.SetDescription(label, "Description Text");
+
 			verticalStack.Add(label);
 			verticalStack.Add(new Label { Text = "This should be BIG text!", FontSize = 24, HorizontalOptions = LayoutOptions.End });
 			verticalStack.Add(new Label { Text = "This should be BOLD text!", FontAttributes = FontAttributes.Bold, HorizontalOptions = LayoutOptions.Center });

src/Controls/samples/Controls.Sample/Pages/XamlPage.xaml

@@ -4,7 +4,8 @@
                    x:Class="Maui.Controls.Sample.Pages.XamlPage">
 
     <StackLayout>
-        <Label Text="Welcome to Microsoft MAUI!"
+        <Label 
+               Text="Welcome to Microsoft MAUI!"
                VerticalOptions="CenterAndExpand"
                HorizontalOptions="CenterAndExpand" />
     </StackLayout>

src/Controls/src/Core/HandlerImpl/VisualElement.Impl.cs

@@ -125,5 +125,17 @@ protected virtual Size MeasureOverride(double widthConstraint, double heightCons
 		Maui.FlowDirection IFrameworkElement.FlowDirection => FlowDirection.ToPlatformFlowDirection();
 		Primitives.LayoutAlignment IFrameworkElement.HorizontalLayoutAlignment => default;
 		Primitives.LayoutAlignment IFrameworkElement.VerticalLayoutAlignment => default;
+
+		Maui.Semantics _semantics;
+		Maui.Semantics IFrameworkElement.Semantics
+		{
+			get => _semantics;
+		}
+
+		internal Semantics SetupSemantics()
+		{
+			_semantics = _semantics ?? new Semantics();
+			return _semantics;
+		}
 	}
 }

src/Controls/src/Core/SemanticProperties.cs

@@ -0,0 +1,56 @@
+using System;
+
+namespace Microsoft.Maui.Controls
+{
+	public class SemanticProperties
+	{
+		public static readonly BindableProperty DescriptionProperty = BindableProperty.CreateAttached("Description", typeof(string), typeof(SemanticProperties), default(string), propertyChanged : OnHintPropertyChanged);
+
+		public static readonly BindableProperty HintProperty = BindableProperty.CreateAttached("Hint", typeof(string), typeof(SemanticProperties), default(string), propertyChanged: OnDescriptionPropertyChanged);
+
+		static void OnDescriptionPropertyChanged(BindableObject bindable, object oldValue, object newValue)
+		{
+			SetupSemanticsProperty(bindable)
+				.Description = SemanticProperties.GetHint(bindable);
+
+			UpdateSemanticsProperty(bindable);
+		}
+
+		static void OnHintPropertyChanged(BindableObject bindable, object oldValue, object newValue)
+		{
+			SetupSemanticsProperty(bindable)
+				.Hint = SemanticProperties.GetHint(bindable);
+
+			UpdateSemanticsProperty(bindable);
+		}
+
+		static Semantics SetupSemanticsProperty(BindableObject bindable) =>
+			((VisualElement)bindable).SetupSemantics();
+
+		static void UpdateSemanticsProperty(BindableObject bindable)
+		{
+			if (bindable is IFrameworkElement fe)
+				fe.Handler?.UpdateValue(nameof(IView.Semantics));
+		}
+
+		public static string GetDescription(BindableObject bindable)
+		{
+			return (string)bindable.GetValue(DescriptionProperty);
+		}
+
+		public static void SetDescription(BindableObject bindable, string value)
+		{
+			bindable.SetValue(DescriptionProperty, value);
+		}
+
+		public static string GetHint(BindableObject bindable)
+		{
+			return (string)bindable.GetValue(HintProperty);
+		}
+
+		public static void SetHint(BindableObject bindable, string value)
+		{
+			bindable.SetValue(HintProperty, value);
+		}
+	}
+}

src/Core/src/Core/IFrameworkElement.cs

@@ -100,5 +100,10 @@ public interface IFrameworkElement
 		/// Determines the vertical aspect of this element's arrangement in a container
 		/// </summary>
 		LayoutAlignment VerticalLayoutAlignment { get; }
+
+		/// <summary>
+		/// Adds semantics to every FrameworkElement for accessibility
+		/// </summary>
+		Semantics Semantics { get; }
 	}
 }

src/Core/src/Handlers/ActivityIndicator/ActivityIndicatorHandler.Android.cs

@@ -2,7 +2,7 @@
 
 namespace Microsoft.Maui.Handlers
 {
-	public partial class ActivityIndicatorHandler : AbstractViewHandler<IActivityIndicator, ProgressBar>
+	public partial class ActivityIndicatorHandler : ViewHandler<IActivityIndicator, ProgressBar>
 	{
 		protected override ProgressBar CreateNativeView() => new ProgressBar(Context) { Indeterminate = true };
 	}

src/Core/src/Handlers/ActivityIndicator/ActivityIndicatorHandler.Standard.cs

@@ -2,7 +2,7 @@
 
 namespace Microsoft.Maui.Handlers
 {
-	public partial class ActivityIndicatorHandler : AbstractViewHandler<IActivityIndicator, object>
+	public partial class ActivityIndicatorHandler : ViewHandler<IActivityIndicator, object>
 	{
 		protected override object CreateNativeView() => throw new NotImplementedException();
 	}

src/Core/src/Handlers/ActivityIndicator/ActivityIndicatorHandler.Windows.cs

@@ -3,7 +3,7 @@
 
 namespace Microsoft.Maui.Handlers
 {
-	public partial class ActivityIndicatorHandler : AbstractViewHandler<IActivityIndicator, ProgressBar>
+	public partial class ActivityIndicatorHandler : ViewHandler<IActivityIndicator, ProgressBar>
 	{
 		protected override ProgressBar CreateNativeView() => new ProgressBar();
 	}

src/Core/src/Handlers/ActivityIndicator/ActivityIndicatorHandler.cs

@@ -10,12 +10,12 @@ public partial class ActivityIndicatorHandler
 
 		public static void MapIsRunning(ActivityIndicatorHandler handler, IActivityIndicator activityIndicator)
 		{
-			handler.TypedNativeView?.UpdateIsRunning(activityIndicator);
+			handler.NativeView?.UpdateIsRunning(activityIndicator);
 		}
 
 		public static void MapColor(ActivityIndicatorHandler handler, IActivityIndicator activityIndicator)
 		{
-			handler.TypedNativeView?.UpdateColor(activityIndicator);
+			handler.NativeView?.UpdateColor(activityIndicator);
 		}
 
 		public ActivityIndicatorHandler() : base(ActivityIndicatorMapper)

src/Core/src/Handlers/ActivityIndicator/ActivityIndicatorHandler.iOS.cs

@@ -3,7 +3,7 @@
 
 namespace Microsoft.Maui.Handlers
 {
-	public partial class ActivityIndicatorHandler : AbstractViewHandler<IActivityIndicator, MauiActivityIndicator>
+	public partial class ActivityIndicatorHandler : ViewHandler<IActivityIndicator, MauiActivityIndicator>
 	{
 		protected override MauiActivityIndicator CreateNativeView() => new MauiActivityIndicator(CGRect.Empty, VirtualView)
 		{

src/Core/src/Handlers/Button/ButtonHandler.Android.cs

@@ -6,7 +6,7 @@
 
 namespace Microsoft.Maui.Handlers
 {
-	public partial class ButtonHandler : AbstractViewHandler<IButton, AppCompatButton>
+	public partial class ButtonHandler : ViewHandler<IButton, AppCompatButton>
 	{
 		ButtonClickListener ClickListener { get; } = new ButtonClickListener();
 		ButtonTouchListener TouchListener { get; } = new ButtonTouchListener();
@@ -45,17 +45,17 @@ protected override void DisconnectHandler(AppCompatButton nativeView)
 
 		public static void MapBackgroundColor(ButtonHandler handler, IButton button)
 		{
-			handler.TypedNativeView?.UpdateBackgroundColor(button);
+			handler.NativeView?.UpdateBackgroundColor(button);
 		}
 
 		public static void MapText(ButtonHandler handler, IButton button)
 		{
-			handler.TypedNativeView?.UpdateText(button);
+			handler.NativeView?.UpdateText(button);
 		}
 
 		public static void MapTextColor(ButtonHandler handler, IButton button)
 		{
-			handler.TypedNativeView?.UpdateTextColor(button);
+			handler.NativeView?.UpdateTextColor(button);
 		}
 
 		public static void MapFont(ButtonHandler handler, IButton button)
@@ -64,12 +64,12 @@ public static void MapFont(ButtonHandler handler, IButton button)
 
 			var fontManager = handler.Services.GetRequiredService<IFontManager>();
 
-			handler.TypedNativeView?.UpdateFont(button, fontManager);
+			handler.NativeView?.UpdateFont(button, fontManager);
 		}
 
 		public static void MapPadding(ButtonHandler handler, IButton button)
 		{
-			handler.TypedNativeView?.UpdatePadding(button);
+			handler.NativeView?.UpdatePadding(button);
 		}
 
 		public bool OnTouch(IButton? button, AView? v, MotionEvent? e)

src/Core/src/Handlers/Button/ButtonHandler.Standard.cs

@@ -2,7 +2,7 @@
 
 namespace Microsoft.Maui.Handlers
 {
-	public partial class ButtonHandler : AbstractViewHandler<IButton, object>
+	public partial class ButtonHandler : ViewHandler<IButton, object>
 	{
 		protected override object CreateNativeView() => throw new NotImplementedException();
 

src/Core/src/Handlers/Button/ButtonHandler.Windows.cs

@@ -5,7 +5,7 @@
 
 namespace Microsoft.Maui.Handlers
 {
-	public partial class ButtonHandler : AbstractViewHandler<IButton, Button>
+	public partial class ButtonHandler : ViewHandler<IButton, Button>
 	{
 		static UI.Xaml.Thickness? DefaultPadding;
 		static UI.Xaml.Media.Brush? DefaultForeground;
@@ -46,17 +46,17 @@ protected override void DisconnectHandler(Button nativeView)
 
 		public static void MapBackgroundColor(ButtonHandler handler, IButton button)
 		{
-			handler.TypedNativeView?.UpdateBackgroundColor(button, DefaultBackground);
+			handler.NativeView?.UpdateBackgroundColor(button, DefaultBackground);
 		}
 
 		public static void MapText(ButtonHandler handler, IButton button)
 		{
-			handler.TypedNativeView?.UpdateText(button);
+			handler.NativeView?.UpdateText(button);
 		}
 
 		public static void MapTextColor(ButtonHandler handler, IButton button)
 		{
-			handler.TypedNativeView?.UpdateTextColor(button, DefaultForeground);
+			handler.NativeView?.UpdateTextColor(button, DefaultForeground);
 		}
 
 		public static void MapFont(ButtonHandler handler, IButton button)
@@ -65,12 +65,12 @@ public static void MapFont(ButtonHandler handler, IButton button)
 
 			var fontManager = handler.Services.GetRequiredService<IFontManager>();
 
-			handler.TypedNativeView?.UpdateFont(button, fontManager);
+			handler.NativeView?.UpdateFont(button, fontManager);
 		}
 
 		public static void MapPadding(ButtonHandler handler, IButton button)
 		{
-			handler.TypedNativeView?.UpdatePadding(button, DefaultPadding);
+			handler.NativeView?.UpdatePadding(button, DefaultPadding);
 		}
 
 		void OnClick(object sender, UI.Xaml.RoutedEventArgs e)

src/Core/src/Handlers/Button/ButtonHandler.iOS.cs

@@ -4,7 +4,7 @@
 
 namespace Microsoft.Maui.Handlers
 {
-	public partial class ButtonHandler : AbstractViewHandler<IButton, UIButton>
+	public partial class ButtonHandler : ViewHandler<IButton, UIButton>
 	{
 		static readonly UIControlState[] ControlStates = { UIControlState.Normal, UIControlState.Highlighted, UIControlState.Disabled };
 
@@ -47,21 +47,21 @@ protected override void SetupDefaults(UIButton nativeView)
 
 		public static void MapBackgroundColor(ButtonHandler handler, IButton button)
 		{
-			handler.TypedNativeView?.UpdateBackgroundColor(button);
+			handler.NativeView?.UpdateBackgroundColor(button);
 		}
 
 		public static void MapText(ButtonHandler handler, IButton button)
 		{
-			handler.TypedNativeView?.UpdateText(button);
+			handler.NativeView?.UpdateText(button);
 		}
 
 		public static void MapTextColor(ButtonHandler handler, IButton button)
 		{
-			handler.TypedNativeView?.UpdateTextColor(button, ButtonTextColorDefaultNormal, ButtonTextColorDefaultHighlighted, ButtonTextColorDefaultDisabled);
+			handler.NativeView?.UpdateTextColor(button, ButtonTextColorDefaultNormal, ButtonTextColorDefaultHighlighted, ButtonTextColorDefaultDisabled);
 		}
 		public static void MapPadding(ButtonHandler handler, IButton button)
 		{
-			handler.TypedNativeView?.UpdatePadding(button);
+			handler.NativeView?.UpdatePadding(button);
 		}
 
 		public static void MapFont(ButtonHandler handler, IButton button)
@@ -70,19 +70,19 @@ public static void MapFont(ButtonHandler handler, IButton button)
 
 			var fontManager = handler.Services.GetRequiredService<IFontManager>();
 
-			handler.TypedNativeView?.UpdateFont(button, fontManager);
+			handler.NativeView?.UpdateFont(button, fontManager);
 		}
 
 		void SetControlPropertiesFromProxy()
 		{
-			if (TypedNativeView == null)
+			if (NativeView == null)
 				return;
 
 			foreach (UIControlState uiControlState in ControlStates)
 			{
-				TypedNativeView.SetTitleColor(UIButton.Appearance.TitleColor(uiControlState), uiControlState); // If new values are null, old values are preserved.
-				TypedNativeView.SetTitleShadowColor(UIButton.Appearance.TitleShadowColor(uiControlState), uiControlState);
-				TypedNativeView.SetBackgroundImage(UIButton.Appearance.BackgroundImageForState(uiControlState), uiControlState);
+				NativeView.SetTitleColor(UIButton.Appearance.TitleColor(uiControlState), uiControlState); // If new values are null, old values are preserved.
+				NativeView.SetTitleShadowColor(UIButton.Appearance.TitleShadowColor(uiControlState), uiControlState);
+				NativeView.SetBackgroundImage(UIButton.Appearance.BackgroundImageForState(uiControlState), uiControlState);
 			}
 		}
 

src/Core/src/Handlers/CheckBox/CheckBoxHandler.Android.cs

@@ -3,14 +3,14 @@
 
 namespace Microsoft.Maui.Handlers
 {
-	public partial class CheckBoxHandler : AbstractViewHandler<ICheckBox, AppCompatCheckBox>
+	public partial class CheckBoxHandler : ViewHandler<ICheckBox, AppCompatCheckBox>
 	{
 		CheckedChangeListener ChangeListener { get; } = new CheckedChangeListener();
 
 		// This is an Android-specific mapping
 		public static void MapBackgroundColor(CheckBoxHandler handler, ICheckBox check)
 		{
-			handler.TypedNativeView?.UpdateBackgroundColor(check);
+			handler.NativeView?.UpdateBackgroundColor(check);
 		}
 
 		protected override AppCompatCheckBox CreateNativeView()