Introduction
Xamarin.Forms code runs on multiple platforms - each of which has its own filesystem.
This means that reading and writing files is most easily done using the native file APIs on each platform. Alternatively, embedded resources are a simpler solution to distribute data files with an app.
Material
Material Design is introduced in Xamarin.Forms 3.6.
Material Design is a design system created by Google, that prescribes the size, color, spacing, and other aspects of how Views and layouts should look and behave.
- Visual="Material"
- Visual="Default"
Note
On Android, the material renderers require a minimum version of 5.0 (API 21) or greater, and a TargetFramework of version 9.0 (API 28).
In addition, your platform project requires Android support libraries 28.0.0 or greater, and its theme needs to inherit from a Material Components theme or continue to inherit from an AppCompat theme.
Material renderers are currently included the following Controls,
- Button
- Entry
- Frame
- ProgressBar
- DatePicker
- TimePicker
- Picker
- ActivityIndicator
- Editor
- Slider
- Stepper
More information about Material
https://docs.microsoft.com/en-us/xamarin/xamarin-forms/user-interface/visual/material-visual
Prerequisites
- Visual Studio 2017 or later (Windows or Mac)
Setting up a Xamarin.Forms Project
Start by creating a new Xamarin.Forms project. You’ll learn more by going through the steps yourself.
Visual Studio 2019 has more options in the opening window. Clone or check out the code from any repository or, open a project or solution for your computer.
Now, you need to click "Create a new project".
Now, filter by Project Type: Mobile
Choose the Mobile App (Xamarin. forms) project under C# and Mobile.
Name your app. You probably want your project and solution to use the same name as your app. Put it on your preferred location for projects and click "Create".
Now, select the blank app and target platforms - Android, iOS and Windows (UWP).
Subsequently, go to the solution. In there, you get all the files and sources of your project (.NET Standard). Now, select the XAML page and double-click to open the MainPage.Xaml page.
You now have a basic Xamarin.Forms app. Click the Play button to try it out.
NuGet Packages
Now, add the following NuGet Packages.
- Xamarin.Forms.Visual.Material
Add Xamarin.Forms.Visual.Material NuGet
Go to Solution Explorer and select your solution. Right-click and select "Manage NuGet Packages for Solution". Search "Xamarin.Forms.Visual.Material" and add Package. Remember to install it for each project (.NET Standard, Android, iOS).
Note
Before you initialize Xamarin.Forms in your MainActivity.cs and AppDelegate, you must Initialize FormsMaterial.Init()
Android Implementation
MainActivity.cs
- protected override void OnCreate(Bundle savedInstanceState)
- {
- TabLayoutResource = Resource.Layout.Tabbar;
- ToolbarResource = Resource.Layout.Toolbar;
-
-
-
- base.OnCreate(savedInstanceState);
- global::Xamarin.Forms.Forms.Init(this, savedInstanceState);
- global::Xamarin.Forms.FormsMaterial.Init(this, savedInstanceState);
- LoadApplication(new App());
- }
iOS Implementation
AppDelegate.cs
- public override bool FinishedLaunching(UIApplication app, NSDictionary options)
- {
-
- global::Xamarin.Forms.Forms.Init();
- global::Xamarin.Forms.FormsMaterial.Init();
- LoadApplication(new App());
-
- return base.FinishedLaunching(app, options);
- }
Setting up the User Interface
In this step, I added material design.
- <ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
- xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
- xmlns:sys="clr-namespace:System;assembly=mscorlib"
- x:Class="VisualChallenge.VisualChallengePage"
- Shell.NavBarIsVisible="True"
- BackgroundColor="White"
- Title="Visual Challenge"
- >
- <ContentPage.ToolbarItems>
- <ToolbarItem Order="Primary" Text="Add"></ToolbarItem>
- <ToolbarItem Order="Secondary" Priority="0" Text="Update"></ToolbarItem>
- </ContentPage.ToolbarItems>
- <!-- If you decide to change out the flexlayout leave the scroll view here
- Currently, there's a bug in the shell that will set margins wrong if the content is not in a scrollview
- -->
- <ScrollView>
- <StackLayout Margin="20" >
-
- <Editor Placeholder="EnterSomeThing"></Editor>
- <Frame Visual="Material" HeightRequest="150" WidthRequest="150" CornerRadius="5" BorderColor="Red">
- <Image Source="monkey.jpg"></Image>
- </Frame>
- <Frame BorderColor="LightGray">
- <Grid Visual="Material">
- <Grid.ColumnDefinitions>
- <ColumnDefinition Width="*"/>
- <ColumnDefinition Width="*"/>
- </Grid.ColumnDefinitions>
- <Grid.RowDefinitions>
- <RowDefinition Height="200"/>
- <RowDefinition Height="200"/>
- </Grid.RowDefinitions>
- <Frame Grid.Row="0" Visual="Material" Grid.Column="0" BorderColor="LightGray">
- <StackLayout >
- <Label Text="Monkey"></Label>
- <Image Aspect="AspectFit" Source="monkey1.jpg"></Image>
- </StackLayout>
- </Frame>
-
- <Frame Grid.Row="0" Grid.Column="1" BorderColor="LightGray">
- <StackLayout >
- <Label Text="Monkey"></Label>
- <Image Aspect="AspectFit" Source="monkey2.jpg"></Image>
- </StackLayout>
- </Frame>
- <Frame Grid.Row="1" Grid.Column="0" BorderColor="LightGray">
- <StackLayout >
- <Label Text="Monkey"></Label>
- <Image Aspect="AspectFit" Source="monkey3.jpg"></Image>
- </StackLayout>
- </Frame>
-
- <Frame Grid.Row="1" Grid.Column="1" BorderColor="LightGray">
- <StackLayout >
- <Label Text="Monkey"></Label>
- <Image Aspect="AspectFit" Source="monkey4.jpg"></Image>
- </StackLayout>
- </Frame>
- </Grid>
- </Frame>
-
- </StackLayout>
- </ScrollView>
- </ContentPage>
Click the "Play" button to try it out.
Android Design
iOS Design
I hope you have understood how to use Material design in Xamarin.Forms.
Thanks for reading. Please share your comments and feedback.
Happy Coding :)