Git Product home page Git Product logo

materialdesigncontrolsplugin's Introduction

MaterialDesignControls Plugin for Xamarin Forms

MaterialDesignControls Plugin for Xamarin Forms is a collection of Xamarin.Forms controls that apply the Material Design Guidelines

Setup

Platform Support

Platform Version
Xamarin.iOS iOS 8+
Xamarin.Android API 16+
Xamarin.Forms >= 4.0.0.425677

API Usage

You must add this line to your platform specific project (AppDelegate.cs, MainActivity.cs) before you use MaterialDesignControls:

if you're using iOS:

Plugin.MaterialDesignControls.iOS.Renderer.Init();           

or if you're using Android:

Plugin.MaterialDesignControls.Android.Renderer.Init();           

You must add this namespace to your xaml files:

xmlns:material="clr-namespace:Plugin.MaterialDesignControls;assembly=Plugin.MaterialDesignControls"

Controls

MaterialButton

Buttons allow users to take actions, and make choices, with a single tap.

Screenshot

Example

<material:MaterialButton Text="Save" Icon="save.png" Command="{Binding TapCommand}" CommandParameter="Saved" />

MaterialChip

Chips are compact elements that represent an action.

Screenshot

Example

<material:MaterialChips IsSelected="true" IsEnabled="true" Text="Option A" />

MaterialEntry

Text fields let users enter and edit text.

Screenshot

Example

<material:MaterialEntry FieldName="Name" Type="Filled" LabelText="Name" Placeholder="Enter your name"
                        IsRequired="true" RequiredMessage="The name is required" MaxLength="12" />

MaterialDatePicker

Date pickers let users select a date.

Screenshot

Example

<material:MaterialDatePicker Type="Filled" LabelText="Start date" Format="yyyy-MM-dd" LeadingIcon="calendar.png" />

MaterialTimePicker

Time pickers let users select a time.

Screenshot

Example

<material:MaterialTimePicker Type="Filled" LabelText="Start time" Format="HH:mm" LeadingIcon="calendar.png" />

MaterialPicker

Pickers let users select an option.

Screenshot

Example

<material:MaterialPicker FieldName="Color" Type="Filled" LabelText="Color"
                         IsRequired="true" RequiredMessage="The color is required" />

MaterialEditor

Text fields let users enter and edit text.

Screenshot

Example

<material:MaterialEditor Type="Outlined" LabelText="Description" Placeholder="Enter your description" 
                         LeadingIcon="email.png" HeightRequest="200" />

MaterialSelection

Selection let users select an option.

Screenshot

Example

<material:MaterialSelection Type="Filled" LeadingIcon="calendar.png" LabelText="User" Placeholder="Select user" Text="User A" 
                            Command="{Binding TapCommand}" CommandParameter="User selection" />

MaterialField

Displays a value with its respective label in read-only format.

Screenshot

Example

<material:MaterialField LabelText="Mail" Text="[email protected]" LeadingIcon="email.png" />

Effects

TouchAndPressEffect

Effect to detect the different types of taps on a view: Pressing, Released and Canceled can be detected.

Example

<MyControl.Effects>
    <material:TouchAndPressEffect />
</MyControl.Effects>
public class MyControl : ContentView, ITouchAndPressEffectConsumer
{
    public void ConsumeEvent(EventType gestureType)
    {
        TouchAndPressAnimation.Animate(this, gestureType);
    }
}

Demo

https://github.com/HorusSoftwareUY/MaterialDesignControlsPlugin/tree/master/example

Contributions

Contributions are welcome! If you find a bug want a feature added please report it.

If you want to contribute code please file an issue, create a branch, and file a pull request.

License

MIT License - see LICENSE.txt

materialdesigncontrolsplugin's People

Contributors

agustinbonilla avatar seba47 avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.