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 。