• Stars
    star
    197
  • Rank 191,904 (Top 4 %)
  • Language
    C#
  • License
    MIT License
  • Created almost 6 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

UI-responsive touch effects for Xamarin.Forms

TouchEffect was merged into XamarinCommunityToolkit xamarin/XamarinCommunityToolkit#566 I highly recommed to use TouchEffect from XCT

TouchEff effect for Xamarin Forms (Repsonisve touches without TapGestureRecognizer)

This plugin provides opportunity to create views with touch effects without using TapGestureRecognizer. It makes it possible to change the appearance of any control in response to touch events, either directly via xaml or with your custom logic hooked up to the events which this plugin exposes.

With this plugin it is also possible to respond to hover events (if the platform exposes them) and to display native touch feedback events (Tilt on UWP, Ripple on Android, Opacity/Color changing on iOS).

Build Status

  • Azure DevOps: Build status

GIF

TouchImage Fade / Ripple Background color / Transformations IsToggled / image

Setup

  • Available on NuGet: TouchView NuGet
  • Add nuget package to your Xamarin.Forms .netStandard/PCL project and to your platform-specific projects (iOS and Android)
  • Add TouchEffectPreserver.Preserve() line to your AppDelegate and MainActivity (preserve from linker)
Platform Version
Xamarin.iOS 8.0+
Xamarin.Android 15+
Xamarin.Mac All
Xamarin.UWP 10+
Tizen.NET 4.0+
Xamarin.UWP - Build on Release with .NET Native tool chain note
using System.Reflection;
...
var assembliesToInclude = new List<Assembly>
{
    typeof(PlatformTouchEff).GetTypeInfo().Assembly,
    ...
};
Xamarin.Forms.Forms.Init(e, assembliesToInclude);

TouchEffectPreserver.Preserve();

Samples

The samples you can find here https://github.com/AndreiMisiukevich/TouchEffect/tree/master/TouchEffectSample

XAML: use TouchEff for achieving repsonsive UI (Changing background image or/and background color or/and opacity or/and scale).

Use TouchEff attached properties for setting up touch visual effect.

...
  xmlns:touch="clr-namespace:TouchEffect;assembly=TouchEffect"
...
       <ContentView
            touch:TouchEff.PressedAnimationDuration="800"
            touch:TouchEff.RegularAnimationDuration="800"
            touch:TouchEff.PressedScale="0.9"
            touch:TouchEff.PressedOpacity="0.6"
            touch:TouchEff.RippleCount="-1"
            touch:TouchEff.Command="{Binding Command}">
            
            Padding="10, 5"
            BackgroundColor="Black"
            VerticalOptions="CenterAndExpand"
            HorizontalOptions="CenterAndExpand">
            
            <Label Text="CLICK ME" 
                   TextColor="White" 
                   FontSize="60"/>
            
        </ContentView>
...
       <StackLayout
            touch:TouchEff.RegularBackgroundColor="Green"
            touch:TouchEff.PressedBackgroundColor="Red"
            touch:TouchEff.PressedScale="1.2"
            touch:TouchEff.RippleCount="1"
            touch:TouchEff.PressedRotation="10"
            touch:TouchEff.PressedRotationX="15"
            touch:TouchEff.PressedRotationY="15"
            touch:TouchEff.PressedTranslationX="5"
            touch:TouchEff.PressedTranslationY="5"
            touch:TouchEff.PressedAnimationDuration="500"
            touch:TouchEff.RegularAnimationDuration="500"
            touch:TouchEff.Command="{Binding Command}">

            Padding="10, 5"
            VerticalOptions="CenterAndExpand"
            HorizontalOptions="CenterAndExpand">

            <Label Text="CLICK ME" 
                   TextColor="Black" 
                   FontSize="60"/>
        </StackLayout>

If you wish to change Image Source on touch, you should use TouchImage control. It has several bindable properties for managing Pressed/Regular Source/Aspect of the image.

...
  xmlns:touch="clr-namespace:TouchEffect;assembly=TouchEffect"
...
       <touch:TouchImage
            VerticalOptions="CenterAndExpand"
            HorizontalOptions="CenterAndExpand"
            HeightRequest="250"
            WidthRequest="250"
            RegularBackgroundImageSource="button"
            PressedBackgroundImageSource="button_pressed"
            touch:TouchEff.Command="{Binding Command}"
            />

TouchEff Attached Properties

Property Type Default Description
IsAvailable bool true Makes effect available
ShouldMakeChildrenInputTransparent bool true Makes layout's children input trasparent
Command ICommand null Touch Command handler
CommandParameter object null Touch Command handler parameter
Status TouchStatus Completed Current touch status
State TouchState Regular Current touch state
RegularBackgroundColor Color Default Background color of regular state
PressedBackgroundColor Color Default Background color of pressed state
HoveredBackgroundColor Color Default Background color of hovered state
RegularOpacity double 1.0 Opacity of regular state
PressedOpacity double 1.0 Opacity of pressed state
HoveredOpacity double 1.0 Opacity of hovered state
RegularScale double 1.0 Scale of regular state
PressedScale double 1.0 Scale of pressed state
HoveredScale double 1.0 Scale of hovered state
RegularTranslationX double 0.0 TranslationX of regular state
PressedTranslationX double 0.0 TranslationX of pressed state
HoveredTranslationX double 0.0 TranslationX of hovered state
RegularTranslationY double 0.0 TranslationY of regular state
PressedTranslationY double 0.0 TranslationY of pressed state
HoveredTranslationY double 0.0 TranslationY of hovered state
RegularRotation double 0.0 Rotation of regular state
PressedRotation double 0.0 Rotation of pressed state
HoveredRotation double 0.0 Rotation of hovered state
RegularRotationX double 0.0 RotationX of regular state
PressedRotationX double 0.0 RotationX of pressed state
HoveredRotationX double 0.0 RotationX of hovered state
RegularRotationY double 0.0 RotationY of regular state
PressedRotationY double 0.0 RotationY of pressed state
HoveredRotationY double 0.0 RotationY of hovered state
AnimationDuration int 0 The common duration of animation
AnimationEasing Easing null The common easing of animation
PressedAnimationDuration int 0 The duration of animation by applying PressedOpacity and/or PressedBackgroundColor and/or PressedScale
PressedAnimationEasing Easing null The easing of animation by applying PressedOpacity and/or PressedBackgroundColor and/or PressedScale
HoveredAnimationDuration int 0 The duration of animation by applying HoveredOpacity and/or HoveredBackgroundColor and/or HoveredScale
HoveredAnimationEasing Easing null The easing of animation by applying HoveredOpacity and/or HoveredBackgroundColor and/or HoveredScale
RegularAnimationDuration int 0 The duration of animation by applying RegularOpacity and/or RegularBackgroundColor and/or RegularScale
RegularAnimationEasing Easing null The easing of animation by applying RegularOpacity and/or RegularBackgroundColor and/or RegularScale
RippleCount int 0 This property allows to set ripple of animation (Pressed/Hovered/Regular animation loop). '0: disabled'; '-1: infinite loop'; '1, 2, 3 ... n: Ripple's interations'
IsToggled bool? null This property allows to achieve "switch" behavior. null means that feature is disabled and view will return to inital state after touch releasing
DisallowTouchThreshold int 0 Movement threshold for considering android touch as canceled
NativeAnimation bool false If native platform touch feedback animations are present (Tilt on UWP, Ripple on Android, Opacity/Color on iOS)
NativeAnimationColor Color Color.Default The color used for the native touch feedback animation
NativeAnimationRadius int -1 The radius of the native ripple animation on Android or Layer radius on iOS

TouchEff Attached events

Event Type Default Description
StatusChanged TEffectStatusChangedHandler null Touch status changed
StateChanged TEffectStateChangedHandler null Touch state changed
HoverStatusChanged TEffectHoverStatusChangedHandler null Hover status changed
HoverStateChanged TEffectHoverStateChangedHandler null Hover state changed
Completed TEffectCompletedHandler null User tapped
AnimationStarted AnimationStartedHandler null Animation started

TouchImage Bindable Properties

Property Type Default Description
RegularBackgroundImageSource ImageSource null Background image source of regular state
PressedBackgroundImageSource ImageSource null Background image source of pressed state
HoveredBackgroundImageSource ImageSource null Background image source of hovered state
RegularBackgroundImageAspect Aspect AspectFit Background image aspect of regular state
PressedBackgroundImageAspect Aspect AspectFit Background image aspect of pressed state
HoveredBackgroundImageAspect Aspect AspectFit Background image aspect of hovered state

If you want to customize/extend existing controls, you may observe State property via triggers

Check source code for more info, or just ask me =)

License

The MIT License (MIT) see License file

Contribution

Feel free to create issues and PRs πŸ˜ƒ

More Repositories

1

CardView

CardsView | CarouselView | CoverflowView | CubeView for Xamarin.Forms
C#
709
star
2

HotReload

Xamarin.Forms XAML hot reload, live reload, live xaml
C#
416
star
3

ContextMenu

ContextView for Xamarin.Forms
C#
281
star
4

ExpandableView

Expandable view for Xamarin.Forms
C#
175
star
5

CardView.MAUI

CardsView | CarouselView | CoverflowView | CubeView for .NET Maui
C#
87
star
6

OpenTok-Xamarin.Forms

Vonage | TokBox | OpenTok: Video/Audio Chat library for Xamarin.Forms
C#
81
star
7

XamarinFormsProfilePage

Xamarin.Forms Profile Page
C#
65
star
8

Xamarin.Forms.Vonage

C#
24
star
9

RawRows

C#
19
star
10

RangeSlider

C#
17
star
11

SideMenu

C#
17
star
12

SegmentedCircleView

SegmentedCircleView for xamarin forms
C#
10
star
13

BaseViewModel

BaseViewModel
C#
10
star
14

Instagramarin

Instagram Profile page UI challenge
C#
8
star
15

Xamarin.HybridWebView

Hybrid WebView for Xamarin applications
C#
7
star
16

GalleyFramework

C#
6
star
17

AvengersCards

Xamarin.Forms | CardsView | PancakeView
C#
6
star
18

TouchEffectSample

C#
6
star
19

Task-manager

Task manager on C# with charts of CP and Memory
C#
5
star
20

DB-ORM-DBMS

Own Database, own Object-Relational Mapping for work with it, own Database Management System. Only for education!
C#
5
star
21

Chatter

Chatter
C#
3
star
22

PanGestureRecognizerIssueReproduction

C#
3
star
23

HttpListenerSample

https://github.com/1iveowl/Simple-Http-Listener-PCL (Simple httplistener samples)
C#
3
star
24

vts-xamarin-ios

C#
3
star
25

FluentLayout

Xamarin.Forms Fluent Layout
C#
3
star
26

ZipCodeParser

C#
3
star
27

RangeSliderSample

Xamarin.Forms RangeSlider sample
C#
2
star
28

XCTValidatorDemo

C#
2
star
29

AvatarViewSample

C#
1
star