JsDoc Toolkitを使う!

@event

最終更新:

aias-jsdoctoolkit

- view
管理者のみ編集可

トップページ > ドックコメントの書き方 > タグリファレンス >

@event

@eventタグは、自分と同じ名前を持つイベントが発生したときに実行することができる関数について記述します。

構文

@event

  • @eventタグの構文は@functionタグと同一です。

シンプルに関数をイベントとしてタグ付けできます。

/**
 * @event
 * @param {Boolean} clockwise
 */

Cocktail.prototype.stir = function(clockwise) {
}

あるいはコード内の関数定義を参照せず、@nameタグを使うこともできます。

/**
 * @name Cocktail#shake
 * @event
 * @param {MyEventObject} e
 * @param {Boolean} [e.withIce=false]
 */

イベントの参照

上に示したような名前付きドックコメントのネームパスを参照する場合、同じ名前を持つメソッドとイベントを区別できない可能性がある点に注意してください。(メソッドとイベントの)どちらを参照しているのか明確にするには、イベントを指すネームパスのイベント名の前にプリフィックス"event:"を付けてください。

Cocktail#event:shake

ネームパスによってイベントを参照する必要がある場合、名前は下のようにevent:name形式で表記すべきです。

/**
 * @constructor
 * @borrows Cocktail#event:shake as this.event:shake
 */

function MilkShake() {
}

関連項目


目安箱バナー