@class
YUIDocs のようなドキュメンテーション ツールを使用すると、コメント ブロックでタグを使用して、クラス (オブジェクト クラス) を識別および説明できます。識別された各クラスには、次のように定義された@static
orタグが必要です。@constructor
@constructor
- クラスがインスタンス化可能 (new キーワードで作成) であることを示します。@static
- クラスを new でインスタンス化してはならないことを示します。クラスのすべてのメソッドを静的に呼び出すことができます。
Ember では、 を使用してサブクラスを作成することがよくありますextend()
。私の知る限り、これはクラスの新しいインスタンスを作成しません。ただし、これらの定義の多く (ルートのコントローラーなど) は、定義に使用してもシングルトンですextend()
。
したがって、私の質問は次のとおりです。ember アプリでクラスを文書化する一般的な状況では、@constructor
vsを使用し@static
ますか? そのような例は次のとおりです。
- 初期化子
- ルーター
- アダプター
- シリアライザー
- 変換
- ルート
- 店舗
- モデル
- コントローラー
- ビュー
- コンポーネント
- ミックスイン
Handlebars ヘルパーは実際にはクラスではなくメソッドであると信じているため、ここには含めませんが、間違っている場合はこの質問を修正します。