包 | mx.managers |
接口 | public interface IBrowserManager extends IEventDispatcher |
BrowserManager.getInstance()
方法访问的共享实例上侦听事件、调用方法以及访问属性。
另请参见
属性 | 定义方 | ||
---|---|---|---|
base : String [只读 (read-only)] 当前 URL 显示在浏览器地址栏中时,“#”之前的部分。 | IBrowserManager | ||
fragment : String [只读 (read-only)] 当前 URL 显示在浏览器地址栏中时,“#”之后的部分。 | IBrowserManager | ||
title : String [只读 (read-only)] 应用程序在浏览器历史记录中应显示的标题。 | IBrowserManager | ||
url : String [只读 (read-only)] 当前显示在浏览器地址栏中的 URL。 | IBrowserManager |
方法 | 定义方 | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。 | IEventDispatcher | ||
将事件调度到事件流中。 | IEventDispatcher | ||
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | IEventDispatcher | ||
初始化 BrowserManager。 | IBrowserManager | ||
初始化 BrowserManager。 | IBrowserManager | ||
从 EventDispatcher 对象中删除侦听器。 | IEventDispatcher | ||
更改浏览器中“#”后面的 URL 片段。 | IBrowserManager | ||
更改浏览器标题栏中的文本。 | IBrowserManager | ||
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。 | IEventDispatcher |
事件 | 摘要 | 定义方 | ||
---|---|---|---|---|
当浏览器更改 URL 时调度。 | IBrowserManager | |||
当通过用户与浏览器交互、调用 AIR 中的应用程序或以编程方式设置此属性来更改 URL 时调度。 | IBrowserManager | |||
当应用程序更改 URL 时调度。 | IBrowserManager |
base | 属性 |
fragment | 属性 |
fragment:String
[只读 (read-only)]
当前 URL 显示在浏览器地址栏中时,“#”之后的部分。使用 setURLFragment()
方法可更改此值。
public function get fragment():String
title | 属性 |
url | 属性 |
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
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
flash.events.Event.CHANGE
当通过用户与浏览器交互、调用 AIR 中的应用程序或以编程方式设置此属性来更改 URL 时调度。
Event.CHANGE
常量定义 change
事件对象的 type
属性值。
此事件具有以下属性:
属性 | 值 |
---|---|
bubbles
|
true
|
cancelable
|
false ;没有要取消的默认行为。
|
currentTarget
| 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target
|
已修改其值的对象。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。
|
urlChange | 事件 |
mx.events.BrowserChangeEvent
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 属性的新值。
|