https://github.com/lassana/XamarinFormsPinView

PIN keyboard for Xamarin.Forms.
https://github.com/lassana/XamarinFormsPinView

netstandard netstandard20 pinview xamarin xamarin-forms xamarin-library xamarin-plugin

Last synced: 29 days ago
JSON representation

PIN keyboard for Xamarin.Forms.

• Host: GitHub
• URL: https://github.com/lassana/XamarinFormsPinView
• Owner: lassana
• License: bsd-2-clause
• Created: 2016-08-27T07:54:12.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2018-10-08T16:24:07.000Z (about 6 years ago)
• Last Synced: 2024-05-13T00:35:56.201Z (7 months ago)
• Topics: netstandard, netstandard20, pinview, xamarin, xamarin-forms, xamarin-library, xamarin-plugin
• Language: C#
• Homepage:
• Size: 2.02 MB
• Stars: 81
• Watchers: 9
• Forks: 18
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-xamarin-forms - PinView ★80

README

        
# PIN keyboard for Xamarin.Forms

 


## Usage

1. Add the following NuGet package: https://www.nuget.org/packages/FormsPinView/ [![NuGet](https://img.shields.io/nuget/v/FormsPinView.svg?label=NuGet)](https://www.nuget.org/packages/FormsPinView/) 

    

    _OR_

    

    add [FormsPinView.Core](FormsPinView/FormsPinView.Core), [FormsPinView.iOS](FormsPinView/FormsPinView.iOS), and [FormsPinView.Droid](FormsPinView/FormsPinView.Droid) to your solution.

1. Initialize iOS and Android renderers:

        // iOS:

        public override bool FinishedLaunching(UIApplication app, NSDictionary options)

        {

            ...

            global::Xamarin.Forms.Forms.Init();

            PinItemViewRenderer.Init();

        }

        

        // Android:

        protected override void OnCreate(Bundle bundle)

        {

            ...

            global::Xamarin.Forms.Forms.Init(this, bundle);

            PinItemViewRenderer.Init();

        }

1. Add `PinView` to your page:

        

        ...

        xmlns:local="clr-namespace:FormsPinView.Core;assembly=FormsPinView.Core"

        ...

            

        

1. `PinView` is MVVM-ready, so you can bind the following properties:

| Property | Type | Description | Default | Required |

|---------------------|---------------------------|----------------------------------------------------------------------------------------------|---------|----------|

| `Validator` | `Func, bool>` | Function to check entered PIN | `null` | **Yes** |

| `PinLength` | `int` | The PIN length | 4 | No |

| `SuccessCommand` | `ICommand` | Invoked when the correct PIN is entered | `null` | No |

| `ErrorCommand` | `ICommand` | Invoked when an incorrect PIN is entered | `null` | No |

| `ClearAfterSuccess` | `bool` | Indicates whether the entered PIN should be cleaned or not after it was confirmed as correct | true | No |

| `BorderColor` | `Color` | View tint color. | Gray | No |

| `Color` | `Color` | View basic color. | Black | No |

| `RippleColor` | `Color` | View touch-effect color. | Gray | No |

## TODO

- [x] Use `AbsoluteLayout` instead of `Grid`, no XAML

- [x] Colorizing

- [ ] Rowspacing & Colspacing

- [ ] Buttons are Circle or Square

- [ ] Font size

- [ ] Button background

- [ ] Buttom border (size)

- [ ] Randomizing the numbers order

- [ ] CI builds

- [ ] UI tests

## Changelog

### 2.1.0-pre1

- Root container changed from `Grid` to `AbsoluteLayout`

- Allowed to configure view colors: see `BorderColor`, `Color`, and `RippleColor`

- Removed `EmptyCircleImage` and `FilledCircleImage` properties

### 2.0.0

- Released *2.0.0-pre1* as a stable version

### 2.0.0-pre1

- Removed `Title` property: now you have to implement it manually in your UI

- Refactored the ViewModel API (splitted into bindable properties)

- Namespaces changed from `PCL` to `Core`.

- Allowed to change the PIN length dynamically as well as PIN symbols

### 1.1.1

- Released *1.1.1-pre1* as a stable version

### 1.1.1-pre1

- Fixed `NSInternalInconsistencyException` crash on iOS

### 1.1.0

- .NET Standard 2.0 is now supported

- PCL support is dropped

### 1.0.1

- Changed PCL profile to 259

- Added F# sample

### 1.0.0

- Intilial release 

## License

BSD 2-Clause.