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 함수는 두 개의 매개변수를 받는다:

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