XamarinFormsPinView

KO | EN

gitlite — search

#python #golang #machine-learning #rust #deep-learning #docker #nodejs #macos #java #kubernetes #ios #mcp #openai #open-source

XamarinFormsPinView

(★ 80)

PIN keyboard for Xamarin.Forms.

File Explorer

Download Latest Version (.zip)

- - CircleView.cs
  - FormsPinView.Core.csproj
  - packages.config
  - PinItemView.cs
  - PinView.cs
- - CircleViewRenderer.cs
  - FormsPinView.Droid.csproj
  - packages.config
  - PinItemViewRenderer.cs
  - RippleButton.cs
- - CircleViewRenderer.cs
  - FormsPinView.iOS.csproj
  - packages.config
  - PinItemViewRenderer.cs
  - ZFRippleButton.cs
- - App.xaml
  - App.xaml.cs
  - FormsPinViewSample.CSharp.Core.csproj
- - FormsPinViewSample.CSharp.Droid.csproj
  - MainActivity.cs
  - packages.config
- - AppDelegate.cs
  - Entitlements.plist
  - FormsPinViewSample.CSharp.iOS.csproj
  - Info.plist
  - LaunchScreen.storyboard
  - Main.cs
  - packages.config
- - App.xaml
  - App.xaml.fs
  - FormsPinViewSampleFSharp.Core.fsproj
- - FormsPinViewSampleFSharp.Droid.fsproj
  - MainActivity.fs
  - packages.config
- - AppDelegate.fs
  - Entitlements.plist
  - FormsPinViewSampleFSharp.iOS.fsproj
  - Info.plist
  - LaunchScreen.storyboard
  - packages.config
- .gitkeep
- - CircleViewTests.cs
  - FormsPinView.Core.Tests.csproj
  - PinItemViewTests.cs
  - PinViewTests.cs
.gitignore
android.mov.gif
FormsPinView.nuspec
ios.mov.gif
LICENSE
NuGet.config
README.md
XamarinFormsPinView.sln

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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"
        ...
            <local:PinView
                HorizontalOptions="CenterAndExpand"
                VerticalOptions="CenterAndExpand"
                TargetPinLength="4"
                Validator="{Binding ValidatorFunc}"
                Success="Handle_Success" />
        
1. `PinView` is MVVM-ready, so you can bind the following properties:

| Property | Type | Description | Default | Required |
|---------------------|---------------------------|----------------------------------------------------------------------------------------------|---------|----------|
| `Validator` | `Func<IList<char>, 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.

XamarinFormsPinView

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

XamarinFormsPinView

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README