Displays a JavaScript text input panel.
SDKs
- iOS 8.0+
- macOS 10.10+
- Mac Catalyst 13.0+
Framework
- Web
Kit
Declaration
- (void)webView:(WKWeb View *)webView runJavaScriptTextInputPanelWithPrompt:(NSString *)prompt defaultText:(NSString *)defaultText initiatedByFrame:(WKFrame Info *)frame completionHandler:(void (^)(NSString *result))completionHandler;
Parameters
webView
The web view invoking the delegate method.
prompt
The message to be displayed.
defaultText
The initial text to display in the text entry field.
frame
Information about the frame whose JavaScript process initiated this call.
completionHandler
The completion handler to call after the text input panel has been dismissed. Pass the entered text if the user chose OK, otherwise
nil
.
Discussion
For user security, implementations of this method should call attention to the fact that a specific website controls the content in this panel. A simple formula for identifying the controlling website is frame
. The panel should have two buttons (typically OK and Cancel) and a field in which to enter text.