Multi State Toggle Button

Additional

Language
Java
Version
0.2.2 (Jun 21, 2016)
Created
Jan 28, 2014
Updated
Mar 2, 2021 (Retired)
Owner
Jose Luis Honorato (jlhonora)
Contributors
Deepanshu Gupta (deepanshu-)
Allegraud Simon (Allsimon)
William Riyanto (eriuzo)
Matej Trakal (mtrakal)
Rainer Burgstaller (rburgstaller)
5
Activity
Badge
Generate
Download
Source code

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