En esta página

Sintaxis

qmllint escribe esta categoría de advertencia como « [syntax] ».

No se admiten componentes en línea anidados

¿Qué ha pasado?

Has definido un componente en línea dentro de otro componente en línea.

¿Por qué es un error?

El lenguaje QML no permite componentes en línea anidados. Define siempre los componentes en línea dentro del elemento raíz del archivo QML.

Ejemplo

import QtQuick

Item {
    component Correct: Item {
        component Evil: Item { ... }
        ...
    }
}

Para solucionar esta advertencia, desplaza todos los componentes al elemento raíz del archivo QML.

import QtQuick

Item {
    component NotEvilAnymore: Item { ... }
    component Correct: Item {
        ...
    }
}

La declaración de un componente en línea debe ir seguida de un nombre de tipo

¿Qué ha pasado?

Has definido un componente en línea con un tipo base no válido.

¿Por qué es un error?

Los componentes en línea necesitan un tipo base del que heredar.

Ejemplo

import QtQuick

Item {
    property Item someProperty
    component InlineComponent: someProperty {}
}

En este caso, « someProperty » no es un nombre de tipo válido, ya que se trata de un nombre de propiedad. Para solucionar esta advertencia, utiliza un tipo válido como tipo base del componente:

import QtQuick

Item {
    property Item someProperty
    component InlineComponent: Item { ... }
}

Expresión de alias no válida: se necesita un inicializador

¿Qué ha pasado?

Has definido un alias de propiedad sin la propiedad a la que hace referencia.

¿Por qué es un error?

Las propiedades alias siempre deben incluir la propiedad a la que hacen referencia o su identificador en su definición.

Ejemplo

import QtQuick

Item {
    id: root
    property int someProperty
    property alias aliasProperty
}

Para solucionar esta advertencia, sustituye el alias por una propiedad normal o añade la propiedad a la que hace referencia el alias que falta:

import QtQuick

Item {
    id: root
    property int someProperty
    property alias withAliasedProperty: root.someProperty
}

Expresión de alias no válida: solo se pueden asignar alias a identificadores y expresiones de miembros de campo

¿Qué ha pasado?

Has definido un alias de propiedad que hace referencia a una expresión que no es un identificador ni una expresión de miembro de campo.

Una expresión de miembro de campo es una expresión del tipo someId.someProperty.

¿Por qué es un error?

Las propiedades de alias siempre deben incluir la propiedad a la que hacen referencia en su definición, y no pueden vincularse a otras expresiones que no sean identificadores o expresiones de miembro de campo.

Ejemplo

import QtQuick

Item {
    property int p
    property alias someProperty: p + 1
}

Para solucionar esta advertencia, sustituya el alias por una propiedad normal o vincúlelo a un identificador o a una expresión de miembro de campo:

import QtQuick

Item {
    id: root
    property int p
    property int someProperty: p + 1
    property alias alternative: root.p
}

El identificador debe ir seguido de un identificador

¿Qué ha pasado?

Has definido un ID sin valor.

¿Por qué es un error?

El lenguaje QML no permite identificadores vacíos.

Ejemplo

import QtQuick

Item {
    id:;
}

Para solucionar esta advertencia, vincula el identificador a un nombre válido:

import QtQuick

Item {
    id: root;
}

Error al analizar el identificador

¿Qué ha pasado?

Has vinculado un identificador a una expresión que no es un nombre.

¿Por qué es un error?

El lenguaje QML solo permite nombres como enlaces a identificadores; no se pueden utilizar expresiones más complejas.

Ejemplo

import QtQuick

Item {
    property int a
    property int b
    function f() {
        if (true)
            return a
        return b
    }

    id: f()
}

Para solucionar esta advertencia, vincula el identificador a un nombre válido o declara una propiedad y configura un enlace:

import QtQuick

Item {
    property int a
    property int b
    function f() {
        if (true)
            return a
        return b
    }

    id: someItem // it would be confusing to call it `f` like the function
    property int alternative: f()
}

Declarar un objeto que no es un objeto QML como miembro de una lista

¿Qué ha pasado?

Has añadido una expresión que no es un objeto a una lista de objetos.

¿Por qué es un error?

El lenguaje QML solo permite objetos en las listas de objetos.

Ejemplo

import QtQuick

Item {
    property int hello
    property list<Item> myList: [
        Item {}, hello{}
    ]
}

Para solucionar esta advertencia, utiliza un tipo de objeto válido o elimina el elemento de la lista:

import QtQuick

Item {
    component Hello: Item {}
    property list<Item> myList: [
        Item {}, Hello{}
    ]
}

Argumento desconocido para pragma

¿Qué ha pasado?

Has especificado un argumento no válido para una directiva pragma.

¿Por qué es un error?

La directiva pragma no tendrá ningún efecto.

Ejemplo

pragma ComponentBehavior: Buond
import QtQuick

Item {
}

Puedes solucionar esta advertencia eliminando la directiva «pragma» o corrigiendo un posible error tipográfico:

pragma ComponentBehavior: Bound
import QtQuick

Item {
}

© 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.