Archived

I stopped developing this library for a long time ago. I thought about revising it recently but I think there is no need for it anymore due to Jetpack Compose. As an alternative to this, I recommend you to use this library made with Jetpack Compose by Zack Klippenstein: https://gist.github.com/zach-klippenstein/7ae8874db304f957d6bb91263e292117

Thank you all for your support.

RadioRealButton

Radio Real Button is a substitute of the Radio Button. Its purpose is to give more elegant view for Android users.

Preview

<br />

<br />


<br />

<br />

<br />

Installation

Gradle

Add it to your build.gradle with:

gradleCopy
allprojects {
    repositories {
        maven { url "https://jitpack.io" }
    }
}

and:

gradleCopy
dependencies {
    compile 'com.github.ceryle:RadioRealButton:v2.1.1'
}

What has changed with version 2?

• Border is now part of the round container layout.
• android:padding and rest padding attributes were working not as expected. Now, they are fixed.
• textTypeface attribute now works like button's typeface. You can give your typeface using textTypefacePath attribute.
• Default scaling value is now 1 as it has to be.

What added?

• New animations added. There was only a sliding view, but now 4 more added. You can use them with app:selectorAnimationType attribute.
• enableDeselection attribute is added. With this attribute, you can deselect buttons if you re-click on them.
• Each button has their own selector (sliding selector has still one) and you can give divider between them.
• textGravity attribute is added which is actually android:gravity. You can give 3 values which are left, center, right.

What removed?

• 'image' word is replaced with "drawable" word from all attributes which have them. Reason is everyone is used to 'drawable' word and
  how I have used ImageView in RadioRealButton is no different than regular drawable which is used in buttons expect animations.
• rrbg_shadow, rrbg_shadowElevation and its margin attributes are removed. You can use android:elevation attribute.
• rrbg_enabled is removed. You can use android:enabled attribute.

Customization

Some Attributes

Radio Real Button

Option Name	Format	Description
drawable	integer	set drawable to button
drawablePadding	dimension	set padding between text and drawable
drawableTint	color	set drawable tint by giving a color code or reference
drawableWidth	dimension	change drawable's width
drawableHeight	dimension	change drawable's height
drawableGravity	integer	set drawable position relative to text
text	string	set button's text
textColor	color	change button's text color
textSize	dimension	change button's text size
textTypeface	integer	default typefaces offered by android itself
textTypefacePath	string	give your typeface by giving its path
textFillSpace	boolean	when enabled, it pushes drawable to edges of the button
textStyle	integer	default styles offered by android itself
textGravity	integer	give text gravity(not layout_gravity)
ripple	boolean	set it true for default ripple
rippleColor	color	give any color to achieve colorful ripples
backgroundColor	color	give background color by giving a color code or reference
checked	boolean	its usage is the same as radio button

Radio Real Button Group

Option Name	Format	Description
radius	integer	set radius to make radio real button group rounder
borderSize	dimension	adds border to group with the given size
borderColor	dimension	changes border color
backgroundColor	color	give background color by giving a color code or reference
enableDeselection	color	enable deselection to un-check a button
dividerSize	dimension	set divider size for the line between buttons
dividerPadding	dimension	gives padding to divider's top and bottom
dividerColor	color	give color code or reference
dividerRadius	dimension	give dimension to make divider's corners rounder
selectorDividerSize	dimension	set selector divider size for the line between buttons
selectorDividerPadding	dimension	gives padding to selector divider's top and bottom
selectorDividerColor	color	give color code or reference
selectorDividerRadius	dimension	give dimension to make selector divider's corners rounder
bottomLineColor	color	set bottom line color
bottomLineSize	dimension	set bottom line height
bottomLineBringToFront	boolean	if it is true, it brings bottomLine on top of selector
bottomLineRadius	dimension	give dimension to make bottomLine's corners rounder
selectorTop	boolean	align selector to top
selectorBottom	boolean	align selector to bottom
selectorColor	color	set color of selector
selectorSize	dimension	set height of selector
selectorRadius	dimension	give dimension to make selector's corners rounder
selectorBringToFront	boolean	if it is true, it brings selector on top of everything
selectorAboveOfBottomLine	boolean	if it is true, it brings selector above of bottom line
selectorFullSize	boolean	selector fills space up to button's height
checkedPosition	integer	check a button by a position number
checkedButton	reference	check a button by button's unique id
animate	boolean	set animation on bottom moving view
animateSelector	integer	gives interpolator to selector
animateSelector_delay	integer	gives delay to selector's animation when it enters
animateSelector_duration	integer	animation duration of selector in ms
animateDrawables_scale	float	adjust drawable's size when it is checked
animateDrawables_enter	integer	enter animation on drawable when button is checked
animateDrawables_enterDuration	integer	enter animation duration of drawable in ms
animateDrawables_exit	integer	exit animation on drawable when other button is checked
animateDrawables_exitDuration	integer	exit animation duration of drawable in ms
animateTexts_scale	float	adjust text's size when it is checked
animateTexts_enter	integer	enter animation on text when button is checked
animateTexts_enterDuration	integer	enter animation duration of text in ms
animateTexts_exit	integer	exit animation on text when other button is checked
animateTexts_exitDuration	integer	exit animation duration of text in ms
animateDrawables_tintColorFrom	color	initial color for drawable's tint color transition animation
animateDrawables_tintColorTo	color	final color for drawable's tint color transition animation
animateDrawables_tintColor_duration	integer	total animation duration of drawable's tint transition in ms
animateTexts_textColorFrom	color	initial color for text's text color transition animation
animateTexts_textColorTo	color	final color for text's text color transition animation
animateTexts_textColor_duration	integer	total animation duration of text's text color in ms

Examples

In Xml Layout

xmlCopy
<co.ceryle.radiorealbutton.RadioRealButtonGroup
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:rrbg_animateDrawables_enter="overshoot"
    app:rrbg_animateTexts_enter="overshoot"
    app:rrbg_dividerColor="@color/black"
    app:rrbg_dividerSize="1dp"
    app:rrbg_radius="10dp"
    app:rrbg_selectorColor="@color/red_700"
    app:rrbg_selectorSize="6dp">

    <co.ceryle.radiorealbutton.RadioRealButton
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        app:rrb_drawable="@mipmap/ic_launcher"
        app:rrb_drawableHeight="36dp"
        app:rrb_drawablePadding="8dp"
        app:rrb_drawableWidth="36dp"
        app:rrb_ripple="true"
        app:rrb_rippleColor="@color/black"
        app:rrb_text="Button 1"
        app:rrb_textColor="@color/black"/>

    <co.ceryle.radiorealbutton.RadioRealButton
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        app:rrb_drawable="@mipmap/ic_launcher"
        app:rrb_drawableGravity="right"
        app:rrb_drawableHeight="36dp"
        app:rrb_drawablePadding="8dp"
        app:rrb_drawableWidth="36dp"
        app:rrb_ripple="true"
        app:rrb_rippleColor="@color/black"
        app:rrb_text="Button 2"
        app:rrb_textColor="@color/black"/>
</co.ceryle.radiorealbutton.RadioRealButtonGroup>

Listener Example

javaCopy
final RadioRealButton button1 = (RadioRealButton) findViewById(R.id.button1);
final RadioRealButton button2 = (RadioRealButton) findViewById(R.id.button2);

RadioRealButtonGroup group = (RadioRealButtonGroup) findViewById(R.id.group);

// onClickButton listener detects any click performed on buttons by touch
group.setOnClickedButtonListener(new RadioRealButtonGroup.OnClickedButtonListener() {
    @Override
    public void onClickedButton(RadioRealButton button, int position) {
        Toast.makeText(MainActivity.this, "Clicked! Position: " + position, Toast.LENGTH_SHORT).show();
    }
});

// onPositionChanged listener detects if there is any change in position
group.setOnPositionChangedListener(new RadioRealButtonGroup.OnPositionChangedListener() {
    @Override
    public void onPositionChanged(RadioRealButton button, int position) {
        Toast.makeText(MainActivity.this, "Position Changed! Position: " + position, Toast.LENGTH_SHORT).show();
    }
});

// onLongClickedButton detects long clicks which are made on any button in group.
// return true if you only want to detect long click, nothing else
// return false if you want to detect long click and change position when you release
group.setOnLongClickedButtonListener(new RadioRealButtonGroup.OnLongClickedButtonListener() {
    @Override
    public boolean onLongClickedButton(RadioRealButton button, int position) {
        Toast.makeText(MainActivity.this, "Long Clicked! Position: " + position, Toast.LENGTH_SHORT).show();
        return false;
    }
});

License

This project is licensed under the Apache License Version 2.0 - see the LICENSE.md file for details