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对话框。将suppress_message设置为true并返回false以抑制消息（抑制消息比立即执行回调更可取，因为这用于检测可能的恶意行为，如onbeforeunload中的垃圾邮件警报消息）。将suppress_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.

调用取消任何挂起的对话框并重置任何已保存的对话框状态。将由于页面导航等事件而被调用，无论是否有任何对话框当前待处理。