Sur cette page

Alias cycle

Cette catégorie d'avertissement est orthographiée [alias-cycle] par qmllint.

La propriété alias fait partie d'un cycle d'alias.

Qu'est-ce qui s'est passé ?

Un alias de propriété se résout en lui-même ou en un autre alias qui se résout en lui-même.

Habituellement, un alias de propriété doit référencer une autre propriété soit directement, soit indirectement en passant par une autre propriété alias.

Si un alias de propriété se réfère directement ou indirectement à lui-même, il forme un cycle d'alias. L'avertissement indique que l'alias de propriété actuel se trouve à l'intérieur d'un cycle d'alias ou y fait référence, voir l'exemple.

Pourquoi est-ce mauvais ?

Les instances des composants avec des cycles d'alias ne seront pas créées à l'exécution : elles seront nulles à la place.

Exemple

import QtQuick

Item {
    id: someId
    property alias myself: someId.myself // not ok: referring to itself

    property alias cycle: someId.cycle2 // not ok: indirectly referring to itself
    property alias cycle2: someId.cycle

    property alias indirect: someId.cycle // not ok: referring to alias indirectly referring to itself
}

Pour corriger cet avertissement, séparez les cycles d'alias :

import QtQuick

Item {
    id: someId
    Item {
        id: anotherId
        property string myself
        property int cycle
    }
    property alias myself: anotherId.myself // ok: referring to a property

    property alias cycle: someId.cycle2 // ok: does not refer to itself anymore
    property alias cycle2: anotherId.cycle // ok: not a cycle anymore

    property alias indirect: someId.cycle // ok: cycle does not form an alias cycle anymore
}

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.