QQmlSA::ElementPass Class

상세 설명

ElementPass는 두 가지 분석 단계 중 더 간단한 단계입니다. 이 단계에서는 파일 내의 모든 요소를 고려합니다. 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 를 사용하는 것을 고려하십시오.