HOWTO · React Native

React Native의 아이콘 버튼

이 튜토리얼에서는 React Native에 아이콘 버튼을 포함하는 방법에 대해 설명합니다.

이 페이지의 내용

아이콘 버튼은 익숙한 단일 동작을 위한 작은 컨트롤입니다. React Native에서는 react-native-paper의 IconButton을 사용해 아이콘을 표시하고, 접근성 레이블을 지정한 뒤 onPress 콜백을 연결할 수 있습니다. 이 가이드에서는 하나의 라이브러리만 사용합니다. 설정 방법은 앱이 Expo를 사용하는지, 기본 React Native 프로젝트인지에 따라 달라집니다.

아이콘 버튼의 역할

아이콘 버튼은 알림을 나타내는 종 모양 아이콘처럼, 누를 수 있는 컨트롤과 아이콘을 결합합니다. 동작을 쉽게 알아볼 수 있다면 공간을 절약할 수 있지만 아이콘만으로는 의미가 모호할 수 있습니다. 동작을 설명하는 접근성 레이블을 추가하고, 아이콘의 의미를 모를 수 있는 사용자를 위해 주변에 텍스트 레이블도 표시하세요.

아이콘 라이브러리 선택 및 설정

이 예제에서는 여러 아이콘 패키지를 섞어 쓰지 않고 react-native-paper를 사용합니다. 앱에 맞는 패키지 관리자로 이 라이브러리와 safe-area 의존성을 설치하세요.

  • Expo: npx expo install react-native-paper react-native-safe-area-context를 실행합니다. Expo는 프로젝트의 SDK와 호환되는 버전을 선택합니다.
  • 기본 React Native: npm install react-native-paper react-native-safe-area-context를 실행합니다. 선택한 Paper 버전에서 bell 아이콘에 별도의 아이콘 패키지가 필요한 경우, 해당 버전의 설정 가이드에 나온 패키지도 설치하세요. 지원되는 버전에서는 React Native가 네이티브 의존성을 자동 연결합니다. 네이티브 패키지를 설치한 뒤 앱을 다시 빌드하고, 사용 중인 버전의 안내에 따라 필요한 경우에만 수동 연결을 추가하세요.

그런 다음 react-native-paper에서 가져온 PaperProvider로 앱(또는 Paper 컴포넌트를 사용하는 화면 트리)을 감싸세요. 이 provider를 통해 라이브러리 테마를 사용할 수 있습니다. 최소한의 루트 설정은 return <PaperProvider><App /></PaperProvider>;입니다. 앱 루트 컴포넌트를 새로 만들지 말고 기존 컴포넌트에 래퍼를 추가하세요. 설정은 Expo SDK, React Native 버전, Paper 릴리스에 따라 달라질 수 있으므로, 설치된 버전에 맞는 React Native Paper 공식 시작 가이드와 아이콘 설정 안내를 확인하세요.

아이콘 버튼 만들기 및 사용자 지정

react-native-paper에서 IconButton을 가져와 화면 컴포넌트에 배치하세요. 다음 컴포넌트 예시는 앱에서 적용할 코드를 보여줍니다. 제공된 문서 실행 환경에는 React Native나 react-native-paper가 없으므로, 실행을 확인한 예제로 제시하는 것은 아닙니다.

import { IconButton } from 'react-native-paper';

function NotificationsButton({ onPress }) { return <IconButton icon="bell" size={28} iconColor="#FFFFFF" containerColor="#315EFB" accessibilityLabel="알림 보기" onPress={onPress} />; }

icon 값은 라이브러리의 아이콘을 선택하고, size는 크기를 조절하며, 색상 속성은 아이콘과 버튼 배경의 색을 지정합니다. 이미지 자체가 아니라 동작을 설명하는 레이블을 선택하세요. 설치된 패키지 버전에서 다른 속성이나 아이콘 이름을 제공한다면 해당 버전의 API 문서를 따르세요. 버튼이 화면 배경과 구분되도록 충분한 대비를 유지하세요.

누름 동작 처리 및 결과 확인

onPress에 함수를 전달하세요. React Native Paper는 컨트롤을 누르면 이 함수를 호출합니다. 다음 독립 실행형 JavaScript 예제는 모바일 UI 패키지를 가져오지 않고 핸들러의 흐름을 보여줍니다. 네이티브 화면을 렌더링하지는 않습니다. 앱에서는 같은 핸들러를 NotificationsButton에 전달하고 시뮬레이터나 기기에서 컨트롤이 표시되는지와 동작이 실행되는지 모두 확인하세요.

다음 예제를 실행합니다.

이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.

function createNotificationsButton(onPress) {
  return { accessibilityLabel: 'Show notifications', onPress };
}

const button = createNotificationsButton(() => console.log('Notifications opened'));
button.onPress();
Notifications opened

앱을 확인할 때 아이콘이 표시되는지, 플랫폼의 접근성 도구가 레이블을 읽어 주는지, 버튼을 눌렀을 때 의도한 동작이 실행되는지 확인하세요. 아이콘이 보이지 않으면 패키지 설정이 앱 유형 및 설치된 버전과 맞는지 살펴보세요. 콜백이 실행되지 않으면 핸들러를 onPress에 전달했는지, 다른 뷰가 터치를 가로채고 있지 않은지 확인하세요.