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]);