Multi State Toggle Button
A simple multi-state toggle button for Android.
To-Do
- Support Material Design's button shadow.
- Implement basic testing
Any help is appreciated :)
Usage
dependencies {
compile 'org.honorato.multistatetogglebutton:multistatetogglebutton:0.2.2'
}
Then in your activity's XML:
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:mstb="http://schemas.android.com/apk/res-auto"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
<org.honorato.multistatetogglebutton.MultiStateToggleButton
android:id="@+id/mstb_multi_id"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="10dip"
mstb:values="@array/planets_array"
mstb:mstbPrimaryColor="@color/gray"
mstb:mstbSecondaryColor="@color/blue"/> </LinearLayout>Colors
You can change change colors via xml (see above) or programmatically :
MultiStateToggleButton button = (MultiStateToggleButton) this.findViewById(R.id.mstb_multi_id);
button.setColorRes(R.color.color_pressed, R.color.color_released);
If you don't specify any values, default colors are taken from ?attr:colorPrimary and ?attr:colorControlNormal
Others
If you need a callback for when the value changes then add this to your code:
MultiStateToggleButton button = (MultiStateToggleButton) this.findViewById(R.id.mstb_multi_id);
button.setOnValueChangedListener(new ToggleButton.OnValueChangedListener() {
@Override public void onValueChanged(int position) {
Log.d(TAG, "Position: " + position);
}
}
);
Be sure to declare an array of strings called planets_array in your strings.xml:
<string-array name="planets_array"> <item>Mer</item> <item>Venus</item> <item>Earth</item> <item>Mars</item> </string-array>The values can also be specified programmatically, plus other options:
MultiStateToggleButton button = (MultiStateToggleButton) this.findViewById(R.id.mstb_multi_id);
// With an array CharSequence[] texts = new CharSequence[]{
"abc", "def"
}
; button.setElements(texts);
// With a resource id button.setElements(R.array.planets_array);
// Resource id, position one is selected by default button.setElements(R.array.dogs_array, 1);
// Multiple elements can be selected simultaneously button.enableMultipleChoice(true);
In order to use arbitrary buttons (e.g. ImageButton)
MultiStateToggleButton button = (MultiStateToggleButton) this.findViewById(R.id.mstb_multi_id);
ImageButton button1 = (ImageButton) layoutInflater.inflate(R.layout.btn_image, button, false);
button1.setImageResource(imgResourceId1);
ImageButton button2 = (ImageButton) layoutInflater.inflate(R.layout.btn_image, button, false);
button2.setImageResource(imgResourceId2);
ImageButton button3 = (ImageButton) layoutInflater.inflate(R.layout.btn_image, button, false);
button3.setImageResource(imgResourceI3);
View[] buttons = new View[] {
button1, button2, button3
}
; button.setButtons(buttons, new boolean[buttons.length]);