설정 (setting)
개요
setting 네임스페이스는 앱의 주요 설정 기능을 제어하는 기능을 제공합니다.
이 네임스페이스에서는 OS 설정 화면을 열거나, 당겨서 새로고침(Pull to Refresh) 및
화면 확대 지원(Zoom Support) 과 같은 기능을 활성화하거나 비활성화할 수 있습니다.
setting 네임스페이스는 v1.4.0에서 추가되었으며, 기존 refresh 네임스페 이스의 일부 기능이 이동되었습니다.
메서드 목록
| 메서드 | 설명 | 추가된 버전 |
|---|---|---|
openSetting() | OS 앱 설정 화면으로 이동합니다. | v1.4.2 |
setPullToRefresh(enable) | 당겨서 새로고침 기능을 활성화 또는 비활성화합니다. | v1.4.0 |
setSupportZoom(enable) | 화면 확대 기능을 활성화 또는 비활성화합니다. | v1.4.0 |
메서드 상세
openSetting(): void
- since : v1.4.2
설명
OS 앱 설정 화면을 엽니다.
이 메서드를 호출하면 앱의 설정 화면이 열리며, 사용자는 푸시 알림 설정, 위치 권한, 네트워크 설정 등 다양한 옵션을 변경할 수 있습니다.
앱에서 직접 접근할 수 없는 설정을 변경해야 할 때 OS 설정 화면을 열어 사용자에게 안내할 수 있습니다.
반환 값
해당 메서드는 반환 값을 가지지 않습니다.
사용 예제
// OS 앱 설정 화면 열기
Nachocode.setting.openSetting();
setPullToRefresh(enable: boolean): void
- since : v1.4.0
설명
사용자의 편의를 위해 화면을 아래로 당겨 새로고침하는 제스처(Pull to Refresh)를 허용하거나 제한합니다.
기존에 refresh 네임스페이스의 setPullToRefresh() 메서드가 이곳으로 이동되었습니다.
현재 안드로이드 앱에서 Pull-To-Refresh 기능을 활성화 할 경우,
메인 스크롤이 최상단에 있을 때 내부 요소의 스크롤을 내리면 Pull-To-Refresh가 일어나는 현상이 있습 니다.
추 후, nachocode의 업데이트 패치 전까지 사용에 유의하시길 바랍니다.
이 기능은 SDK v1.4.0부터 기존 refresh 네임스페이스에서 setting 네임스페이스로 통합되었으며,
refresh 네임스페이스는 더 이상 사용되지 않습니다.
매개변수
| 이름 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
enable | boolean | ✅ | true - 활성화, false - 비활성화 |
반환 값
해당 메서드는 반환 값을 가지지 않습니다.
사용 예제
// 당겨서 새로고침 기능 활성화
Nachocode.setting.setPullToRefresh(true);
// 당겨서 새로고침 기능 비활성화
Nachocode.setting.setPullToRefresh(false);
setSupportZoom(enable: boolean): void
- since : v1.4.0
설명
앱 화면에서 화면 확대(Zoom) 기능 지원 여부를 설정합니다.
이 메서드를 사용하여 사용자가 두 손가락으로 화면을 확대할 수 있도록 허용하거나 제한할 수 있습니다.
문서 및 콘텐츠의 세부 정보를 확대할 필요가 있는 페이지에서는 이 기능을 활성화하는 것이 좋습니다.
매개변수
| 이름 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
enable | boolean | ✅ | true - 확대 기능 활성화, false - 확대 기능 비활성화 |
반환 값
해당 메서드는 반환 값을 가지지 않습니다.
사용 예제
// 화면 확대 기능 활성화
Nachocode.setting.setSupportZoom(true);
// 화면 확대 기능 비활성화
Nachocode.setting.setSupportZoom(false);