Saltar al contenido principal
Versión: 0.79

ActionSheetIOS

Traducción Beta No Oficial

Esta página fue traducida por PageTurner AI (beta). No está respaldada oficialmente por el proyecto. ¿Encontraste un error? Reportar problema →

Muestra el componente hoja de acciones nativo de iOS.

Ejemplo

Referencia

Métodos

showActionSheetWithOptions()

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

Muestra una hoja de acciones de iOS. El objeto options debe contener uno o más de:

  • options (array de strings) - lista de títulos de botones (requerido)

  • cancelButtonIndex (int) - índice del botón de cancelación en options

  • cancelButtonTintColor (string) - color para cambiar el texto del botón de cancelación

  • destructiveButtonIndex (int o array de ints) - índices de botones destructivos en options

  • title (string) - título a mostrar sobre la hoja de acciones

  • message (string) - mensaje a mostrar debajo del título

  • anchor (number) - nodo al que debe anclarse la hoja de acciones (para iPad)

  • tintColor (string) - color para títulos de botones no destructivos

  • disabledButtonIndices (array de números) - índices de botones a deshabilitar

  • userInterfaceStyle (string) - estilo de interfaz (light u dark), usa estilo del sistema por defecto

La función 'callback' recibe un parámetro: el índice de base cero del elemento seleccionado.

Ejemplo mínimo:

tsx
ActionSheetIOS.showActionSheetWithOptions(
{
options: ['Cancel', 'Remove'],
destructiveButtonIndex: 1,
cancelButtonIndex: 0,
},
buttonIndex => {
if (buttonIndex === 1) {
/* destructive action */
}
},
);

dismissActionSheet()

tsx
static dismissActionSheet();

Cierra la hoja de acciones superior actual. Muestra advertencia si no hay hoja visible.


showShareActionSheetWithOptions()

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

Muestra la hoja de compartir de iOS. El objeto options debe contener uno o ambos de message y url, y además puede tener subject o excludedActivityTypes:

  • url (string) - URL para compartir

  • message (string) - mensaje para compartir

  • subject (string) - asunto del mensaje

  • excludedActivityTypes (array) - actividades a excluir

Nota: Si url apunta a un archivo local o es una URI codificada en base64, el archivo referenciado se cargará y compartirá directamente. Esto permite compartir imágenes, videos, archivos PDF, etc. Si url apunta a un archivo remoto o dirección web, debe cumplir con el formato de URL descrito en RFC 2396. Por ejemplo, una URL web sin el protocolo adecuado (HTTP/HTTPS) no se compartirá.

'failureCallback' recibe un objeto de error con propiedad opcional stack de tipo string.

'successCallback' recibe dos parámetros:

  • booleano indicando éxito/fallo

  • string indicando método de compartición (en éxito)