Skip to main content
Version: Next

useColorScheme

이 문서는 useColorScheme에 대한 설명을 담고 있다. useColorScheme은 사용자의 시스템 색상 스키마(라이트 모드 또는 다크 모드)를 감지하고 관리하는 데 사용되는 React 훅이다. 이 훅을 활용하면 사용자의 시스템 설정에 따라 애플리케이션의 테마를 동적으로 변경할 수 있다.

useColorScheme를 사용하면 다음과 같은 이점이 있다:

  • 사용자의 시스템 설정에 따라 애플리케이션의 테마를 자동으로 조정한다.
  • 라이트 모드와 다크 모드 간 전환을 쉽게 구현한다.
  • 사용자 경험을 개선하고 접근성을 높인다.

이 문서는 useColorScheme의 사용법과 주요 기능을 단계별로 안내한다. React 개발자가 시스템 색상 스키마를 효과적으로 활용할 수 있도록 실용적인 예제와 함께 설명한다.

tsx
import {useColorScheme} from 'react-native';

useColorScheme React 훅은 Appearance 모듈에서 제공하는 컬러 스킴 업데이트를 구독하고 반환한다. 반환 값은 현재 사용자가 선호하는 컬러 스킴을 나타낸다. 이 값은 사용자가 직접 설정을 변경하거나(예: 기기 설정에서 테마 선택), 일정에 따라(예: 낮과 밤 주기에 따라 변경되는 라이트 및 다크 테마) 나중에 업데이트될 수 있다.

지원하는 색상 스키마

  • "light": 사용자가 밝은 색상 테마를 선호한다.
  • "dark": 사용자가 어두운 색상 테마를 선호한다.
  • null: 사용자가 선호하는 색상 테마를 지정하지 않았다.

이 훅을 사용해 라이트 모드와 다크 모드를 지원하는 완전한 예제는 AppearanceExample.js에서 확인할 수 있다. 이 예제는 React context와 함께 사용해 애플리케이션에 테마 지원을 추가하는 방법을 보여준다.