À propos des listes de tâches

Vous pouvez utiliser des listes de tâches pour diviser le travail d’un ticket ou d’une pull request en tâches plus petites, puis suivre l’ensemble du travail jusqu’à son achèvement.

Qui peut utiliser cette fonctionnalité ?

Markdown peut être utilisé dans l’interface web GitHub.

Dans cet article

À propos des listes de tâches

Important

Les blocs de listes de tâches sont mis hors service. Pour en savoir plus, consultez le Blog GitHub.

Vous pouvez utiliser les sous-problèmes pour remplacer les blocs de liste de tâches. Les sous-problèmes offrent une section dédiée dans chaque problème, ce qui facilite le suivi des tâches associées sans avoir à recourir à Markdown. Pour plus d’informations sur les sous-problèmes, consultez Ajout de sous-problèmes.

Une liste de tâches est un ensemble de tâches qui s’affichent chacune sur une ligne distincte avec une case à cocher cliquable. Vous pouvez sélectionner ou désélectionner les cases à cocher pour marquer les tâches comme terminées ou non terminées.

Vous pouvez utiliser Markdown pour créer une liste de tâches dans n’importe quel commentaire sur GitHub. Si vous référencez un problème, une demande de tirage ou une discussion dans une liste de tâches, la référence se déploie pour en afficher le titre et l’état.

Il est possible d’afficher les informations récapitulatives de la liste de tâches dans les listes de problèmes et de demandes de tirage lorsque la liste de tâches figure dans le commentaire initial.

Création de listes de tâches

Pour créer une liste de tâches, faites précéder les éléments de la liste d’un trait d’union et d’un espace, puis de [ ]. Pour marquer une tâche comme terminée, utilisez [x].

- [x] #739
- [ ] https://github.com/octo-org/octo-repo/issues/740
- [ ] Add delight to the experience when all tasks are complete :tada:

Capture d’écran montrant la version affichée du markdown. Les références aux problèmes sont affichées sous forme de titres de problème.

Remarque

Vous ne pouvez pas créer d’éléments de liste de tâches pour des problèmes fermés ou des problèmes associés à des pull requests.

Réorganisation des tâches

Vous pouvez réorganiser les éléments d’une liste de tâches. Tout d’abord, cliquez ou pointez à gauche de la case à cocher d’une tâche jusqu’à ce qu’une grille de six points s’affiche. Ensuite, faites glisser et déposez la grille pour déplacer la tâche vers un nouvel emplacement.

Vous pouvez réorganiser les tâches de différentes listes dans le même commentaire, mais vous ne pouvez pas réorganiser les tâches entre différents commentaires.

Capture d’écran d’un problème GitHub montrant deux tâches dans une liste de tâches. Une grille de six points à gauche de la deuxième tâche est délimitée en orange foncé.