QQmlSA::ElementPass Class

Descripción detallada

ElementPass es el más sencillo de los dos pases de análisis. Tiene en cuenta todos los elementos de un fichero. El método shouldRun() puede utilizarse para filtrar elementos irrelevantes, y el método run() realiza el trabajo inicial.

Las tareas comunes adecuadas para un ElementPass son

• comprobar que las propiedades de un Elemento no están combinadas de forma absurda
• validar los valores de las propiedades (por ejemplo, que una propiedad sólo tome ciertos valores enum)
• comprobar el comportamiento dependiente del elemento padre (por ejemplo, no utilizar Item::width cuando el elemento padre es Layout).

Como se muestra en el siguiente fragmento, se recomienda realizar la resolución de tipos necesaria en el constructor de ElementPass y almacenarla en caché en los miembros locales, e implementar algún filtrado a través de shouldRun() para mantener el rendimiento del análisis estático.

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
        }
}

Los ElementPass tienen una visión limitada de cómo se utilizan las propiedades de un elemento. Si necesitas esa información, considera utilizar PropertyPass en su lugar.