Majuscules/minuscules de la clé d’énumération

Cette catégorie d'avertissement est orthographiée « [enum-key-case] » par qmllint.

La clé de l'énumération commence par une lettre minuscule

Que s'est-il passé ?

Une énumération contient une clé commençant par une lettre minuscule.

Pourquoi est-ce un problème ?

Cela peut créer une ambiguïté lors des recherches. Les clés d'énumération doivent commencer par une majuscule afin de les distinguer des propriétés des singletons et des objets associés. Le non-respect de cette convention peut entraîner des résultats inattendus.

Exemple

// Properties.qml
import QtQuick

Item {
    enum Color { red, green, blue }
}

// Main.qml
import QtQuick

Item {
    // This lookup could be interpreted as a property lookup on a Singleton or attached object.
    property int i: Properties.green
}

Pour corriger cet avertissement, renommez la clé afin qu'elle commence par une majuscule.

// Properties.qml
import QtQuick

Item {
    enum Color { Red, Green, Blue }
}

// Main.qml
import QtQuick

Item {
    // No ambiguity for the user or the QML engine, this is an enum lookup.
    property int i: Properties.Green
}