Lista de tareas
Una implementación en QML de una aplicación de lista de tareas pendientes que muestra cómo crear una aplicación con aspecto nativo en cualquier plataforma.
«Lista de tareas» muestra un ejemplo de aplicación de lista de tareas que tiene un aspecto nativo en cualquier plataforma. El ejemplo se puede ejecutar y editar tanto en Qt Design Studio como en Qt Creator. Muestra cómo crear y utilizar un estilo personalizado y cómo usar la configuración para controlar la apariencia y el comportamiento de la aplicación. También muestra cómo implementar un comportamiento sencillo de arrastrar y soltar en los delegados. La aplicación utiliza el almacenamiento local para guardar elementos en el dispositivo y XMLHttpRequest para recuperar datos de la API pública (funcionalidad «Random Tasks»). Las vistas están controladas por un componente « StackView ».
Ejecución del ejemplo
Puede ejecutar el ejemplo desde:
- Qt Creator
Abre el modo « Welcome » y selecciona el ejemplo en Examples. Para obtener más información, consulta Qt Creator: Tutorial: Compilar y ejecutar.
- Qt Extension for Visual Studio Code
Ejecute el comando « Qt: Open Qt examples » desde Command Palette y seleccione el ejemplo de la lista. Para obtener más información, consulte Qt Extension for Visual Studio Code: Tutorial: Compilar y ejecutar.






Selección del estilo de la aplicación
La aplicación admite diferentes estilos en función de la plataforma de destino. Los estilos CustomStyle, Basic, Material y Universal están disponibles en cada plataforma (Windows, Android, iOS, macOS). El estilo de Windows solo está disponible en Windows y el de iOS, únicamente en iOS. La lista de estilos disponibles se encuentra en una de las subpáginas del « SettingsView », llamada «Style». El estilo actualmente utilizado se puede cambiar desde ese mismo lugar. Es necesario reiniciar la aplicación para que se apliquen los cambios. La aplicación informará al usuario de ello mediante el mensaje « ToolTip ».
Cambiar el tema
Cada estilo admite también los temas «oscuro» y «claro». El tema se puede cambiar desde la subpágina «Tema» de SettingsView. No todos los estilos permiten al usuario cambiar el tema manualmente; por ejemplo, en iOS esta opción no está disponible. En ese caso, el tema se cambiará según la configuración predeterminada del sistema. La primera vez que se inicie la aplicación, utilizará el tema del sistema.
Control del comportamiento de la aplicación desde los ajustes
El comportamiento y el estilo de la aplicación se pueden modificar desde SettingsView. La configuración permite al usuario cambiar:
- estilo
- tema
- tamaño de la fuente
- el número máximo de tareas
- si las tareas completadas deben eliminarse automáticamente
Implementación de la lista de tareas
La aplicación cuenta con tres listas diferentes:
- Lista de tareas de hoy → Las tareas cuya fecha de vencimiento es la de hoy.
- Lista de tareas de esta semana → Las tareas que vencen en los próximos siete días.
- Tareas posteriores → Las tareas que no encajan en las listas anteriores.
Las tareas se distribuyen entre los modelos de lista al inicio de la aplicación. Por supuesto, las tareas pueden pasar de un modelo de lista a otro en tiempo de ejecución (cuando cambia su fecha de vencimiento). La definición de cada lista se realiza en TasksList.qml y TasksListForm.ui.qml, y las instancias se crean en TasksListsView.qml/TasksListsViewForm.ui.qml.
ListModel {
id: todayTasksListModel
}
ListModel {
id: thisWeekTasksListModel
}
ListModel {
id: laterTasksListModel
}
Column {
id: column
anchors.fill: parent
spacing: 14
TasksList {
id: todayTasks
width: column.width
maxHeight: 180
listModel: todayTasksListModel
headerText: qsTr("Today")
tasksCount: todayTasksListModel.count
}
TasksList {
id: thisWeekTasks
width: column.width
maxHeight: column.height - y - 60
listModel: thisWeekTasksListModel
headerText: qsTr("This week")
tasksCount: thisWeekTasksListModel.count
}
TasksList {
id: laterTasks
width: column.width
maxHeight: column.height - y
listModel: laterTasksListModel
headerText: qsTr("Later")
tasksCount: laterTasksListModel.count
}
}El rellenado del modelo de lista con datos se realiza en TasksListsView.qml y en Component.onCompleted.
function createTasksLists() : void {
var tasks = Database.getTasks()
var currentDate = new Date()
var format = Qt.locale().dateFormat(Locale.LongFormat)
var dateStr = currentDate.toLocaleDateString(Qt.locale(),format)
tasks.forEach( function(task){
if (task.date === dateStr) {
todayTasksModel.append(task)
} else if (checkThisWeekDate(task.date)) {
thisWeekTasksModel.append(task)
} else {
laterTasksModel.append(task)
}
})
}
Component.onCompleted: createTasksLists()Comportamiento de deslizamiento, arrastre y soltado
La vista de lista utiliza TasksListDelegate como delegado. El delegado es un SwipeDelegate, que permite al usuario deslizar el elemento para resaltarlo (el elemento se desplaza a la parte superior de la lista) o para eliminarlo. También permite al usuario marcar la tarea como completada (el elemento se desplaza al final de la lista) o arrastrar y soltar el elemento para moverlo a una posición específica de la lista. La implementación de estos comportamientos se realiza en TasksListDelegate.qml.
Uso del almacenamiento local
El almacenamiento local se utiliza para leer y escribir los elementos de las tareas en bases de datos SQLite. La implementación de esta y otras funciones auxiliares se lleva a cabo en Database.qml, que es un objeto singleton.
property var _db
function _database() {
if (_db) return _db
try {
let db = LocalStorage.openDatabaseSync("ToDoList", "1.0", "ToDoList app database")
db.transaction(function (tx) {
tx.executeSql(`CREATE TABLE IF NOT EXISTS tasks (
task_id INTEGER PRIMARY KEY AUTOINCREMENT,
task_name,
task_dueDate TEXT,
task_dueTime TEXT,
task_notes TEXT,
done INTEGER,
highlighted INTEGER
)`);
})
_db = db
} catch (error) {
console.log("Error opening databse: " + error)
};
return _db
}
function addTask(taskName, taskDueDate, taskDueTime, taskNotes, taskDone, taskHighlighted) {
let results
root._database().transaction(function(tx){
tx.executeSql(`INSERT INTO tasks (task_name, task_dueDate, task_dueTime,
task_notes, done, highlighted) VALUES(?,?,?,?,?,?);`,
[taskName, taskDueDate, taskDueTime, taskNotes, taskDone, taskHighlighted])
results = tx.executeSql("SELECT * FROM tasks ORDER BY task_id DESC LIMIT 1")
})
return results.rows.item(0).task_id
}Uso de XMLHttpRequest para recuperar datos de una API pública
Se utiliza XMLHttpRequest para enviar solicitudes a algunas API públicas y recuperar los datos de respuesta. La aplicación utiliza boredapi, que puede devolver una tarea aleatoria que realizar. A continuación, la tarea se añade a la lista de tareas de hoy.
function sendHttpRequest() : void {
var http = new XMLHttpRequest()
var url = "https://www.boredapi.com/api/activity";
http.open("GET", url, true);
http.setRequestHeader("Content-type", "application/json");
http.setRequestHeader("Connection", "close");
http.onreadystatechange = function() {
if (http.readyState == 4) {
if (http.status == 200) {
let object = JSON.parse(http.responseText.toString());
let currentDate = new Date()
let format = Qt.locale().dateFormat(Locale.LongFormat)
addTask(todayTasksModel, object.activity,
currentDate.toLocaleDateString(Qt.locale(), format), "","")
} else {
console.log("Failed to fetch a random TODO item; the API provider might be down")
}
}
}
http.send();
}Archivos fuente
Véase también Todos los ejemplos de Qt XML y Ejemplos y tutoriales deQt Quick .
© 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.