Android button which moves in eight direction

Moving Button

Android button which moves in eight direction.

Sample Project

You can download the latest sample APK from this repo here: sample-release.apk

It's also on Google Play:

Having the sample project installed is a good way to be notified of new releases.

Gradle Dependency (jcenter)

Easily reference the library in your Android projects using this dependency in your module's build.gradle file:

dependencies {
    compile 'com.thefinestartist:movingbutton:1.0.0'
}

Requirements

It supports Android API 3+.

It uses nineoldandroid for view animation.

Attrubutes

<!--Button Move Direction (Default : all)-->
<attr name="mb_move_direction">
    <enum name="all" value="0" />
    <enum name="horizontal_vertical" value="1" />
    <enum name="horizontal" value="2" />
    <enum name="vertical" value="3" />
    <enum name="still" value="4" />
</attr>

<!--Button Movement (Default : 0dp)-->
<!--Since DEFAULT value is ZERO, set up your button movement larger than zero.-->
<!--You can set up the movement as minus value-->
<attr name="mb_movement" format="dimension" />
<attr name="mb_movement_left" format="dimension" />
<attr name="mb_movement_right" format="dimension" />
<attr name="mb_movement_top" format="dimension" />
<attr name="mb_movement_bottom" format="dimension" />

<!--Button Event Offset (Default : 16dp for inner & 23dp for outer)-->
<!--Helps to calculate touch event from button-->
<attr name="mb_offset_inner" format="dimension" />
<attr name="mb_offset_outer" format="dimension" />

<!--Vibrate on button movement (Default : 0)-->
<!--android.permission.VIBRATE Permission required-->
<!--if you set the duration as 0, no Permission required!-->
<attr name="mb_event_volume" format="integer" />

<!--Play sound on button movement (Default : 0)-->
<attr name="mb_event_volume" format="integer" />

Layout Examples

<com.thefinestartist.movingbutton.MovingButton
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/moving_button"
    android:layout_width="100dp"
    android:layout_height="40dp"
    app:mb_move_direction="vertical"
    app:mb_event_volume="0"
    app:mb_vibration_duration="20"
    app:mb_movement="10dp" />

<com.thefinestartist.movingbutton.MovingButton
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/moving_button"
    android:layout_width="100dp"
    android:layout_height="40dp"
    app:mb_move_direction="all"
    app:mb_event_volume="50"
    app:mb_vibration_duration="20"
    app:mb_movementLeft="10dp"
    app:mb_movementRight="15dp"
    app:mb_movementTop="5dp"
    app:mb_movementBottom="20dp"
    app:mb_offset_inner="16dp"
    app:mb_offset_outer="23dp" />

Setter & Getter

// Move Direction
movingButton.getMoveDirection();
movingButton.setMoveDirection(MoveDirection.ALL);

// Movement (in Pixel dimension)
movingButton.getMovement();
movingButton.setMovement(10);
movingButton.getMovementLeft();
movingButton.setMovementLeft(10);
movingButton.getMovementRight();
movingButton.setMovementRight(10);
movingButton.getMovementTop();
movingButton.setMovementTop(10);
movingButton.getMovementBottom();
movingButton.setMovementBottom(10);

// Offset (in Pixel dimension)
movingButton.getOffSetInner();
movingButton.setOffSetInner(10);
movingButton.getOffSetOuter();
movingButton.setOffSetOuter(10);

// Vibration
movingButton.getVibrationDuration();
movingButton.setVibrationDuration(20);

// Volume
movingButton.getEventVolume();
movingButton.setEventVolume(50);

// Current Position
movingButton.getCurrentPosition();

Listener

public interface OnPositionChangedListener {
    // returns MotionEvent action and changed button position
    void onPositionChanged(int action, ButtonPosition position);
}

movingButton.setOnPositionChangedListener(new MovingButton.OnPositionChangedListener() {
    @Override
    public void onPositionChanged(int action, ButtonPosition position) {
        //your code here
    }
});