Руководство Android Switch

Android Switch
Switch Styles
Switch Events

1. Android Switch

В Android. Switch это контроль интерфейса пользователя (user interface control) с 2-мя режимами ON/OFF, имеет почти такую же функцию как CheckBox, ToggleButton, но отличается в плане интерфейса.

Switch довольно похож на CheckBox, ToggleButton по функции и способу использования. Все 3 эти класса являются подклассами CompoundButton, разница только в их интерфейсе.

Image (Icon)

Switch является подклассом у Button, поэтому он позволяет вам отобразить максимум 4 символа возле 4-х сторон, используя атрибуты android:drawableLeft, android:drawableTop, android:drawableRight, android:drawableBottom, android:drawableStart, android:drawableEnd.

<Switch
    android:id="@+id/switch13"
    android:drawableLeft="@drawable/icon_bus"
    android:drawableTop="@drawable/icon_car"
    android:drawableBottom="@drawable/icon_boat"
    android:text="Switch"
    ... />

android:gravity

Атрибут android:gravity используется для настройки местоположения для отображения текста Switch. Его значение являетя сочетанием следующих значений:

Constant in Java	Value	Description
Gravity.LEFT	left
Gravity.CENTER_HORIZONTAL	center_horizontal
Gravity.RIGHT	right
~~Gravity.CLIP_HORIZONTAL~~	~~clip_horizontal~~
~~Gravity.FILL_HORIZONTAL~~	~~fill_horizontal~~

Gravity.TOP	top
Gravity.CENTER_VERTICAL	center_vertical
Gravity.BOTTOM	bottom
~~Gravity.CLIP_VERTICAL~~	~~clip_vertical~~
~~Gravity.FILL_VERTICAL~~	~~fill_vertical~~

Gravity.START	start
Gravity.END	end
Gravity.CENTER	center
~~Gravity.FILL~~	~~fill~~

<Switch
    android:id="@+id/switch13"
    android:text="Switch"
    android:gravity="bottom|center"
    ... />

android:switchPadding

Атрибут android:switchPaddiing разрешает вам настроить расстояние между track и text у Switch.

<Switch
    android:id="@+id/switch1"
    android:drawableLeft="@drawable/icon_alarm"
    android:switchPadding="10dp"
    android:text="Alarm"
    ... />

android:layoutDirection = "rtl"

Атрибут android:layoutDirection поддерживается с Android 4.2 (API Level 17), он позволяет вам настроить направление лэйаута (Layout direction) у View. По умолчанию, данный атрибут имеет значение "ltr" (Left to Right - Слева на право).

Чтобы использовать атрибут android:layoutDirection, вам нужно открыть build.gradle (Module: app) и изменить значение minSdkVersion, и удостовериться, что новое значение больше или равно 17.

<!-- Layout Direction Default: Left to Right -->
<Switch
    android:id="@+id/switch41"
    android:switchPadding="5dp"
    android:text="Alarm"
    ... />

<!-- Layout Direction: Right to Left -->
<Switch
    android:id="@+id/switch42"
    android:layoutDirection="rtl"
    android:switchPadding="5dp"
    android:text="Alarm"
    ... />

textOn/textOff

Android 5.0 (API Level 21) разрешает вам отобразить textOn/textOff соответсвующий режимам ON/OFF у Switch.

<!-- textOn/textOff = ON/OFF (Default) -->
<Switch
    android:id="@+id/switch51"
    android:text="Alarm"

    android:showText="true"
    ... />


<!-- textOn/textOff = Enabled/Disabled -->    
<Switch
    android:id="@+id/switch52"  
    android:text="Alarm"

    android:showText="true"
    android:textOff="Disabled"
    android:textOn="Enabled"
    ... />

toggle()

Все 4 класса ToggleButton, CheckBox, RadioButton, Switch являются подклассами CompoundButton поэтому они наследуют метод toggle(), Это метод часто используемый для смены их режима, с ON (Checked) на OFF (Unchecked), и наоборот.

CompoundButton button = (Switch) findViewById(R.id.switch);

button.toggle();

2. Switch Styles

Атрибут style это опция у Switch, он разрешает вам настроить стиль для Switch. Есть некоторые готовые стили в библиотеке Android готовые для вашего использования.

Примечание: На данный момент, количество готовых style в библиотеке не много, и не сильно отличаются от стиля по умолчанию. Это к большому сожалению.

Switch Styles Example

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <TextView
        android:id="@+id/textView61"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_marginStart="16dp"
        android:layout_marginTop="16dp"
        android:layout_marginEnd="16dp"
        android:text="TextAppearance.AppCompat.Widget.Switch"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

    <Switch
        android:id="@+id/switch61"
        style="@style/TextAppearance.AppCompat.Widget.Switch"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginStart="16dp"
        android:layout_marginTop="8dp"
        android:showText="false"
        android:text="Alarm"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/textView61" />

    <TextView
        android:id="@+id/textView62"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_marginStart="16dp"
        android:layout_marginTop="16dp"
        android:layout_marginEnd="16dp"
        android:text="Widget.AppCompat.CompoundButton.Switch"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/switch61" />

    <Switch
        android:id="@+id/switch62"
        style="@style/Widget.AppCompat.CompoundButton.Switch"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginStart="16dp"
        android:layout_marginTop="8dp"
        android:showText="false"
        android:text="Alarm"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/textView62" />

    <TextView
        android:id="@+id/textView63"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_marginStart="16dp"
        android:layout_marginTop="16dp"
        android:layout_marginEnd="16dp"
        android:text="Widget.Material.CompoundButton.Switch"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/switch62" />

    <Switch
        android:id="@+id/switch63"
        style="@android:style/Widget.Material.CompoundButton.Switch"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginStart="16dp"
        android:layout_marginTop="8dp"
        android:showText="false"
        android:text="Alarm"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/textView63" />

    <TextView
        android:id="@+id/textView64"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_marginStart="16dp"
        android:layout_marginTop="16dp"
        android:layout_marginEnd="16dp"
        android:text="Widget.Material.Light.CompoundButton.Switch"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/switch63" />

    <Switch
        android:id="@+id/switch64"
        style="@android:style/Widget.Material.Light.CompoundButton.Switch"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginStart="16dp"
        android:layout_marginTop="8dp"
        android:showText="false"
        android:text="Alarm"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/textView64" />

</androidx.constraintlayout.widget.ConstraintLayout>

3. Switch Events

Есть много других событий связанных с Switch, но 2 следующих событий используются чаще всего:

setOnClickListener(View.OnClickListener)
setOnCheckedChangeListener(CompoundButton.OnCheckedChangeListener)

On Click Event:

Событие, происходящее когда пользователь кликает (click) на Switch, похоже на действие пользователя при кликании на Button.

Switch switch1 = (Switch) findViewById(R.id.switch1);

switch1.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
        boolean checked = ((Switch) v).isChecked();
        if (checked){
            // Your code  
        }
        else{
            // Your code
        }
    }
});

On Checked Change Event:

Событие, происходящее когда Switch меняет режим, из-за действия пользователя или из-за эффекта от вызова метода setChecked(newState), ..

Switch switch1 = (ToggleButton) findViewById(R.id.switch1);

switch1.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
    @Override
    public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
        if(isChecked)  {
           // Your code
        } else {
           // Your code
        }
    }
});

Pуководства Android

Pуководства Flutter

Руководство Android Switch

1. Android Switch

2. Switch Styles

3. Switch Events

Pуководства Android

Pуководства Android

Новейшие статьи