mx.managers
接口public interface IBrowserManager extends IEventDispatcher

由 BrowserManager 的共享实例实现的接口。应用程序可在使用 BrowserManager.getInstance() 方法访问的共享实例上侦听事件、调用方法以及访问属性。

另请参见

mx.managers.BrowserManager
About deep linking
Using the BrowserManager
Setting the title of the HTML wrapper
Passing request data with URL fragments
Accessing information about the current URL


公共属性
 属性定义方
  base : String
[只读 (read-only)] 当前 URL 显示在浏览器地址栏中时,“#”之前的部分。
IBrowserManager
  fragment : String
[只读 (read-only)] 当前 URL 显示在浏览器地址栏中时,“#”之后的部分。
IBrowserManager
  title : String
[只读 (read-only)] 应用程序在浏览器历史记录中应显示的标题。
IBrowserManager
  url : String
[只读 (read-only)] 当前显示在浏览器地址栏中的 URL。
IBrowserManager
公共方法
 方法定义方
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
IEventDispatcher
 Inherited
将事件调度到事件流中。
IEventDispatcher
 Inherited
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
IEventDispatcher
  
init(value:String = null, title:String = null):void
初始化 BrowserManager。
IBrowserManager
  
初始化 BrowserManager。
IBrowserManager
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
IEventDispatcher
  
更改浏览器中“#”后面的 URL 片段。
IBrowserManager
  
更改浏览器标题栏中的文本。
IBrowserManager
 Inherited
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
IEventDispatcher
事件
 事件 摘要 定义方
  当浏览器更改 URL 时调度。IBrowserManager
  当通过用户与浏览器交互、调用 AIR 中的应用程序或以编程方式设置此属性来更改 URL 时调度。IBrowserManager
  当应用程序更改 URL 时调度。IBrowserManager
属性详细信息
base属性
base:String  [只读 (read-only)]

当前 URL 显示在浏览器地址栏中时,“#”之前的部分。



实现
    public function get base():String
fragment属性 
fragment:String  [只读 (read-only)]

当前 URL 显示在浏览器地址栏中时,“#”之后的部分。使用 setURLFragment() 方法可更改此值。



实现
    public function get fragment():String
title属性 
title:String  [只读 (read-only)]

应用程序在浏览器历史记录中应显示的标题。



实现
    public function get title():String
url属性 
url:String  [只读 (read-only)]

当前显示在浏览器地址栏中的 URL。



实现
    public function get url():String
方法详细信息
init()方法
public function init(value:String = null, title:String = null):void

初始化 BrowserManager。BrowserManager 将获取初始 URL。如果它包含片段,则调度 BROWSER_URL_CHANGE 事件。此方法可以将 Application.application.historyManagementEnabled 属性的值设为 false,这是因为 HistoryManager 通常与应用程序处理 URL 片段的方法冲突。

参数

value:String (default = null) — 当初始 URL 中没有片段时使用的片段。
 
title:String (default = null) — 当初始 URL 中没有片段时使用的标题。

initForHistoryManager()方法 
public function initForHistoryManager():void

初始化 BrowserManager。HistoryManager 调用此方法来准备 BrowserManager,供 HistoryManager 以后调用。无法从应用程序中使用 HistoryManager 调用 setFragment() 方法。因此,init() 方法通常将 Application.application.historyManagementEnabled 属性的值设为 false,以禁用 HistoryManager。

setFragment()方法 
public function setFragment(value:String):void

更改浏览器中“#”后面的 URL 片段。系统将尝试在浏览器历史记录中跟踪此 URL。

如果设置了标题,则浏览器中的旧标题将被新标题取代。

若要存储 URL,则需调用称为 setBrowserURL() 的 JavaScript 方法。应用程序的 HTML 包装中必须包含该方法,该方法必须实现一种机制来采用此值并向浏览器的历史记录架构和地址栏注册此值。

设置完成后,调度 APPLICATION_URL_CHANGE 事件。如果取消此事件,则不会调用 setBrowserURL() 方法。

参数

value:String — URL 中“#”之后要使用的新片段。

setTitle()方法 
public function setTitle(value:String):void

更改浏览器标题栏中的文本。此方法不会影响浏览器的历史记录。

参数

value:String — 浏览器的标题栏中要使用的新标题。

事件详细信息
browserURLChange 事件
事件对象类型: mx.events.BrowserChangeEvent
属性 BrowserChangeEvent.type = mx.events.BrowserChangeEvent.BROWSER_URL_CHANGE

当浏览器更改 URL 时调度。

BrowserChangeEvent.BROWSER_URL_CHANGE 常数可为 browserURLChange 事件定义事件对象的 type 属性值。

事件对象的属性有下列值:

属性
bubbles false
cancelable false
currentTarget 用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
lastURL BrowserManager 的 url 属性先前的值。
target 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。
url BrowserManager 的 url 属性的新值。
change 事件  
事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.CHANGE

当通过用户与浏览器交互、调用 AIR 中的应用程序或以编程方式设置此属性来更改 URL 时调度。

Event.CHANGE 常量定义 change 事件对象的 type 属性值。

此事件具有以下属性:

属性
bubbles true
cancelable false;没有要取消的默认行为。
currentTarget 当前正在使用某个事件侦听器处理 Event 对象的对象。
target 已修改其值的对象。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。
urlChange 事件  
事件对象类型: mx.events.BrowserChangeEvent
属性 BrowserChangeEvent.type = mx.events.BrowserChangeEvent.URL_CHANGE

当应用程序更改 URL 时调度。

BrowserChangeEvent.URL_CHANGE 常数可为 urlChange 事件定义事件对象的 type 属性值。

事件对象的属性有下列值:

属性
bubbles false
cancelable false
currentTarget 用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
lastURL BrowserManager 的 url 属性先前的值。
target 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。
url BrowserManager 的 url 属性的新值。