CViewAction
| 包 | system.web.actions |
|---|---|
| 继承 | class CViewAction » CAction » CComponent |
| 实现 | IAction |
| 可用自 | 1.0 |
| 版本 | $Id$ |
By default, the view being displayed is specified via the
view GET parameter.
The name of the GET parameter can be customized via viewParam.
If the user doesn't provide the GET parameter, the default view specified by defaultView
will be displayed.
Users specify a view in the format of
path.to.view, which translates to the view name
BasePath/path/to/view where BasePath is given by basePath.
Note, the user specified view can only contain word characters, dots and dashes and the first letter must be a word letter.
公共属性
| 属性 | 类型 | 描述 | 被定义在 |
|---|---|---|---|
| basePath | string | the base path for the views. | CViewAction |
| controller | CController | the controller who owns this action. | CAction |
| defaultView | string | the name of the default view when viewParam GET parameter is not provided by user. | CViewAction |
| id | string | id of this action | CAction |
| layout | mixed | the name of the layout to be applied to the views. | CViewAction |
| renderAsText | boolean | whether the view should be rendered as PHP script or static text. | CViewAction |
| requestedView | string | Returns the name of the view requested by the user. | CViewAction |
| view | string | the name of the view to be rendered. | CViewAction |
| viewParam | string | the name of the GET parameter that contains the requested view name. | CViewAction |
公共方法
| 方法 | 描述 | 被定义在 |
|---|---|---|
| __call() | Calls the named method which is not a class method. | CComponent |
| __construct() | Constructor. | CAction |
| __get() | Returns a property value, an event handler list or a behavior based on its name. | CComponent |
| __isset() | Checks if a property value is null. | CComponent |
| __set() | Sets value of a component property. | CComponent |
| __unset() | Sets a component property to be null. | CComponent |
| asa() | Returns the named behavior object. | CComponent |
| attachBehavior() | Attaches a behavior to this component. | CComponent |
| attachBehaviors() | Attaches a list of behaviors to the component. | CComponent |
| attachEventHandler() | Attaches an event handler to an event. | CComponent |
| canGetProperty() | Determines whether a property can be read. | CComponent |
| canSetProperty() | Determines whether a property can be set. | CComponent |
| detachBehavior() | Detaches a behavior from the component. | CComponent |
| detachBehaviors() | Detaches all behaviors from the component. | CComponent |
| detachEventHandler() | Detaches an existing event handler. | CComponent |
| disableBehavior() | Disables an attached behavior. | CComponent |
| disableBehaviors() | Disables all behaviors attached to this component. | CComponent |
| enableBehavior() | Enables an attached behavior. | CComponent |
| enableBehaviors() | Enables all behaviors attached to this component. | CComponent |
| getController() | CAction | |
| getEventHandlers() | Returns the list of attached event handlers for an event. | CComponent |
| getId() | CAction | |
| getRequestedView() | Returns the name of the view requested by the user. | CViewAction |
| hasEvent() | Determines whether an event is defined. | CComponent |
| hasEventHandler() | Checks whether the named event has attached handlers. | CComponent |
| hasProperty() | Determines whether a property is defined. | CComponent |
| onAfterRender() | Raised right after the action invokes the render method. | CViewAction |
| onBeforeRender() | Raised right before the action invokes the render method. | CViewAction |
| raiseEvent() | Raises an event. | CComponent |
| run() | Runs the action. | CViewAction |
受保护的方法
| 方法 | 描述 | 被定义在 |
|---|---|---|
| resolveView() | Resolves the user-specified view into a valid view name. | CViewAction |
事件
| 事件 | 描述 | 被定义在 |
|---|---|---|
| onBeforeRender | Raised right before the action invokes the render method. | CViewAction |
| onAfterRender | Raised right after the action invokes the render method. | CViewAction |
属性详情
the base path for the views. Defaults to 'pages'.
The base path will be prefixed to any user-specified page view.
For example, if a user requests for tutorial.chap1, the corresponding view name will
be pages/tutorial/chap1, assuming the base path is pages.
The actual view file is determined by CController::getViewFile.
the name of the default view when viewParam GET parameter is not provided by user. Defaults to 'index'. This should be in the format of 'path.to.view', similar to that given in the GET parameter.
参见
the name of the layout to be applied to the views. This will be assigned to CController::layout before the view is rendered. Defaults to null, meaning the controller's layout will be used. If false, no layout will be applied.
whether the view should be rendered as PHP script or static text. Defaults to false.
Returns the name of the view requested by the user. If the user doesn't specify any view, the defaultView will be returned.
the name of the view to be rendered. This property will be set once the user requested view is resolved.
the name of the GET parameter that contains the requested view name. Defaults to 'view'.
方法详情
|
public string getRequestedView()
| ||
| {return} | string | the name of the view requested by the user. This is in the format of 'path.to.view'. |
Returns the name of the view requested by the user. If the user doesn't specify any view, the defaultView will be returned.
|
public void onAfterRender(CEvent $event)
| ||
| $event | CEvent | event parameter |
Raised right after the action invokes the render method.
|
public void onBeforeRender(CEvent $event)
| ||
| $event | CEvent | event parameter |
Raised right before the action invokes the render method. Event handlers can set the CEvent::handled property to be true to stop further view rendering.
|
protected string resolveView(string $viewPath)
| ||
| $viewPath | string | user-specified view in the format of 'path.to.view'. |
| {return} | string | fully resolved view in the format of 'path/to/view'. |
Resolves the user-specified view into a valid view name.
|
public void run()
|
Runs the action. This method displays the view requested by the user.