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
Installation
Gradle
Add it to your build.gradle with:
allprojects {
repositories {
maven { url "https://jitpack.io" }
}
}
and:
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
<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
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