mirror of
https://github.com/facebook/react-native.git
synced 2025-11-01 09:14:26 +00:00
Paul Mandel
305ca337c0
Summary: Bringing the typescript function signature in-line with the js code. ## Changelog [GENERAL] [FIXED] - Added AlertOptions argument to the type definition for Alert.prompt to bring it into parity with the js code. <!-- Help reviewers and the release process by writing your own changelog entry. Pick one each for the category and type tags: For more details, see: https://reactnative.dev/contributing/changelogs-in-pull-requests --> Pull Request resolved: https://github.com/facebook/react-native/pull/35957 Test Plan: Before the change, VS Code would show a typescript error when I pass AlertOptions to Alert.prompt (even though the js would execute successfully and respect the options I passed. After the change, when I use an Alert.prompt in VS code the function signature was recognized without errors. Reviewed By: christophpurrer Differential Revision: D42737818 Pulled By: jacdebug fbshipit-source-id: 4d4318f38f5c7b7302aae62de5ce224db67e088a
92 lines
2.5 KiB
TypeScript
92 lines
2.5 KiB
TypeScript
/**
|
|
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
*
|
|
* This source code is licensed under the MIT license found in the
|
|
* LICENSE file in the root directory of this source tree.
|
|
*
|
|
* @format
|
|
*/
|
|
|
|
/**
|
|
* @see https://reactnative.dev/docs/alert#content
|
|
*/
|
|
export interface AlertButton {
|
|
text?: string | undefined;
|
|
onPress?: ((value?: string) => void) | undefined;
|
|
isPreferred?: boolean;
|
|
style?: 'default' | 'cancel' | 'destructive' | undefined;
|
|
}
|
|
|
|
interface AlertOptions {
|
|
/** @platform android */
|
|
cancelable?: boolean | undefined;
|
|
userInterfaceStyle?: 'unspecified' | 'light' | 'dark';
|
|
/** @platform android */
|
|
onDismiss?: (() => void) | undefined;
|
|
}
|
|
|
|
/**
|
|
* Launches an alert dialog with the specified title and message.
|
|
*
|
|
* Optionally provide a list of buttons. Tapping any button will fire the
|
|
* respective onPress callback and dismiss the alert. By default, the only
|
|
* button will be an 'OK' button.
|
|
*
|
|
* This is an API that works both on iOS and Android and can show static
|
|
* alerts. On iOS, you can show an alert that prompts the user to enter
|
|
* some information.
|
|
*
|
|
* ## iOS
|
|
*
|
|
* On iOS you can specify any number of buttons. Each button can optionally
|
|
* specify a style, which is one of 'default', 'cancel' or 'destructive'.
|
|
*
|
|
* ## Android
|
|
*
|
|
* On Android at most three buttons can be specified. Android has a concept
|
|
* of a neutral, negative and a positive button:
|
|
*
|
|
* - If you specify one button, it will be the 'positive' one (such as 'OK')
|
|
* - Two buttons mean 'negative', 'positive' (such as 'Cancel', 'OK')
|
|
* - Three buttons mean 'neutral', 'negative', 'positive' (such as 'Later', 'Cancel', 'OK')
|
|
*
|
|
* ```
|
|
* // Works on both iOS and Android
|
|
* Alert.alert(
|
|
* 'Alert Title',
|
|
* 'My Alert Msg',
|
|
* [
|
|
* {text: 'Ask me later', onPress: () => console.log('Ask me later pressed')},
|
|
* {text: 'Cancel', onPress: () => console.log('Cancel Pressed'), style: 'cancel'},
|
|
* {text: 'OK', onPress: () => console.log('OK Pressed')},
|
|
* ]
|
|
* )
|
|
* ```
|
|
*/
|
|
export interface AlertStatic {
|
|
alert: (
|
|
title: string,
|
|
message?: string,
|
|
buttons?: AlertButton[],
|
|
options?: AlertOptions,
|
|
) => void;
|
|
prompt: (
|
|
title: string,
|
|
message?: string,
|
|
callbackOrButtons?: ((text: string) => void) | AlertButton[],
|
|
type?: AlertType,
|
|
defaultValue?: string,
|
|
keyboardType?: string,
|
|
options?: AlertOptions,
|
|
) => void;
|
|
}
|
|
|
|
export type AlertType =
|
|
| 'default'
|
|
| 'plain-text'
|
|
| 'secure-text'
|
|
| 'login-password';
|
|
|
|
export const Alert: AlertStatic;
|
|
export type Alert = AlertStatic;
|