Loading core/java/android/webkit/WebChromeClient.java +44 −12 Original line number Diff line number Diff line Loading @@ -219,17 +219,34 @@ public class WebChromeClient { } /** * Tell the client to display a confirm dialog to the user. If the client * returns {@code true}, WebView will assume that the client will handle the * confirm dialog and call the appropriate JsResult method. If the * client returns false, a default value of {@code false} will be returned to * javascript. The default behavior is to return {@code false}. * Notify the host application that the web page wants to display a * JavaScript {@code confirm()} dialog. * <p>The default behavior if this method returns {@code false} or is not * overridden is to show a dialog containing the message and suspend * JavaScript execution until the dialog is dismissed. The default dialog * will return {@code true} to the JavaScript {@code confirm()} code when * the user presses the 'confirm' button, and will return {@code false} to * the JavaScript code when the user presses the 'cancel' button or * dismisses the dialog. * <p>To show a custom dialog, the app should return {@code true} from this * method, in which case the default dialog will not be shown and JavaScript * execution will be suspended. The app should call * {@code JsResult.confirm()} or {@code JsResult.cancel()} when the custom * dialog is dismissed. * <p>To suppress the dialog and allow JavaScript execution to continue, * call {@code JsResult.confirm()} or {@code JsResult.cancel()} immediately * and then return {@code true}. * <p>Note that if the {@link WebChromeClient} is {@code null}, the default * dialog will be suppressed and the default value of {@code false} will be * returned to the JavaScript code immediately. * * @param view The WebView that initiated the callback. * @param url The url of the page requesting the dialog. * @param message Message to be displayed in the window. * @param result A JsResult used to send the user's response to * javascript. * @return boolean Whether the client will handle the confirm dialog. * @return boolean {@code true} if the request is handled or ignored. * {@code false} if WebView needs to show the default dialog. */ public boolean onJsConfirm(WebView view, String url, String message, JsResult result) { Loading @@ -237,18 +254,33 @@ public class WebChromeClient { } /** * Tell the client to display a prompt dialog to the user. If the client * returns {@code true}, WebView will assume that the client will handle the * prompt dialog and call the appropriate JsPromptResult method. If the * client returns false, a default value of {@code false} will be returned to to * javascript. The default behavior is to return {@code false}. * Notify the host application that the web page wants to display a * JavaScript {@code prompt()} dialog. * <p>The default behavior if this method returns {@code false} or is not * overridden is to show a dialog containing the message and suspend * JavaScript execution until the dialog is dismissed. Once the dialog is * dismissed, JavaScript {@code prompt()} will return the string that the * user typed in, or null if the user presses the 'cancel' button. * <p>To show a custom dialog, the app should return {@code true} from this * method, in which case the default dialog will not be shown and JavaScript * execution will be suspended. The app should call * {@code JsPromptResult.confirm(result)} when the custom dialog is * dismissed. * <p>To suppress the dialog and allow JavaScript execution to continue, * call {@code JsPromptResult.confirm(result)} immediately and then * return {@code true}. * <p>Note that if the {@link WebChromeClient} is {@code null}, the default * dialog will be suppressed and {@code null} will be returned to the * JavaScript code immediately. * * @param view The WebView that initiated the callback. * @param url The url of the page requesting the dialog. * @param message Message to be displayed in the window. * @param defaultValue The default value displayed in the prompt dialog. * @param result A JsPromptResult used to send the user's reponse to * javascript. * @return boolean Whether the client will handle the prompt dialog. * @return boolean {@code true} if the request is handled or ignored. * {@code false} if WebView needs to show the default dialog. */ public boolean onJsPrompt(WebView view, String url, String message, String defaultValue, JsPromptResult result) { Loading Loading
core/java/android/webkit/WebChromeClient.java +44 −12 Original line number Diff line number Diff line Loading @@ -219,17 +219,34 @@ public class WebChromeClient { } /** * Tell the client to display a confirm dialog to the user. If the client * returns {@code true}, WebView will assume that the client will handle the * confirm dialog and call the appropriate JsResult method. If the * client returns false, a default value of {@code false} will be returned to * javascript. The default behavior is to return {@code false}. * Notify the host application that the web page wants to display a * JavaScript {@code confirm()} dialog. * <p>The default behavior if this method returns {@code false} or is not * overridden is to show a dialog containing the message and suspend * JavaScript execution until the dialog is dismissed. The default dialog * will return {@code true} to the JavaScript {@code confirm()} code when * the user presses the 'confirm' button, and will return {@code false} to * the JavaScript code when the user presses the 'cancel' button or * dismisses the dialog. * <p>To show a custom dialog, the app should return {@code true} from this * method, in which case the default dialog will not be shown and JavaScript * execution will be suspended. The app should call * {@code JsResult.confirm()} or {@code JsResult.cancel()} when the custom * dialog is dismissed. * <p>To suppress the dialog and allow JavaScript execution to continue, * call {@code JsResult.confirm()} or {@code JsResult.cancel()} immediately * and then return {@code true}. * <p>Note that if the {@link WebChromeClient} is {@code null}, the default * dialog will be suppressed and the default value of {@code false} will be * returned to the JavaScript code immediately. * * @param view The WebView that initiated the callback. * @param url The url of the page requesting the dialog. * @param message Message to be displayed in the window. * @param result A JsResult used to send the user's response to * javascript. * @return boolean Whether the client will handle the confirm dialog. * @return boolean {@code true} if the request is handled or ignored. * {@code false} if WebView needs to show the default dialog. */ public boolean onJsConfirm(WebView view, String url, String message, JsResult result) { Loading @@ -237,18 +254,33 @@ public class WebChromeClient { } /** * Tell the client to display a prompt dialog to the user. If the client * returns {@code true}, WebView will assume that the client will handle the * prompt dialog and call the appropriate JsPromptResult method. If the * client returns false, a default value of {@code false} will be returned to to * javascript. The default behavior is to return {@code false}. * Notify the host application that the web page wants to display a * JavaScript {@code prompt()} dialog. * <p>The default behavior if this method returns {@code false} or is not * overridden is to show a dialog containing the message and suspend * JavaScript execution until the dialog is dismissed. Once the dialog is * dismissed, JavaScript {@code prompt()} will return the string that the * user typed in, or null if the user presses the 'cancel' button. * <p>To show a custom dialog, the app should return {@code true} from this * method, in which case the default dialog will not be shown and JavaScript * execution will be suspended. The app should call * {@code JsPromptResult.confirm(result)} when the custom dialog is * dismissed. * <p>To suppress the dialog and allow JavaScript execution to continue, * call {@code JsPromptResult.confirm(result)} immediately and then * return {@code true}. * <p>Note that if the {@link WebChromeClient} is {@code null}, the default * dialog will be suppressed and {@code null} will be returned to the * JavaScript code immediately. * * @param view The WebView that initiated the callback. * @param url The url of the page requesting the dialog. * @param message Message to be displayed in the window. * @param defaultValue The default value displayed in the prompt dialog. * @param result A JsPromptResult used to send the user's reponse to * javascript. * @return boolean Whether the client will handle the prompt dialog. * @return boolean {@code true} if the request is handled or ignored. * {@code false} if WebView needs to show the default dialog. */ public boolean onJsPrompt(WebView view, String url, String message, String defaultValue, JsPromptResult result) { Loading
