action
- action
- .regist(pathPattern, service)
- .unregist(pathPattern)
- .dispatch(current, prev) ⇒
Promise - .isIndexPage() ⇒
boolean - .exist(urlPattern) ⇒
boolean - .config(options) ⇒
Object - .redirect(url, query, options, data)
- .back()
- .reset(url, query, options, data)
- .start(options)
- .stop()
- .destroy()
- .update(url, query, options, data) ⇒
Object - .partialUpdate([url], [options=]) ⇒
Promise
action.regist(pathPattern, service)
Register a service instance to action
Kind: static method of action
| Param | Type | Description |
|---|---|---|
| pathPattern | string | RestFul | RegExp |
The path of the service |
| service | Object |
The service object to be registered |
Example
action.regist('/person', new Service());
action.regist('/person/:id', new Service());
action.regist(/^person\/\d+/, new Service());
action.unregist(pathPattern)
Un-register a service by path
Kind: static method of action
| Param | Type | Description |
|---|---|---|
| pathPattern | string | RestFul | RegExp |
The path of the service |
action.dispatch(current, prev) ⇒ Promise
Switch from the previous service to the current one.
Call prev.detach, prev.destroy,
current.create, current.attach in serial.
Typically called by the Router,
you may not want to call dispatch manually.
If any of these callbacks returns a Thenable, it'll be await.
If the promise is rejected, the latter callbacks will NOT be called.
Returns a promise that resolves if all callbacks executed without throw (or reject), rejects if any of the callbacks throwed or rejected.
Note: If current and prev is the same service,
the prev.destroy will NOT be called.
Kind: static method of action
| Param | Type | Description |
|---|---|---|
| current | Object |
The current scope |
| prev | Object |
The previous scope |
action.isIndexPage() ⇒ boolean
Check if currently in initial page
Kind: static method of action
Returns: boolean - whether current page is the index page
action.exist(urlPattern) ⇒ boolean
Check if the specified service has been registered
Kind: static method of action
Returns: boolean - Returns true if it has been registered, else false.
| Param | Type | Description |
|---|---|---|
| urlPattern | string |
The path of the service |
action.config(options) ⇒ Object
config the action, called by action.start
Kind: static method of action
Returns: Object - result config object
| Param | Type | Description |
|---|---|---|
| options | Object |
key/value pairs to config the action |
action.redirect(url, query, options, data)
Redirect to another page, and change to next state
Kind: static method of action
| Param | Type | Description |
|---|---|---|
| url | string |
The URL to redirect |
| query | string |
The query string to redirect |
| options | Object |
The router options to redirect |
| options.title | string |
Optional, 页面的title |
| options.force | boolean |
Optional, 是否强制跳转 |
| options.silent | boolean |
Optional, 是否静默跳转(不改变URL) |
| data | Object |
extended data being passed to current.options |
action.back()
Back to last state
Kind: static method of action
action.reset(url, query, options, data)
Reset/replace current state
Kind: static method of action
| Param | Type | Description |
|---|---|---|
| url | string |
The URL to reset |
| query | string |
The query string to reset |
| options | Object |
The router options |
| options.title | string |
Optional, 页面的title |
| options.force | boolean |
Optional, 是否强制跳转 |
| options.silent | boolean |
Optional, 是否静默跳转(不改变URL) |
| data | Object |
extended data being passed to current.options |
action.start(options)
Action init, call this to start the action
Kind: static method of action
| Param | Type | Description |
|---|---|---|
| options | Object |
key/value pairs to config the action, calling action.config() internally |
action.stop()
Stop Ralltiir redirects
Kind: static method of action
action.destroy()
Destroy the action, eliminate side effects: DOM event listeners, cache namespaces, external states
Kind: static method of action
action.update(url, query, options, data) ⇒ Object
Update page, reset or replace current state accordingly
Kind: static method of action
Returns: Object - the action object
| Param | Type | Description |
|---|---|---|
| url | string |
The URL to update |
| query | string |
The query string to update |
| options | Object |
The router options to update |
| data | Object |
The extended data to update, typically contains container, page, and view |
action.partialUpdate([url], [options=]) ⇒ Promise
Update partial content
Kind: static method of action
Returns: Promise - A promise resolves when update finished successfully, rejected otherwise
| Param | Type | Default | Description |
|---|---|---|---|
| [url] | string |
null |
The url to update to, do not change url if null |
| [options=] | string |
Update options | |
| [options.from=] | string |
The container element or the selector of the container element in the DOM of the retrieved HTML | |
| [options.to=] | string |
The container element or the selector of the container element in the current DOM | |
| [options.fromUrl] | string |
"url" |
The url of the HTML to be retrieved |
| [options.replace] | boolean |
false |
Whether or not to replace the contents of container element |