QQmlSA::ElementPass Class

詳細な説明

ElementPass は、2 つの分析パスのうち、より単純なものです。ファイル内のすべての要素を対象とします。shouldRun() メソッドを使用して、無関係な要素を除外することができ、run() メソッドが初期処理を行います。

ElementPass に適した一般的なタスクは次のとおりです。

• 要素のプロパティが、意味をなさない方法で組み合わされていないことの確認
• プロパティ値の検証（例：プロパティが特定の列挙型の値のみを取るなど）
• Elementの親要素に依存する挙動のチェック（例：親要素がLayout である場合にItem::width を使用しないなど）。

以下のスニペットに示すように、静的解析のパフォーマンスを維持するために、ElementPassのコンストラクタ内で必要な型解決を行い、それをローカルメンバーにキャッシュし、shouldRun() によるフィルタリングを実装することを推奨します。

using namespace QQmlSA;
class MyElementPass : public ElementPass
{
    Element myType;
    public:
        MyElementPass(QQmlSA::PassManager *manager)
        : myType(resolveType("MyModule", "MyType")) {}

        bool shouldRun(const Element &element) override
        {
            return element.inherits(myType);
        }
        void run(const Element &element) override
        {
            // actual pass logic
        }
}

ElementPassでは、要素のプロパティがどのように使用されているかについて把握できる範囲は限られています。その情報が必要な場合は、代わりにPropertyPass の使用を検討してください。