Packageurlkit.rules
Classpublic class UrlDelegateRule
InheritanceUrlDelegateRule Inheritance UrlBaseRule Inheritance flash.events.EventDispatcher

A UrlDelegateRule is used to dynamically splice a child rule into a parent rule tree, when the child rule's identity is computed. The parent tree contains a UrlDelegateRule whose 'rule' property is set to the child rule to be spliced in at that point.

This is useful when the children of a navigation container such as a ViewStack contain rule subtrees, and only the selected child's subtree should participate in the URL/state mapping.



Public Properties
 PropertyDefined by
  active : Boolean
[read-only] A delegate rule's active status is delegated to its child rule.
UrlDelegateRule
 InheritedcontainerUrl : String
Set the URL for this rule based on some or all of a URL passed in from the containing browser.
UrlBaseRule
 InheriteddoesMatchUrl : Boolean
UrlBaseRule
 Inheritedenabled : Boolean
Get the value of the enabled flag, gating whether this rule is ever capable of reflecting or contributing state in the application .
UrlBaseRule
 InheritedmatchUrlBeginning : Boolean
UrlBaseRule
 Inheritedparent : IUrlRule
Set the parent rule of this rule.
UrlBaseRule
 Inheritedready : Boolean
Get a flag indicating whether this rule is sufficiently initialized to propagate its browser-determined state to the application.
UrlBaseRule
  rule : IUrlRule
UrlDelegateRule
  strictMatching : Boolean = false
If set, this flag enables strict matching against the child rule.
UrlDelegateRule
 Inheritedtitle : String
Get the title component string associated with this rule, to be used in determining the overall application window title.
UrlBaseRule
 Inheritedurl : String
Get the URL component associated with this rule, representing its encoding of the current application state.
UrlBaseRule
 InheritedurlFormat : String
A string that determines the URL generated by this rule.
UrlBaseRule
 InheritedurlPattern : String
A regular expression that will restrict this rule to only be active for a URL that matches it.
UrlBaseRule
 InheritedurlPatternRegEx : RegExp
UrlBaseRule
Protected Properties
 PropertyDefined by
 Inherited_document : UIComponent
Document as passed in via IMXMLObject.initialize()
UrlBaseRule
 Inherited_title : String
Storage property for title.
UrlBaseRule
 Inheritedvalid : Boolean
Get a flag indicating
UrlBaseRule
Public Methods
 MethodDefined by
  
UrlDelegateRule
 Inherited
defaultPatternFromFormat(f:String):String
[static]
UrlBaseRule
 Inherited
exec(url:String):Array
UrlBaseRule
 Inherited
initialized(document:Object, id:String):void
Notify this rule that it has been completely initialized by its owning document.
UrlBaseRule
 Inherited
Invalidate the application state of this rule, which ultimately requests the browser to update its location bar from the top-level rule's URL.
UrlBaseRule
  
matchUrlPrefix(url:String):String
A delegate rule's URL prefix matching is delegated to its child rule.
UrlDelegateRule
Protected Methods
 MethodDefined by
 Inherited
applyUrlFormat(stringValue:String):String
UrlBaseRule
  
checkReadiness(e:Event):void
Check this rule to determine whether it's ready.
UrlDelegateRule
  
Commit a new delegate rule's state by propagating its URL to the child.
UrlDelegateRule
  
Compute a delegate rule's state by copying its child rule's state.
UrlDelegateRule
 Inherited
Validate this rule such that its URL and title correspond to the application state, as determined by whatever URL/state mapping this rule defines.
UrlBaseRule
Events
 EventSummaryDefined by
    UrlDelegateRule
 Inherited This event is dispatched when the URL component for this value changes.UrlBaseRule
    UrlDelegateRule
Public Constants
 ConstantDefined by
 InheritedSTATE_CHANGE : String = "stateChange"
[static]
UrlBaseRule
Property detail
activeproperty
active:Boolean  [read-only]

A delegate rule's active status is delegated to its child rule.

Implementation
    public function get active():Boolean

See also

ruleproperty 
rule:IUrlRule  [read-write]

This property can be used as the source for data binding.

Implementation
    public function get rule():IUrlRule
    public function set rule(value:IUrlRule):void
strictMatchingproperty 
public var strictMatching:Boolean = false

If set, this flag enables strict matching against the child rule. Normally this is disabled, because a delegate rule's child is often changed dynamically by a sibling rule.

This property can be used as the source for data binding.

Constructor detail
UrlDelegateRule()constructor
public function UrlDelegateRule()
Method detail
checkReadiness()method
protected override function checkReadiness(e:Event):void

Check this rule to determine whether it's ready. Readiness of a delegate rule requires that it have a child rule to which it can delegate.

Parameters
e:Event
commitBrowserChange()method 
protected override function commitBrowserChange():void

Commit a new delegate rule's state by propagating its URL to the child.

computeApplicationState()method 
protected override function computeApplicationState():void

Compute a delegate rule's state by copying its child rule's state.

matchUrlPrefix()method 
public override function matchUrlPrefix(url:String):String

A delegate rule's URL prefix matching is delegated to its child rule.

Parameters
url:String

Returns
String

See also

Event detail
changeevent 
Event object type: flash.events.Event

ruleChangedevent  
Event object type: flash.events.Event