php/yii2
1
0
Fork 0
mirror of https://github.com/yiisoft/yii2.git synced 2025-11-11 19:20:01 +08:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #35 from yangqiphp/doc

Browse Source 
Update concept-events.md
This commit is contained in:
cuiliang
2017-09-26 01:06:27 -05:00
committed by GitHub
parent 3b15f3d9b7 5bb4f30b70
commit a4c84a278d
1 changed files with 15 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

30
docs/guide-zh-CN/concept-events.md
View File

@@ -59,8 +59,8 @@ $foo->on(Foo::EVENT_HELLO, function ($event) {
}); });
``` ```
You may also attach event handlers through [configurations](concept-configurations.md). For more details, please 你也可以通过 [配置](concept-configurations.md) 附加事件处理器。 请
refer to the [Configurations](concept-configurations.md#configuration-format) section. 参考 [配置的格式](concept-configurations.md#configuration-format) 小节了解更多.
附加事件处理器时可以提供额外数据作为 [[yii\base\Component::on()]] 方法的第三个参数。 附加事件处理器时可以提供额外数据作为 [[yii\base\Component::on()]] 方法的第三个参数。
@@ -252,13 +252,13 @@ Event::off(Foo::className(), Foo::EVENT_HELLO);
``` ```
Events using interfaces <span id="interface-level-event-handlers"></span> 使用接口事件 <span id="interface-level-event-handlers"></span>
------------- -------------
There is even more abstract way to deal with events. You can create a separated interface for the special event and 有更多的抽象方式来处理事件。你可以为特殊的事件创建一个独立的接口，
implement it in classes, where you need it. 然后在你需要的类中实现它。
For example, we can create the following interface: 例如，我们可以先创建下面这个接口:
```php ```php
namespace app\interfaces; namespace app\interfaces;
@@ -269,7 +269,7 @@ interface DanceEventInterface
} }
``` ```
And two classes, that implement it: 然后在两个类中实现:
```php ```php
class Dog extends Component implements DanceEventInterface class Dog extends Component implements DanceEventInterface
@@ -291,8 +291,8 @@ class Developer extends Component implements DanceEventInterface
} }
``` ```
To handle the `EVENT_DANCE`, triggered by any of these classes, call [[yii\base\Event::on()|Event::on()]] and 要处理由这些类触发的 `EVENT_DANCE` ，调用 [[yii\base\Event::on()|Event::on()]]
pass the interface class name as the first argument: 并将接口类名作为第一个参数:
```php ```php
Event::on('app\interfaces\DanceEventInterface', DanceEventInterface::EVENT_DANCE, function ($event) { Event::on('app\interfaces\DanceEventInterface', DanceEventInterface::EVENT_DANCE, function ($event) {
@@ -300,7 +300,7 @@ Event::on('app\interfaces\DanceEventInterface', DanceEventInterface::EVENT_DANCE
}); });
``` ```
You can trigger the event of those classes: 你可以在这些类中触发这个事件：
```php ```php
// trigger event for Dog class // trigger event for Dog class
@@ -310,20 +310,20 @@ Event::trigger(Dog::className(), DanceEventInterface::EVENT_DANCE);
Event::trigger(Developer::className(), DanceEventInterface::EVENT_DANCE); Event::trigger(Developer::className(), DanceEventInterface::EVENT_DANCE);
``` ```
But please notice, that you can not trigger all the classes, that implement the interface: 但是请注意, 你不能让所有实现这个接口的类都触发事件：
```php ```php
// DOES NOT WORK. Classes that implement this interface will NOT be triggered. // 不会生效。实现此接口的类不会触发事件。
Event::trigger('app\interfaces\DanceEventInterface', DanceEventInterface::EVENT_DANCE); Event::trigger('app\interfaces\DanceEventInterface', DanceEventInterface::EVENT_DANCE);
``` ```
To detach event handler, call [[yii\base\Event::off()|Event::off()]]. For example: 调用 [[yii\base\Event::off()|Event::off()]] 移除事件处理器。例如：
```php ```php
// detaches $handler // 移除 $handler
Event::off('app\interfaces\DanceEventInterface', DanceEventInterface::EVENT_DANCE, $handler); Event::off('app\interfaces\DanceEventInterface', DanceEventInterface::EVENT_DANCE, $handler);
// detaches all handlers of DanceEventInterface::EVENT_DANCE // 移除所有 `DanceEventInterface::EVENT_DANCE` 的处理器
Event::off('app\interfaces\DanceEventInterface', DanceEventInterface::EVENT_DANCE); Event::off('app\interfaces\DanceEventInterface', DanceEventInterface::EVENT_DANCE);
``` ```