Android 中的 Switch 组件允许用户在两种状态之间切换,通常表示打开或关闭某种功能或选项。与 ToggleButton 类似,Switch 也具有两种状态,但与 ToggleButton 不同的是,Switch 在 UI 上会同时显示开和关状态的文本,并且开关状态更加直观。
Switch (开关) 继承自 Button 和 CompoundButton,所以拥有它们的属性、方法和事件。
Switch 组件提供了一系列属性,让您可以根据需要自定义开关的外观和行为。以下是一些常用的属性:
- android:showText:设置在开启和关闭状态时是否显示文字。
- android:splitTrack:确定开关滑块与底部轨道之间是否显示间隔。
- android:switchMinWidth:设置开关的最小宽度。
- android:switchPadding:设置滑块内文字与滑块边缘之间的间距。
- android:switchTextAppearance:设置开关的文字外观。
- android:textOff:设置在按钮未选中时显示的文字。
- android:textOn:设置在按钮选中时显示的文字。
- android:textStyle:设置文字的样式,例如普通、粗体、斜体或粗斜体。
- android:track:设置底部轨道的图片。
- android:thumb:设置开关滑块的图片。
- android:typeface:设置文字的字体类型,默认支持三种:sans、serif 和 monospace。
例子
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="horizontal"
android:gravity="center">
<Switch
android:id="@+id/switchButton"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:textOn="开"
android:textOff="关"
android:checked="true"
android:showText="true"
android:layout_margin="16dp"
android:switchPadding="8dp"
android:switchMinWidth="120dp"
android:textStyle="bold"
android:textSize="16sp"
android:layout_gravity="center"/>
</LinearLayout>
改变 Switch 的状态和文本
Switch 提供了一些方法用来改变或获取自身的状态和开关时的文本
- getTextOff():获取 Switch 关闭时显示的文本。
- getTextOn():获取 Switch 打开时显示的文本。
- setChecked(boolean checked):设置 Switch 是否选中。
- setTextOff(CharSequence textOff):设置 Switch 关闭时显示的文本。
- setTextOn(CharSequence textOn):设置 Switch 打开时显示的文本。
- toggle():改变 Switch 的开关状态。
- CompoundButton.OnCheckedChangeListener:当 Switch 的开关状态改变时触发的事件。
例子:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="horizontal"
android:gravity="center">
<Switch
android:id="@+id/switchButton"
android:layout_width="wrap_content"
android:layout_height="wrap_content" />
<Button
android:id="@+id/changeButton"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="切换开关" />
</LinearLayout>
package com.example.myapplication;
import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.CompoundButton;
import android.widget.Switch;
import android.widget.Toast;
import android.widget.ToggleButton;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
Switch switchButton = findViewById(R.id.switchButton);
// 设置 Switch 关闭时的文本
switchButton.setTextOff("Off");
// 设置 Switch 打开时的文本
switchButton.setTextOn("On");
// 设置 Switch 的初始状态为打开
switchButton.setChecked(true);
// 设置 Switch 的状态改变监听器
switchButton.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
@Override
public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
if (isChecked) {
// Switch 打开时的操作
Toast.makeText(MainActivity.this, "开关打开", Toast.LENGTH_SHORT).show();
} else {
// Switch 关闭时的操作
Toast.makeText(MainActivity.this, "开关关闭", Toast.LENGTH_SHORT).show();
}
}
});
// 点击按钮来改变 Switch 的状态
findViewById(R.id.changeButton).setOnClickListener(v -> switchButton.toggle());
}
}