En esta página

XmlListModel QML Type

Para definir un modelo de solo lectura utilizando datos XML. Más información...

Import Statement: import QtQml.XmlListModel

Propiedades

Métodos

Descripción detallada

Para utilizar este elemento, tendrás que importar el módulo con la siguiente línea:

import QtQml.XmlListModel

XmlListModel se utiliza para crear un modelo de solo lectura a partir de datos XML. Se puede utilizar como fuente de datos para elementos de vista (como ListView, PathView o GridView) y otros elementos que interactúan con los datos del modelo (como Repeater).

Nota: Este modelo no admite consultas XPath. Admite rutas sencillas separadas por barras y, opcionalmente, un atributo por cada elemento.

Por ejemplo, si hay un documento XML en https://www.qt.io/blog/rss.xml como este:

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0">
  ...
  <channel>
    <item>
      <title>Qt 6.0.2 Released</title>
      <link>https://www.qt.io/blog/qt-6.0.2-released</link>
      <pubDate>Wed, 03 Mar 2021 12:40:43 GMT</pubDate>
    </item>
    <item>
      <title>Qt 6.1 Beta Released</title>
      <link>https://www.qt.io/blog/qt-6.1-beta-released</link>
      <pubDate>Tue, 02 Mar 2021 13:05:47 GMT</pubDate>
    </item>
    <item>
      <title>Qt Creator 4.14.1 released</title>
      <link>https://www.qt.io/blog/qt-creator-4.14.1-released</link>
      <pubDate>Wed, 24 Feb 2021 13:53:21 GMT</pubDate>
    </item>
  </channel>
</rss>

Un XmlListModel podría crear un modelo a partir de estos datos, de la siguiente manera:

import QtQml.XmlListModel

XmlListModel {
    id: xmlModel
    source: "https://www.qt.io/blog/rss.xml"
    query: "/rss/channel/item"

    XmlListModelRole { name: "title"; elementName: "title" }
    XmlListModelRole { name: "pubDate"; elementName: "pubDate" }
    XmlListModelRole { name: "link"; elementName: "link" }
}

El valor «/rss/channel/item» de « query » especifica que el XmlListModel debe generar un elemento de modelo para cada « <item> » del documento XML.

Los objetos « XmlListModelRole » definen los atributos de los elementos del modelo. En este caso, cada elemento del modelo tendrá los atributos « title », « pubDate » y « link », que se corresponden con los valores « title », « pubDate » y « link » de su « <item> » correspondiente. (Consulte la documentación de XmlListModelRole para ver más ejemplos).

El modelo se podría utilizar en un ListView, de la siguiente manera:

ListView {
    width: 180; height: 300
    model: xmlModel
    delegate: Text { text: title + ": " + pubDate + "; link: " + link }
}

Los datos de ` XmlListModel ` se cargan de forma asíncrona, y ` status ` se establece en ` XmlListModel.Ready ` cuando finaliza la carga. Ten en cuenta que esto significa que, cuando se utiliza ` XmlListModel ` para una vista, esta no se rellena hasta que se haya cargado el modelo.

Documentación de propiedades

count : int

El número de registros de datos del modelo.

progress : real

Esto indica el progreso actual de la descarga de la fuente de datos XML. Este valor oscila entre 0,0 (no se han descargado datos) y 1,0 (se han descargado todos los datos). Si los datos XML no proceden de una fuente remota, el progreso pasa a ser 1,0 tan pronto como se leen los datos.

Ten en cuenta que, cuando el progreso es 1,0, los datos XML se han descargado, pero aún no se han cargado en el modelo. Utiliza la propiedad «status» para saber cuándo se han leído los datos XML y se han cargado en el modelo.

Véase también status y source.

query : string

Una cadena que representa la ruta base para crear elementos del modelo a partir de los objetos « XmlListModelRole » de este modelo. La consulta debe comenzar por '/'.

roles : list<XmlListModelRole>

Los roles que se pondrán a disposición para este modelo.

source : url

La ubicación de la fuente de datos XML.

status : enumeration

Especifica el estado de carga del modelo, que puede ser uno de los siguientes:

ConstanteDescripción
XmlListModel.NullNo se han establecido datos XML para este modelo.
XmlListModel.ReadyLos datos XML se han cargado en el modelo.
XmlListModel.LoadingEl modelo está leyendo y cargando datos XML.
XmlListModel.ErrorSe ha producido un error durante la carga del modelo. Consulta errorString() para obtener más detalles sobre el error.

Véase también progress.

Documentación del método

string errorString()

Devuelve una cadena con la descripción del último error que se ha producido si ` status ` es un objeto de tipo ` XmlListModel.Error`.

void reload()

Vuelve a cargar el modelo.

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