ElementPass Class

상세 설명

ElementPass는 두 가지 분석 패스 중 더 간단한 패스입니다. 파일에 있는 모든 요소를 고려합니다. shouldRun () 메서드는 관련 없는 요소를 필터링하는 데 사용할 수 있으며, run() 메서드는 초기 작업을 수행합니다.

ElementPass에 적합한 일반적인 작업은 다음과 같습니다.

• 엘리먼트의 프로퍼티가 무의미한 방식으로 결합되지 않았는지 확인
• 프로퍼티 값의 유효성 검사(예: 프로퍼티가 특정 열거형 값만 취하는 경우)
• 엘리먼트의 부모에 따라 달라지는 동작 확인(예: 부모 엘리먼트가 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
        }
}

엘리먼트 패스는 엘리먼트의 프로퍼티가 어떻게 사용되는지에 대한 인사이트가 제한적입니다. 해당 정보가 필요한 경우 대신 PropertyPass 을 사용하는 것이 좋습니다.