Skip to content

JoeTomkinson/Xama.JTPorts.ShowcaseView

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

60 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Xamarin ShowcaseView

platform API License: MIT NuGet Build: Passing

Installation

Simply install the NuGet package into your Xamarin.Android application and use as below.

This library now supports AndroidX libraries rather than v7 support libraries so it may ask you to install these dependencies in order to carry on using this control.

Package Manager:

Install-Package Xama.JTPorts.ShowcaseView -Version 1.0.1

.NET CLI:

dotnet add package Xama.JTPorts.ShowcaseView --version 1.0.1

Namespace: Xama.JTPorts.ShowcaseView

Xamarin.Android Native showcase view. An easy-to-use customizable show case view with circular reveal animation, ported from FancyShowCaseView by Faruk Toptaş

This is a ported build, converted from Java to C# for use with the Xamarin MonoFramework. There are only a couple of new additions from the original library currently.

Features

Ported Functionality

  • Circular reveal animation (API Level 21+).
  • Custom Background colors with opaque variances.
  • Circle and Rounded Rectangle focus shapes.
  • Custom title styles and position.
  • Custom view inflation.
  • Custom enter/exit animations.
  • Chaining multiple Showcase view instances.
  • Showing only one time.

Additional Functionality

  • Auto move-on for showcase queues.
  • Auto dismiss for showcases.

Customary sample GIF

!gif


Basic usage

          ShowCaseView showcase = new ShowCaseView.Builder()
                .Context(this)
                .CloseOnTouch(true)
                .FocusOn(ControlToFocusOn)
                .BackgroundColor(Color.DarkRed)
                .FocusBorderColor(Color.White)
                .FocusBorderSize(15)
                .Title("Showcase text")
                .FocusCircleRadiusFactor(1.5)
                .Build();
                
           showcase.Show();

Contribution

More than happy for people to raise issues, or submit pull requests on adjustments, optimisations or improvements to the existing port. It's been migrated over to AndroidX support libraries so there's room to improve the ways the UI animations are created potentially.

Support 💎

If you want to support the work that I do and you find any of these libraries useful? Consider supporting it by joining stargazers for this repository. 🔭 🌠


or alternatively if you want to you can also buy me a coffee.

Buy Me A Coffee

You know, only if you want to.