Skip to main content

ActionSheetIOS

iOS에 기본적으로 내장된 Action Sheet 컴포넌트를 표시한다.

예제​

참조

메서드​

showActionSheetWithOptions()​

tsx
static showActionSheetWithOptions: (
  options: ActionSheetIOSOptions,
  callback: (buttonIndex: number) => void,
);

iOS 액션 시트를 표시한다. options 객체는 다음 중 하나 이상을 포함해야 한다:

  • options (문자열 배열) - 버튼 타이틀 목록 (필수)
  • cancelButtonIndex (정수) - options에서 취소 버튼의 인덱스
  • cancelButtonTintColor (문자열) - 취소 버튼의 텍스트 색상을 변경하는 데 사용하는 색상
  • destructiveButtonIndex (정수 또는 정수 배열) - options에서 파괴적 버튼의 인덱스
  • title (문자열) - 액션 시트 상단에 표시할 제목
  • message (문자열) - 제목 아래에 표시할 메시지
  • anchor (숫자) - 액션 시트가 고정될 노드 (iPad에서 사용)
  • tintColor (문자열) - 파괴적 버튼이 아닌 버튼 타이틀에 사용하는 색상
  • disabledButtonIndices (숫자 배열) - 비활성화할 버튼의 인덱스 목록
  • userInterfaceStyle (문자열) - 액션 시트에 사용할 인터페이스 스타일, light 또는 dark로 설정할 수 있으며, 기본 시스템 스타일이 사용된다

callback 함수는 하나의 매개변수를 받는다. 선택된 항목의 0부터 시작하는 인덱스다.

최소 예제:

tsx
ActionSheetIOS.showActionSheetWithOptions(
  {
    options: ['Cancel', 'Remove'],
    destructiveButtonIndex: 1,
    cancelButtonIndex: 0,
  },
  buttonIndex => {
    if (buttonIndex === 1) {
      /* 파괴적 액션 */
    }
  },
);

dismissActionSheet()​

tsx
static dismissActionSheet();

현재 표시된 가장 상위의 iOS 액션 시트를 닫는다. 액션 시트가 표시되지 않은 경우 경고 메시지를 출력한다.

showShareActionSheetWithOptions()​

tsx
static showShareActionSheetWithOptions: (
  options: ShareActionSheetIOSOptions,
  failureCallback: (error: Error) => void,
  successCallback: (success: boolean, method: string) => void,
);

iOS 공유 시트를 표시한다. options 객체는 message와 url 중 하나 또는 둘 다를 포함해야 하며, 추가적으로 subject나 excludedActivityTypes를 포함할 수 있다:

  • url (string) - 공유할 URL
  • message (string) - 공유할 메시지
  • subject (string) - 메시지의 제목
  • excludedActivityTypes (array) - ActionSheet에서 제외할 활동 유형

참고: url이 로컬 파일을 가리키거나 base64로 인코딩된 URI인 경우, 해당 파일이 직접 로드되어 공유된다. 이 방식으로 이미지, 비디오, PDF 파일 등을 공유할 수 있다. url이 원격 파일이나 주소를 가리키는 경우, RFC 2396에 설명된 URL 형식을 준수해야 한다. 예를 들어, 적절한 프로토콜(HTTP/HTTPS)이 없는 웹 URL은 공유되지 않는다.

failureCallback 함수는 하나의 매개변수를 받는다. 이 매개변수는 에러 객체이며, 이 객체에 정의된 유일한 프로퍼티는 선택적 stack 프로퍼티다. 이 프로퍼티는 string 타입이다.

successCallback 함수는 두 가지 매개변수를 받는다:

  • 성공 또는 실패를 나타내는 불리언 값
  • 성공한 경우, 공유 방법을 나타내는 문자열