Navigation

Disposition générale

L'application Favoris utilise une disposition en deux colonnes :

| Zone | Ce qu'elle contient | |------|-------------------| | Barre latérale gauche | Arborescence de dossiers, liens de raccourci (Étoilés, Tous les Favoris, Tous les Dossiers) et le bouton Importer | | Zone principale | La vue actuellement sélectionnée — tableau de bord, contenu d'un dossier, formulaire de favori, liste ou étoilés |

La barre latérale est toujours visible. La zone principale se met à jour via HTMX sans rechargement complet de la page, ce qui rend la navigation instantanée.

Barre latérale

Arborescence de dossiers

La barre latérale liste vos dossiers racine (dossiers sans parent) par ordre alphabétique. Chaque nom de dossier est un lien cliquable qui ouvre le contenu du dossier dans la zone principale.

Si un dossier racine possède des sous-dossiers, ils apparaissent en retrait en dessous lorsque vous ouvrez le dossier parent. La barre latérale elle-même n'affiche que les dossiers racine — la hiérarchie complète des sous-dossiers est révélée dans la vue du contenu du dossier.

Liens de raccourci

En dessous de la liste des dossiers, vous trouverez trois raccourcis permanents :

| Lien | Vous emmène vers | |------|-----------------| | Étoilés | Tous les favoris que vous avez marqués d'une étoile (la vue Étoilés complète) | | Tous les Favoris | Une liste paginée et consultable de chaque favori dans tous vos cercles | | Tous les Dossiers | Une liste paginée et consultable de chaque dossier racine dans tous vos cercles |

Bouton Nouveau Dossier

Le bouton + Nouveau Dossier en haut de la barre latérale ouvre le formulaire de création de dossier dans la zone principale.

Bouton Importer

Le bouton Importer dans la barre latérale ouvre une fenêtre modale où vous pouvez télécharger un fichier JSON pour créer en masse un dossier et ses favoris en une seule étape.

Tableau de bord (accueil)

Le tableau de bord est ce que vous voyez lorsque vous ouvrez Favoris pour la première fois. Il vous donne un aperçu instantané :

• Favoris récents — les 8 favoris les plus récemment sauvegardés, chacun affichant son titre, son URL et son dossier (si applicable). Cliquez sur un titre pour ouvrir le lien dans un nouvel onglet.
• Étoilés — jusqu'à 6 favoris étoilés pour un accès rapide.
• Dossiers principaux — jusqu'à 8 dossiers à la racine. Cliquez sur une carte de dossier pour l'ouvrir.
• Compteurs — total des favoris et des dossiers dans tous vos cercles, pour que vous sachiez toujours quelle est la taille de votre bibliothèque.

Depuis le tableau de bord, vous pouvez également cliquer sur + Nouveau Favori (en haut à droite) ou + Nouveau Dossier (barre latérale) pour passer directement à la création de contenu.

Vue du contenu d'un dossier

Cliquer sur un dossier dans la barre latérale ou sur le tableau de bord ouvre sa vue de contenu. Cette vue affiche :

1. Sous-dossiers — listés en haut sous forme de cartes, chacune affichant l'icône, le nom et la couleur du dossier. Cliquez sur une carte de sous-dossier pour y naviguer.
2. Favoris — listés en dessous des sous-dossiers. Chaque ligne affiche le favicon, le titre (lien), l'URL, le badge de dossier et les tags.
3. Barre de recherche — filtre les favoris du dossier par titre ou URL en temps réel.
4. Barre de pagination — lorsqu'un dossier contient de nombreux éléments, utilisez les boutons Précédent / Suivant ou modifiez le paramètre d'éléments par page (10, 20 ou 50).
5. Bouton + Nouveau Sous-dossier — crée un nouveau dossier imbriqué dans le dossier actuel.
6. Bouton + Nouveau Favori — ouvre le formulaire de favori avec le dossier actuel pré-sélectionné.
7. Boutons Modifier et Supprimer sur chaque élément — visibles uniquement lorsque vous avez la permission requise.

Fil d'Ariane / navigation vers le haut

Lorsque vous naviguez dans un sous-dossier, la vue du contenu affiche le nom du dossier parent pour que vous sachiez toujours où vous êtes. Cliquez sur le nom du dossier parent pour remonter d'un niveau.

Vue Tous les Favoris

Accessible via le raccourci de la barre latérale ou à /bookmarks/list. Cette vue affiche chaque favori de tous vos cercles dans une liste plate unique.

• Barre de recherche — saisissez n'importe quel mot-clé et appuyez sur Rechercher. Les correspondances sont trouvées dans les titres, les URLs et les descriptions. Utilisez le bouton Effacer pour réinitialiser.
• Sélecteur de tri — basculez entre Plus récents (par défaut) et Plus consultés.
• Compteur de résultats — affiche "Affichage X à Y sur Z résultats" pour que vous sachiez toujours où vous en êtes dans la liste.
• Pagination — choisissez 10, 20, 50 ou 100 éléments par page.
• Chaque ligne affiche : favicon, titre (s'ouvre dans un nouvel onglet), description (si présente), URL, nom du dossier (si assigné), date de création et date de dernière visite.

Vue Tous les Dossiers

Accessible via le raccourci de la barre latérale. Affiche chaque dossier à la racine par ordre alphabétique dans tous vos cercles.

• Barre de recherche — filtrez les dossiers par nom.
• Pagination — naviguez dans de grandes collections.
• Cliquer sur une ligne de dossier ouvre sa vue de contenu dans la zone principale.

Vue Étoilés

Accessible via le raccourci de la barre latérale. Affiche tous les favoris que vous avez marqués d'une étoile, quel que soit le dossier dans lequel ils se trouvent ou le cercle auquel ils appartiennent.

Chaque entrée affiche :

• Favicon et titre (lien cliquable vers le site).
• L'icône étoile.
• URL, description, badge de dossier (cliquez pour accéder à la vue du dossier) et tags.
• Les horodatages Dernière visite et Mis à jour.
• Un bouton Modifier (si vous avez la permission d'écriture).

Formulaire de favori (créer / modifier)

Le formulaire de favori s'ouvre en cliquant sur + Nouveau Favori ou le bouton Modifier sur n'importe quel favori. Champs :

| Champ | Notes | |-------|-------| | URL | Collez l'URL complète ou juste le domaine — https:// est ajouté automatiquement. | | Titre | Obligatoire. Jusqu'à 300 caractères. | | Description | Optionnel. Jusqu'à 1 000 caractères. | | Tags | Optionnel. Séparés par des virgules, ex. outils,design,référence. | | Dossier | Optionnel. Tapez pour rechercher et sélectionner un dossier par nom. | | Favori étoilé | Cochez pour marquer ce favori d'une étoile. | | Cercle | Pré-rempli avec votre cercle par défaut. Verrouillé sur le cercle du dossier lorsqu'un dossier est sélectionné. Nécessite la permission ADMIN pour être modifié sur un favori existant. |

Le formulaire possède deux boutons d'action en bas : Enregistrer le favori (ou Mettre à jour le favori lors d'une modification) et Annuler.

Formulaire de dossier (créer / modifier)

Le formulaire de dossier s'ouvre en cliquant sur + Nouveau Dossier ou le bouton Modifier sur n'importe quel dossier. Champs :

| Champ | Notes | |-------|-------| | Cercle | Obligatoire. Autocomplétion avec recherche. Verrouillé lors de la modification sans permission ADMIN. | | Nom | Obligatoire. Jusqu'à 200 caractères. | | Dossier parent | Optionnel. Autocomplétion avec recherche — tapez pour trouver et sélectionner un parent. | | Description | Optionnel. | | Icône | Optionnel. N'importe quel emoji affiché à côté du nom du dossier. | | Couleur | Optionnel. Un sélecteur de couleur pour la couleur d'accent du dossier. |

Boutons d'action : Créer le dossier (ou Mettre à jour le dossier) et Annuler.

Fenêtre modale d'import

La fenêtre modale d'import s'ouvre en superposition sur la vue actuelle. Elle contient :

1. Un sélecteur de fichier qui accepte uniquement les fichiers .json.
2. Une liste déroulante de sélection de cercle — seuls les cercles dont vous êtes membre sont listés.
3. Une note informative expliquant la structure de fichier attendue.
4. Les boutons Annuler et Importer.

Si le fichier contient des erreurs, elles sont toutes listées dans un panneau rouge au-dessus du formulaire pour que vous puissiez les corriger toutes en même temps. La fenêtre modale reste ouverte en cas d'erreur pour que vous puissiez réessayer sans avoir à renaviguer.

Astuces de clavier et d'interaction

• Cliquer sur un titre de favori ouvre l'URL dans un nouvel onglet et enregistre automatiquement une visite.
• Les badges de dossier sur les pages Étoilés et Tous les Favoris sont cliquables — ils naviguent directement vers la vue du contenu de ce dossier.
• Les formulaires de recherche se soumettent en cliquant sur le bouton ou en changeant le menu déroulant de tri (le changement de tri déclenche une soumission automatique du formulaire).
• La barre latérale et la zone principale se mettent à jour indépendamment — naviguer dans les dossiers ne recharge jamais la page entière.