KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

Android-Toggle-Switch

★ 473 Open GitHub ↗

A customizable extension to Android switches that supports many items.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Android-Toggle-Switch

## Deprecation notice: this library is no longer maintained. If you are currently using it, we reccomend switching to the fork by its original developer: https://github.com/llollox/Android-Toggle-Switch

![Alt text](https://img.shields.io/badge/license-MIT-green.svg?style=flat)
[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-Android%20Toggle%20Switch-brightgreen.svg?style=flat)](http://android-arsenal.com/details/1/3235)
![Alt text](http://www.android-gems.com/badge/BelkaLab/Android-Toggle-Switch.svg)

A customizable extension of Android Switches that supports also more than 2 items.

![Sample of libray](https://raw.githubusercontent.com/BelkaLab/Android-Toggle-Switch/master/docs/screen.jpg)

## Installation

#### Gradle
Add Gradle dependency:

```groovy
dependencies {
    compile 'us.belka:androidtoggleswitch:1.2.2'
}
```

#### Maven
```xml
<dependency>
  <groupId>us.belka</groupId>
  <artifactId>androidtoggleswitch</artifactId>
  <version>1.2.2</version>
  <type>pom</type>
</dependency>
```

## Usage

#### 2 Items

```xml
<belka.us.androidtoggleswitch.widgets.ToggleSwitch
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        custom:textToggleLeft="OR"
        custom:textToggleRight="AND"/>
```

![Sample of libray with 2 items](https://raw.githubusercontent.com/BelkaLab/Android-Toggle-Switch/master/docs/2_items.gif)

#### 3 Items

```xml
<belka.us.androidtoggleswitch.widgets.ToggleSwitch
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        custom:textToggleCenter="XOR"
        custom:textToggleLeft="OR"
        custom:textToggleRight="AND"/>
```

![Sample of libray with 3 items](https://raw.githubusercontent.com/BelkaLab/Android-Toggle-Switch/master/docs/3_items.gif)

#### N - Items support

This can be accomplished only **programmatically**.

XML
```xml
<belka.us.androidtoggleswitch.widgets.ToggleSwitch
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center"/>
```

JAVA code
```java
ToggleSwitch toggleSwitch = (ToggleSwitch) findViewById(R.id.multiple_switches);
ArrayList<String> labels = new ArrayList<>();
labels.add("AND");
labels.add("OR");
labels.add("XOR");
labels.add("NOT");
labels.add("OFF");
toggleSwitch.setLabels(labels);
```
![Sample of libray with 3 items](https://raw.githubusercontent.com/BelkaLab/Android-Toggle-Switch/master/docs/n_items.gif)

NOTE: Providing a custom array of labels, the attributes textToggle[Left/Center/Right] will be ignored.

#### Multiple checked items support

```xml
<belka.us.androidtoggleswitch.widgets.MultipleToggleSwitch
        android:id="@+id/multiple_toggle_switch"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        custom:textToggleCenter="Center"
        custom:textToggleLeft="Left"
        custom:textToggleRight="Right"
        android:layout_gravity="center"
        custom:toggleWidth="82dp"/>                
```

NOTE: Please not that it's a **different** widget `MultipleToggleSwitch` instead of the previous `ToggleSwitch`.

## Getters and Setters

#### Toggle Switch

* `int getCheckedTogglePosition()` Returns the current checked position

```java
int position = toggleSwitch.getCheckedTogglePosition();
```

* `void setCheckedTogglePosition(int position)` Checks the position passed as argument

```java
int position = 3;
toggleSwitch.setCheckedTogglePosition(position);
```

#### Multiple Toggle Switch

* `void setCheckedTogglePosition(int position)` Checks the position passed as argument

```java
int position = 3;
multipleToggleSwitch.setCheckedTogglePosition(position);
```

* `void setUncheckedTogglePosition(int position)` Unchecks the position passed as argument

```java
int position = 0;
multipleToggleSwitch.setUncheckedTogglePosition(position);
```

* `Set<Integer> getCheckedTogglePositions()` Returns the set of the current checked positions

```java
Set<Integer> checkedPositions = multipleToggleSwitch.getCheckedTogglePositions();
```

## Listeners

```java
toggleSwitch.setOnToggleSwitchChangeListener(new ToggleSwitch.OnToggleSwitchChangeListener(){

@Override
            public void onToggleSwitchChangeListener(int position, boolean isChecked) {
				// Write your code ... 
            }
        });
```

## Customization

#### Attributes

It is possible to customize the buttons applying the following options:

| Option Name      				| Format                 | Description                              |
| ---------------- 				| ---------------------- | -----------------------------            |
| android:textSize 				| `dimension`  	         | Text size of each button                 |
| custom:activeBgColor         | `color`               |  Background color of the checked button    |
| custom:activeTextColor       | `color`               | Text color of the checked button |
| custom:inactiveBgColor 		| `color`		         | Background color of the inactive buttons  |
| custom:inactiveTextColor     | `color`               | Text color of the inactive buttons       |
| custom:separatorColor        | `color`               | Color of the vertical separator between inactive buttons  |
| custom:toggleWidth    		| `dimension`           | Width of each button  |
| custom:cornerRadius			| `dimension`	         | Corner Radius in dp |

#### Example

```xml
<belka.us.androidtoggleswitch.widgets.ToggleSwitch
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textSize="18sp"
        custom:activeBgColor="@android:color/holo_blue_dark"
        custom:activeTextColor="@android:color/white"
        custom:inactiveBgColor="@android:color/white"
        custom:inactiveTextColor="@android:color/black"
        custom:separatorColor="@color/gray_very_light"
        custom:textToggleCenter="APPLE"
        custom:textToggleLeft="ORANGE"
        custom:textToggleRight="BANANA"
        custom:toggleWidth="104dp"/>
```

![Sample of libray with 3 items](https://raw.githubusercontent.com/BelkaLab/Android-Toggle-Switch/master/docs/customized.gif)

## Contributors
Lorenzo Rigato,
Fabrizio Rizzonelli, Android Developer @[Belka](https://github.com/BelkaLab)

## License
Android-Toggle-Switch is Copyright (c) 2016 Belka, srl. It is free software, and may be redistributed under the terms specified in the LICENSE file.

## About Belka
![Belka Logo](https://s.gravatar.com/avatar/88dc2225d85299e04489f56d5f38a533?size=180)

[Belka](http://belka.us/en) is a Digital Agency specialized in design, mobile applications development and custom solutions.
We love open source software! You can [see our projects](http://belka.us/en/portfolio/) or look at our case studies.

Interested? [Hire us](http://belka.us/en/contacts/) to help build your next amazing project.

[www.belka.us](http://belka.us/en)

Android-Toggle-Switch

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README