Visual Studio CodeTutoriaux

Todo Tree dans VS Code : WordPress externe : retrouver et traiter les TODO et FIXME

Créez deux repères dans « Mon atelier numérique », retrouvez leur ligne dans Todo Tree et traitez chaque tâche. Une contre-épreuve montre pourquoi un brouillon peut rester hors de la liste.

Souhaitez-vous écouter cet article ?

Lecture uniquement sur demande. La qualité des voix dépend du navigateur.

Todo Tree dans VS Code -Vous laissez une note dans un fichier : « corriger cet affichage ». Quelques jours plus tard, vous ne savez plus où elle se trouve ni ce qui devait être vérifié. Todo Tree dans VS Code rassemble ces repères et vous ramène à leur ligne. Dans cet atelier, vous traiterez deux tâches de « Mon atelier numérique » et vérifierez pourquoi un brouillon n’apparaît pas dans la liste.

A14 : faire d’un commentaire une tâche vérifiable

Cet article du module 3 prolonge le travail sur les conventions d’A13. Cette fois, la convention porte sur les commentaires : chacun doit indiquer une action et un résultat reconnaissable.

Dans cet atelier, TODO désigne un travail à faire ; FIXME, un comportement à corriger. Ces mots ne déclenchent aucune action. La notation est un choix d’équipe ; un FIXME n’est pas automatiquement une urgence. Préférez « afficher À vérifier si l’état est vide » à « régler le problème ».

ÉlémentRôle
Recherche native de VS CodeVérifier ponctuellement les occurrences dans plusieurs fichiers.
Todo TreeMaintenir une vue navigable des repères selon les tags et le périmètre choisis.
ripgrepExécutable de recherche locale utilisé par Todo Tree pour parcourir le dossier.
NavigateurVérifier le comportement de la petite page, sans serveur ni compte.

Un résultat de recherche n’est pas un ticket : il n’attribue pas un responsable, ne conserve pas l’état d’avancement et ne prouve pas que la tâche est réglée.

Préparer un dossier autonome

Le scénario cible Windows 11 x64 avec VS Code pour ordinateur déjà installé et francisé. Le choix x64 correspond à un PC Intel ou AMD 64 bits ; sous Windows ARM64, utilisez la version adaptée de VS Code. Les fichiers sont légers : aucune carte graphique particulière, aucun serveur et aucune installation de Node.js ne sont nécessaires. Utilisez une version stable maintenue et relevez son numéro dans Aide > À propos.

Créez un dossier neuf, par exemple :

C:\Users\VotreNom\Ateliers\mon-atelier-numerique-a14

Remplacez VotreNom par le dossier réel de votre profil. Avec Fichier > Ouvrir le dossier, ouvrez ce dossier précis : il sera la racine, c’est-à-dire le point de départ de la recherche. Ne sélectionnez pas tout votre dossier utilisateur. Sur macOS et Linux, choisissez un dossier utilisateur équivalent ; les chemins relatifs du projet restent identiques.

Le guide des fichiers et panneaux de VS Code permet de retrouver les repères de l’interface. Créez depuis l’Explorateur de VS Code les fichiers suivants, avec leurs dossiers :

Chemin depuis la racineRôle
index.htmlPage de démonstration et premier repère.
scripts/etat.jsFonction qui choisit le libellé à afficher et second repère.
archives/brouillon.jsTémoin exclu, sans effet sur la page.
.vscode/settings.jsonRéglages de recherche pour ce dossier uniquement.

Si vous utilisez les fichiers fournis, ouvrez uniquement 01-depart. Ouvrir le dossier parent mélangerait les repères de plusieurs états de l’atelier.

Installer et identifier Todo Tree

CritèreVérification documentaire du 5 novembre 2026
Nom exactTodo Tree
Éditeur et identifiantGruntfuggly · Gruntfuggly.todo-tree
DistributionMarketplace officiel
LicenceMIT, déclarée par le manifeste.
CoûtRecherche, arborescence, navigation et surlignage documentés sans abonnement ni compte imposé. Aucun niveau payant identifié.
Version documentée0.0.224 dans le manifeste ; entrée du changelog datée du 9 février 2023.
CompatibilitéMoteur VS Code ^1.72.0 déclaré. Le fonctionnement sur une version actuelle ou dans VS Code Web n’a pas été vérifié.
Dépendancesripgrep, recherché notamment dans l’installation de VS Code ; bibliothèques JavaScript déclarées, dont micromatch pour les motifs de fichiers. Aucune autre extension obligatoire déclarée.
MaintenanceDépôt et suivi des problèmes accessibles. La version documentée est ancienne ; aucun engagement de maintenance ou de compatibilité n’est établi.

Le manifeste et le changelog permettent de recontrôler ces informations. GitHub

Ouvrez Extensions avec Ctrl+Maj+X sous Windows/Linux, ou Cmd+Maj+X sous macOS. Recherchez @id:Gruntfuggly.todo-tree, vérifiez l’éditeur, puis cliquez sur Installer. Relevez la version effectivement installée. Si l’extension ne trouve pas ripgrep, voyez le dépannage.

Créer les deux tâches et le témoin exclu

Dans index.html, enregistrez :

<!doctype html>
<html lang="fr">
  <head>
    <meta charset="utf-8">
    <!-- TODO: Donner à l’onglet le titre Mon atelier numérique — tableau de suivi. -->
    <title>Atelier</title>
    <script src="scripts/etat.js" defer></script>
  </head>
  <body>
    <h1>Mon atelier numérique</h1>
    <p>État du dossier :</p>
    <p id="etat" role="status"></p>
  </body>
</html>

Le titre d’onglet est provisoire. Le script indiqué par src se trouve dans le dossier scripts, et defer permet de l’exécuter après l’analyse du document. La balise H1 appartient au fichier de l’exercice.

Dans scripts/etat.js, enregistrez :

function libelleEtat(etat) {
  // FIXME: Afficher « À vérifier » si l’état est une chaîne vide.
  return etat;
}

document.querySelector("#etat").textContent = libelleEtat("");

L’état fourni est volontairement vide. La fonction renvoie cette valeur telle quelle ; la page ne montre donc aucun libellé après « État du dossier : ». textContent insère du texte, sans interpréter la valeur comme du HTML.

Dans archives/brouillon.js, enregistrez :

// TODO: Relire ce brouillon historique.

Ce fichier n’est pas chargé par la page. Il sert à vérifier qu’un repère peut exister sur disque sans apparaître dans la vue filtrée.

Limiter la recherche aux tâches de l’atelier

Dans .vscode/settings.json, enregistrez :

{
  "todo-tree.general.tags": ["TODO", "FIXME"],
  "todo-tree.regex.regex": "^[ \\t]*(//|<!--)[ \\t]*($TAGS):",
  "todo-tree.regex.regexCaseSensitive": true,
  "todo-tree.tree.scanMode": "workspace",
  "todo-tree.filtering.includeGlobs": ["**/*.html", "**/*.js"],
  "todo-tree.filtering.excludeGlobs": ["**/archives/**", "**/node_modules/**"],
  "todo-tree.tree.showCountsInTree": true,
  "todo-tree.tree.hideTreeWhenEmpty": false
}

Si le fichier existe déjà, fusionnez les propriétés dans son objet JSON au lieu d’effacer les réglages présents.

  • Tags et casse. general.tags choisit les deux mots surveillés. La sensibilité à la casse impose TODO ou FIXME en majuscules.
  • Forme du repère. ^ impose un début de ligne. Après une éventuelle indentation viennent // ou <!--, puis un des tags à la place de $TAGS et un deux-points. Les antislashs sont doublés dans la chaîne JSON.
  • Périmètre. Le mode workspace recherche dans le dossier, pas seulement dans l’onglet actif. Les motifs d’inclusion acceptent HTML et JavaScript. Les exclusions retirent archives et dépendances de la recherche ; elles ne déplacent ni ne suppriment les fichiers.
  • Présentation. Les deux derniers réglages demandent des compteurs dans l’arbre et une vue qui reste visible quand elle est vide. Visual Studio Marketplace

Une expression régulière décrit la forme d’un texte. Celle-ci est volontairement étroite : elle ignore par exemple un commentaire placé après une instruction sur la même ligne. Elle ne comprend pas la syntaxe complète du code. Une ligne ressemblante dans une chaîne multiligne peut encore correspondre : ouvrez la ligne avant de décider qu’il s’agit d’une tâche.

Retrouver les repères et traiter le premier

  1. Enregistrez les fichiers. Cliquez sur l’icône Todo Tree dans la barre d’activité. Développez les résultats, utilisez Refresh dans l’en-tête de la vue et effacez un filtre de texte éventuel.
  2. Contrôlez le départ. Vous devez trouver deux repères : le TODO d’`index.html` et le FIXME de scripts/etat.js. Le TODO d’`archives` doit rester absent.
  3. Ouvrez le TODO. Un clic dans l’arbre doit ouvrir index.html à sa ligne. Le bouton Group by Tag permet de regrouper les tâches par type ; il change la présentation, pas le périmètre.
  4. Modifiez le titre. Remplacez <title>Atelier</title> par <title>Mon atelier numérique — tableau de suivi</title>. Enregistrez et ouvrez index.html dans un navigateur par double-clic depuis l’Explorateur système. Le titre doit apparaître sur l’onglet après actualisation.
  5. Retirez le repère traité. Supprimez le commentaire TODO après avoir vérifié le titre. Enregistrez puis actualisez Todo Tree : il doit rester un seul repère, le FIXME. Visual Studio Marketplace

La vérification du résultat vient avant la suppression du commentaire. Une baisse du compteur, seule, ne prouve rien sur la page.

Exercice autonome : corriger l’état vide

Partez de la vue avec le seul FIXME. Rejoignez sa ligne depuis l’arbre. Faites afficher À vérifier quand la fonction reçoit une chaîne vide, sans changer un état renseigné tel que Prêt. Vérifiez la page dans le navigateur ; retirez le FIXME après le contrôle. Conservez le même périmètre et laissez le brouillon en place.

Pour vérifier le deuxième cas, remplacez temporairement libelleEtat("") par libelleEtat("Prêt") à la dernière ligne. Enregistrez et actualisez la page : le texte doit rester Prêt. Rétablissez ensuite l’appel avec la chaîne vide, enregistrez et contrôlez de nouveau.

Corrigé commenté

Contenu final de scripts/etat.js :

function libelleEtat(etat) {
  if (etat === "") {
    return "À vérifier";
  }
  return etat;
}

document.querySelector("#etat").textContent = libelleEtat("");

Le test strict etat === "" cible précisément le cas demandé. Un libellé déjà renseigné passe par return etat et reste intact. Une chaîne constituée uniquement d’espaces n’est pas vide au sens de ce test ; ce cas sort de la consigne.

La page doit afficher À vérifier. Après enregistrement et actualisation de Todo Tree, la vue doit être vide dans le périmètre défini. Le brouillon contient toujours son repère.

Prouver le résultat avec une deuxième recherche

Ouvrez la recherche native avec Ctrl+Maj+F, ou Cmd+Maj+F sur macOS. Activez Expression régulière (bouton .*) et la sensibilité à la casse (Aa). Saisissez :

^[ \t]*(//|<!--)[ \t]*(TODO|FIXME):

Dans les champs avancés, indiquez **/*.html,**/*.js en inclusion et **/archives/**,**/node_modules/** en exclusion. Si un réglage d’exclusion natif ou un fichier d’ignorance intervient dans votre dossier de test, examinez-le avant de comparer les deux recherches. code.visualstudio.com

Vous devez obtenir zéro résultat dans les fichiers de travail. Retirez temporairement **/archives/** de la recherche native : le TODO du brouillon doit apparaître. Rétablissez ensuite ce filtre. Cette contre-épreuve montre la différence entre « aucun résultat » et « aucune tâche nulle part ».

Point de contrôleRésultat attendu
DépartDeux repères : HTML et JavaScript.
Titre vérifié et TODO retiréUn FIXME.
État vide corrigé, cas Prêt préservé, FIXME retiréZéro dans le périmètre.
Contrôle natif sans l’exclusion archivesUn TODO dans le brouillon, toujours sur disque.

Notez vos versions de VS Code et de Todo Tree, les trois comptages, le titre et les deux libellés observés. Conservez les résultats réels, même s’ils diffèrent de cette fiche.

Vérifications effectuées : ripgrep 15.2.0 a reproduit le motif et les filtres sur les fichiers livrés et trouvé 2, 1, puis 0 résultats. Sans l’exclusion, le témoin reste détectable. Node.js v24.22.1 a exécuté le script avec un document simulé : l’état vide initial devient À vérifier après correction, et Prêt reste inchangé.

À valider sur Windows : installation, localisation du moteur ripgrep, vue Todo Tree, navigation, rafraîchissement et affichage réel de la page. Les essais locaux ne constituent pas un test de l’extension dans VS Code ni une recette dans un navigateur. Aucune capture de ces opérations n’a été produite.

Dépanner sans fausser le comptage

ObservationVérification utile
Aucun repère au départVérifiez la racine ouverte, l’activation de l’extension, l’enregistrement, le deux-points, la casse et le filtre de texte.
Un seul fichier est analyséVérifiez le mode workspace. Une vue limitée aux fichiers ouverts ne mesure pas le même périmètre.
Le brouillon apparaîtVérifiez le chemin archives/brouillon.js et l’exclusion. Le regroupement par tag ne change pas les fichiers recherchés.
La vue conserve une ancienne ligneEnregistrez puis cliquez sur Refresh. Contrôlez la ligne et le résultat natif.
ripgrep est introuvableVérifiez la version et la distribution de VS Code. La clé documentée todo-tree.ripgrep.ripgrep peut désigner le chemin absolu d’un exécutable ripgrep de confiance. La recherche native suffit pour continuer sans ce réglage.
La page reste videVérifiez l’enregistrement, le chemin scripts/etat.js, l’identifiant etat et l’actualisation du navigateur. Le compteur de tâches ne valide pas le script.

Données, réseau et retrait de l’extension

Le scénario utilise des recherches et des fichiers locaux. L’installation et les mises à jour passent par les services de distribution. L’ouverture de liens externes, dont les URL de sous-tags si elles sont configurées, peut contacter un site. Aucun réglage de télémétrie dédié n’a été identifié dans le manifeste et la documentation consultés. Aucun trafic du paquet installé n’a été mesuré. GitHub

L’extension lance un exécutable de recherche. Examinez les réglages d’un dossier inconnu avant d’adopter un chemin d’exécutable ou des arguments ripgrep qu’il définit. Évitez de placer des secrets ou des données personnelles dans les commentaires d’un dépôt partagé. Une exclusion de recherche ne protège pas un fichier et ne le masque pas aux autres outils.

Sans extension, la recherche native avec le même motif reste utilisable. Pour désinstaller Todo Tree, ouvrez sa fiche, choisissez Désinstaller et rechargez VS Code si demandé. Retirez seulement les propriétés todo-tree.* dont vous n’avez plus besoin dans les réglages du dossier. Les commentaires et les corrections restent dans les fichiers.

Sources officielles

Consultées le 5 novembre 2026 :

Afficher plus

Atoolpha

À propos d'ATOOLPHA Fondé par Christophe Kvachet, ATOOLPHA est né d'une passion pour l'informatique et les technologies numériques. À travers ses articles, ses développements et ses expérimentations, ATOOLPHA partage ses connaissances et défend une approche accessible, rigoureuse et responsable du numérique.

Articles similaires

Bouton retour en haut de la page