Add Data Binding

Author: gcacace

README.md

@@ -10,6 +10,7 @@ Android Signature Pad is an Android library for drawing smooth signatures. It us
  * Variable point size based on velocity
  * Customizable pen color and size
  * Bitmap and SVG support
+ * Data Binding
 
 ##Installation
 
@@ -25,7 +26,7 @@ Open your `build.gradle` and make sure that Maven Central repository is declared
 ```
 Then, include the library as dependency:
 ```gradle
-compile 'com.github.gcacace:signature-pad:1.2.0'
+compile 'com.github.gcacace:signature-pad:1.2.1'
 ```
 
 ### For Maven users
@@ -35,7 +36,7 @@ Add this dependency to your `pom.xml`:
 <dependency>
   <groupId>com.github.gcacace</groupId>
   <artifactId>signature-pad</artifactId>
-  <version>1.2.0</version>
+  <version>1.2.1</version>
   <type>aar</type>
 </dependency>
 ```
@@ -45,8 +46,7 @@ Add this dependency to your `pom.xml`:
 *Please see the `/SignaturePad-Example` app for a more detailed code example of how to use the library.*
 
 1. Add the `SignaturePad` view to the layout you want to show.
-    ```xml
-
+```xml
  <com.github.gcacace.signaturepad.views.SignaturePad
      xmlns:android="http://schemas.android.com/apk/res/android"
      xmlns:app="http://schemas.android.com/apk/res-auto"
@@ -55,7 +55,8 @@ Add this dependency to your `pom.xml`:
      android:layout_height="match_parent"
      app:penColor="@android:color/black"
      />
-    ```
+```
+
 2. Configure attributes.
  * `penMinWidth` - The minimum width of the stroke (default: 3dp).
  * `penMaxWidth` - The maximum width of the stroke (default: 7dp).
@@ -66,10 +67,16 @@ Add this dependency to your `pom.xml`:
 3. Configure signature events listener
 
  An `OnSignedListener` can be set on the view:
-  ```java
+ ```java
 
  mSignaturePad = (SignaturePad) findViewById(R.id.signature_pad);
  mSignaturePad.setOnSignedListener(new SignaturePad.OnSignedListener() {
+
+      @Override
+      public void onStartSigning() {
+          //Event triggered when the pad is touched
+      }
+
      @Override
      public void onSigned() {
          //Event triggered when the pad is signed
@@ -80,13 +87,29 @@ Add this dependency to your `pom.xml`:
          //Event triggered when the pad is cleared
      }
  });
-  ```
+ ```
 
 4. Get signature data
  * `getSignatureBitmap()` - A signature bitmap with a white background.
  * `getTransparentSignatureBitmap()` - A signature bitmap with a transparent background.
  * `getSignatureSvg()` - A signature Scalable Vector Graphics document.
 
+## Data Binding
+
+The `SignaturePad` view has custom Data Binding attribute setters for all the listener events:
+
+```xml
+ <com.github.gcacace.signaturepad.views.SignaturePad
+     xmlns:android="http://schemas.android.com/apk/res/android"
+     xmlns:bind="http://schemas.android.com/apk/res-auto"
+     android:id="@+id/signature_pad"
+     android:layout_width="match_parent"
+     android:layout_height="match_parent"
+     bind:onStartSigning="@{activity.onStartSigning}"
+     bind:onSigned="@{activity.onSigned}"
+     bind:onClear="@{activity.onClear}" />
+```
+
 ## Cordova Plugin
 
 Thanks to [netinhoteixeira](https://github.com/netinhoteixeira/), there is a Cordova plugin using that library.

SignaturePad-Example/build.gradle

@@ -5,7 +5,7 @@ android {
     buildToolsVersion project.ANDROID_BUILD_TOOLS_VERSION
 
   defaultConfig {
-        minSdkVersion 8
+        minSdkVersion 9
         targetSdkVersion Integer.parseInt(project.ANDROID_BUILD_TARGET_SDK_VERSION)
         versionName project.VERSION_NAME
         versionCode Integer.parseInt(project.VERSION_CODE)

build.gradle

@@ -4,9 +4,9 @@ buildscript {
     }
 
     dependencies {
-        classpath 'com.android.tools.build:gradle:2.1.2'
-        classpath 'com.github.dcendents:android-maven-gradle-plugin:1.3'
-        classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.0'
+        classpath 'com.android.tools.build:gradle:2.2.3'
+        classpath 'com.github.dcendents:android-maven-gradle-plugin:1.5'
+        classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.7.3'
     }
 }
 

gradle.properties

@@ -1,5 +1,5 @@
-VERSION_NAME=1.2.0
-VERSION_CODE=120
+VERSION_NAME=1.2.1
+VERSION_CODE=121
 GROUP=com.github.gcacace
 
 POM_NAME=Signature Pad
@@ -16,5 +16,5 @@ POM_DEVELOPER_ID=gcacace
 POM_DEVELOPER_NAME=Gianluca Cacace
 
 ANDROID_BUILD_TARGET_SDK_VERSION=23
-ANDROID_BUILD_TOOLS_VERSION=23.0.3
+ANDROID_BUILD_TOOLS_VERSION=25.0.1
 ANDROID_BUILD_SDK_VERSION=23

gradle/wrapper/gradle-wrapper.properties

@@ -1,6 +1,6 @@
-#Tue May 10 18:06:39 EEST 2016
-distributionBase=GRADLE_USER_HOME
-distributionPath=wrapper/dists
-zipStoreBase=GRADLE_USER_HOME
-zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-2.10-all.zip
+#Thu Dec 29 19:36:38 GMT 2016
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-2.14.1-all.zip

signature-pad/build.gradle

@@ -15,9 +15,13 @@ android {
     buildToolsVersion project.ANDROID_BUILD_TOOLS_VERSION
 
     defaultConfig {
-        minSdkVersion 4
+        minSdkVersion 9
         targetSdkVersion Integer.parseInt(project.ANDROID_BUILD_TARGET_SDK_VERSION)
     }
+
+    dataBinding {
+        enabled = true
+    }
 }
 
 bintray {

signature-pad/src/main/java/com/github/gcacace/signaturepad/utils/SignaturePadBindingAdapter.java

@@ -0,0 +1,62 @@
+package com.github.gcacace.signaturepad.utils;
+
+import android.databinding.BindingAdapter;
+
+import com.github.gcacace.signaturepad.views.SignaturePad;
+
+public final class SignaturePadBindingAdapter {
+
+    @BindingAdapter("onStartSigning")
+    public static void setOnSignedListener(SignaturePad view, final OnStartSigningListener onStartSigningListener) {
+        setOnSignedListener(view, onStartSigningListener, null, null);
+    }
+
+    @BindingAdapter("onSigned")
+    public static void setOnSignedListener(SignaturePad view, final OnSignedListener onSignedListener) {
+        setOnSignedListener(view, null, onSignedListener, null);
+    }
+
+    @BindingAdapter("onClear")
+    public static void setOnSignedListener(SignaturePad view, final OnClearListener onClearListener) {
+        setOnSignedListener(view, null, null, onClearListener);
+    }
+
+    @BindingAdapter(value = {"onStartSigning", "onSigned", "onClear"}, requireAll = false)
+    public static void setOnSignedListener(SignaturePad view, final OnStartSigningListener onStartSigningListener, final OnSignedListener onSignedListener, final OnClearListener onClearListener) {
+        view.setOnSignedListener(new SignaturePad.OnSignedListener() {
+            @Override
+            public void onStartSigning() {
+                if (onStartSigningListener != null) {
+                    onStartSigningListener.onStartSigning();
+                }
+            }
+
+            @Override
+            public void onSigned() {
+                if (onSignedListener != null) {
+                    onSignedListener.onSigned();
+                }
+            }
+
+            @Override
+            public void onClear() {
+                if (onClearListener != null) {
+                    onClearListener.onClear();
+                }
+            }
+        });
+    }
+
+    public interface OnStartSigningListener {
+        void onStartSigning();
+    }
+
+    public interface OnSignedListener {
+        void onSigned();
+    }
+
+    public interface OnClearListener {
+        void onClear();
+    }
+
+}