Commit c259f4e0 by Larry Ullman

Edited rest of doc

parent 04fb68fb
...@@ -82,7 +82,9 @@ When attaching event handlers in this way, the handler must be an anonymous func ...@@ -82,7 +82,9 @@ When attaching event handlers in this way, the handler must be an anonymous func
Triggering events Triggering events
----------------- -----------------
Any component can trigger an event using the `trigger` method: Most events will be triggered through the normal workflow. For example, the "beforeSave" event occurs before an Active Record model is saved.
But you can also manually trigger an event using the `trigger` method, invoked on the component with the attached event handler:
```php ```php
$this->trigger('myEvent'); $this->trigger('myEvent');
...@@ -94,8 +96,8 @@ $event->userName = 'Alexander'; ...@@ -94,8 +96,8 @@ $event->userName = 'Alexander';
$this->trigger('createUserEvent', $event); $this->trigger('createUserEvent', $event);
``` ```
Event name should be unique within the class it is defined at. Event names are *case-sensitive*. It is a good practice The event name needs to be unique within the class it is defined. Event names are *case-sensitive*, bu it is a good practice
to define event names using class constants: to define event names as class constants:
```php ```php
class Mailer extends Component class Mailer extends Component
...@@ -113,37 +115,42 @@ class Mailer extends Component ...@@ -113,37 +115,42 @@ class Mailer extends Component
Removing Event Handlers Removing Event Handlers
----------------------- -----------------------
The correspondoing `off` method removes an event handler: The corresponding `off` method removes an event handler:
```php ```php
$component->off($eventName); $component->off($eventName);
``` ```
Yii supports the ability to associate multiple handlers with the same event. When using `off` as in the above, Yii supports the ability to associate multiple handlers with the same event. When using `off` as in the above,
every handler is removed. To remove only a specific handler, provide that as the second argument to `off`: every handler will be removed. To remove only a specific handler, provide that as the second argument to `off`:
```php ```php
$component->off($eventName, $handler); $component->off($eventName, $handler);
``` ```
The `$handler` should be presented in the `off` method in the same way as was presented in `on` in order to remove it. The `$handler` should be presented in the `off` method in the same way as was presented in the `on` call in order to remove it.
> Tip: You probably don't want to use anonymous functions for event handlers that you expect to later remove.
Global Events Global Events
------------- -------------
You can use "global" events instead of per-component ones. To trigger a global event use an application instance instead You can use "global" events instead of per-component ones. A global event can take place on any component type.
of specific component:
In order to attach a handler to a global event, call the `on` method on the application instance:
```php ```php
Yii::$app->trigger($eventName); Yii::$app->on($eventName, $handler);
``` ```
In order to attach a handler to it use the following: Global events are triggered on the application instance instead
of a specific component:
```php ```php
Yii::$app->on($eventName, $handler); Yii::$app->trigger($eventName);
``` ```
Class Events Class Events
------------ ------------
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment