org.cef.handler

接口 CefJSDialogHandler

所有已知实现类:

CefClient, CefJSDialogHandlerAdapter

public interface CefJSDialogHandler

Implement this interface to handle events related to JavaScript dialogs. The methods of this class will be called on the UI thread. (实现此接口以处理与JavaScript对话框相关的事件。此类的方法将在UI线程上调用。)

嵌套类概要

嵌套类

限定符和类型	接口和说明
static class	CefJSDialogHandler.JSDialogType Supported JavaScript dialog types. (支持的JavaScript对话框类型。)

方法概要

限定符和类型	方法和说明
boolean	onBeforeUnloadDialog(CefBrowser browser, java.lang.String message_text, boolean is_reload, CefJSDialogCallback callback) Called to run a dialog asking the user if they want to leave a page. (调用此命令可运行一个对话框，询问用户是否要离开页面。)
void	onDialogClosed(CefBrowser browser) Called when the default implementation dialog is closed. (关闭默认实现对话框时调用。)
boolean	onJSDialog(CefBrowser browser, java.lang.String origin_url, CefJSDialogHandler.JSDialogType dialog_type, java.lang.String message_text, java.lang.String default_prompt_text, CefJSDialogCallback callback, BoolRef suppress_message) Called to run a JavaScript dialog. (调用以运行JavaScript对话框。)
void	onResetDialogState(CefBrowser browser) Called to cancel any pending dialogs and reset any saved dialog state. (调用以取消所有未决的对话框并重置所有保存的对话框状态。)

方法详细资料

onBeforeUnloadDialog

boolean onBeforeUnloadDialog(CefBrowser browser,
                             java.lang.String message_text,
                             boolean is_reload,
                             CefJSDialogCallback callback)

Called to run a dialog asking the user if they want to leave a page. Return false to use the default dialog implementation. Return true if the application will use a custom dialog or if the callback has been executed immediately. Custom dialogs may be either modal or modeless. If a custom dialog is used the application must execute callback once the custom dialog is dismissed. (调用此命令可运行一个对话框，询问用户是否要离开页面。返回false以使用默认对话框实现。如果应用程序将使用自定义对话框或立即执行了回调，则返回true。自定义对话框可以是模式对话框，也可以是非模式对话框。如果使用了自定义对话框，则关闭自定义对话框后，应用程序必须执行回调。)

参数:

browser - The corresponding browser. (-相应的浏览器。)

message_text - The text to be displayed. (-要显示的文本。)

is_reload - true if the page is reloaded. (-如果重新加载页面，则为true。)

callback - execute callback once the custom dialog is dismissed. (-一旦关闭自定义对话框，请执行回调。)

返回:

false to use the default dialog implementation. Return true if the application will use a custom dialog. (如果为false，则使用默认对话框实现。如果应用程序将使用自定义对话框，则返回true。)

onDialogClosed

void onDialogClosed(CefBrowser browser)

Called when the default implementation dialog is closed. (关闭默认实现对话框时调用。)

onJSDialog

boolean onJSDialog(CefBrowser browser,
                   java.lang.String origin_url,
                   CefJSDialogHandler.JSDialogType dialog_type,
                   java.lang.String message_text,
                   java.lang.String default_prompt_text,
                   CefJSDialogCallback callback,
                   BoolRef suppress_message)

Called to run a JavaScript dialog. Set suppress_message to true and return false to suppress the message (suppressing messages is preferable to immediately executing the callback as this is used to detect presumably malicious behavior like spamming alert messages in onbeforeunload). Set suppress_message to false and return false to use the default implementation (the default implementation will show one modal dialog at a time and suppress any additional dialog requests until the displayed dialog is dismissed). Return true if the application will use a custom dialog or if the callback has been executed immediately. Custom dialogs may be either modal or modeless. If a custom dialog is used the application must execute callback once the custom dialog is dismissed. (调用以运行JavaScript对话框。将prevent_message设置为true并返回false以抑制消息（抑制消息比立即执行回调更好，因为这用于检测可能的恶意行为，例如在onbeforeunload中发送警报消息）。将prevent_message设置为false并返回false以使用默认实现（默认实现将一次显示一个模式对话框，并抑制所有其他对话框请求，直到关闭显示的对话框）。如果应用程序将使用自定义对话框或立即执行了回调，则返回true。自定义对话框可以是模式对话框，也可以是非模式对话框。如果使用了自定义对话框，则关闭自定义对话框后，应用程序必须执行回调。)

参数:

browser - The corresponding browser. (-相应的浏览器。)

origin_url - The originating url. (-原始网址。)

dialog_type - the dialog type. (-对话框类型。)

message_text - the text to be displayed. (-要显示的文本。)

default_prompt_text - value will be specified for prompt dialogs only. (-将仅为提示对话框指定值。)

callback - execute callback once the custom dialog is dismissed. (-一旦关闭自定义对话框，请执行回调。)

suppress_message - set to true to suppress displaying the message. (-设置为true以禁止显示消息。)

返回:

false to use the default dialog implementation. Return true if the application will use a custom dialog. (如果为false，则使用默认对话框实现。如果应用程序将使用自定义对话框，则返回true。)

onResetDialogState

void onResetDialogState(CefBrowser browser)

Called to cancel any pending dialogs and reset any saved dialog state. Will be called due to events like page navigation irregardless of whether any dialogs are currently pending. (调用以取消所有未决的对话框并重置所有保存的对话框状态。由于诸如页面导航之类的事件而将被调用，而不管当前是否有任何对话框挂起。)