예제를 시작하기 전에 안드로이드의 ToggleButton(토글 버튼)이 무엇인지 먼저 알아보겠습니다. 토글 버튼은 Button 뷰를 확장한 뷰로, 버튼의 상태를 체크됨(On)과 체크되지 않음(Off) 두 가지로 표현합니다. 즉, 한 번 누르면 켜지고 다시 누르면 꺼지는 스위치 형태의 버튼입니다.
이 글에서는 안드로이드에서 토글 버튼을 구현하는 방법을 단계별로 살펴보겠습니다.
1단계 – 새 프로젝트 생성
Android Studio에서 File ⇒ New Project를 선택하고, 프로젝트 생성에 필요한 정보를 모두 입력하여 새 프로젝트를 만듭니다.
2단계 – 레이아웃 XML 작성
res/layout/activity_main.xml 파일에 다음 코드를 추가합니다.
<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout
xmlns:android="https://schemas.android.com/apk/res/android"
xmlns:app="https://schemas.android.com/apk/res-auto"
xmlns:tools="https://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity">
<ToggleButton
android:id="@+id/result"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Result Data"
android:textColor="#FFF"
android:background="@color/colorPrimary"
android:textOff="Off"
android:textOn="On"
android:textSize="20sp"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintLeft_toLeftOf="parent"
app:layout_constraintRight_toRightOf="parent"
app:layout_constraintTop_toTopOf="parent" />
</android.support.constraint.ConstraintLayout>
위 코드에서는 화면 중앙에 토글 버튼 하나를 추가했습니다. textOn과 textOff 속성을 통해 버튼이 켜졌을 때와 꺼졌을 때 표시될 텍스트를 미리 지정할 수 있습니다. 사용자가 토글 버튼을 클릭할 때마다 버튼의 상태가 자동으로 전환됩니다.
3단계 – MainActivity.java 작성
src/MainActivity.java 파일에 다음 코드를 추가합니다.
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.ToggleButton;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
final ToggleButton toggleButton = findViewById(R.id.result);
toggleButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
if (toggleButton.isChecked()) {
toggleButton.setTextOn("You have Checked");
toggleButton.setChecked(true);
} else if (!toggleButton.isChecked()) {
toggleButton.setTextOff("You have not Checked");
toggleButton.setChecked(false);
}
}
});
}
}
위 코드의 핵심 로직은 다음과 같습니다. 사용자가 토글 버튼을 클릭하면 toggleButton.isChecked() 메서드로 현재 상태를 확인합니다.
- 체크된 상태인 경우:
setTextOn()으로 버튼 텍스트를 변경하고,setChecked(true)로 상태를 유지합니다. - 체크되지 않은 상태인 경우:
setTextOff()으로 버튼 텍스트를 변경하고,setChecked(false)로 상태를 설정합니다.
4단계 – 매니페스트 수정 불필요
이 예제는 별도의 권한이나 컴포넌트 등록이 필요하지 않으므로 manifest.xml 파일은 수정하지 않아도 됩니다.
앱 실행 및 결과 확인
이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 기기가 컴퓨터에 연결되어 있다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 툴바의 Run 아이콘을 클릭하고 실행할 모바일 기기를 선택하세요. 그러면 기기에 아래와 같은 초기 화면이 표시됩니다.
위 화면은 버튼이 대기 중인 초기(idle) 상태입니다. 여기서 사용자가 버튼을 클릭하면 다음과 같은 결과가 나타납니다.
위 결과에서는 버튼 텍스트가 “YOU HAVE CHECKED”로 변경되고, 내부적으로는 setChecked(true)가 호출되어 체크된 상태로 전환됩니다. 이 상태에서 다시 버튼을 클릭하면 아래와 같은 출력이 표시됩니다.
위 결과에서는 버튼 텍스트가 “YOU HAVE NOT CHECKED”로 변경되고, 내부적으로는 setChecked(false)가 호출되어 체크 해제 상태로 돌아갑니다.
이처럼 토글 버튼은 isChecked(), setChecked(), setTextOn(), setTextOff() 메서드만 활용하면 손쉽게 On/Off 상태를 제어할 수 있습니다. 설정 스위치, 알림 on/off 등 다양한 UI에서 유용하게 사용할 수 있으니 직접 응용해 보시기 바랍니다.