DISIC / Ara

Faire des audits de conformité au RGAA, partager les rapports et la déclaration d’accessibilité.
https://ara.numerique.gouv.fr
35 stars 8 forks source link

Ajouter l'aide à la saisie markdown #310

Closed maxime-lecoq closed 1 year ago

maxime-lecoq commented 1 year ago

toute solution bienvenue

ThomasBonamy commented 1 year ago

Si on a pas encore de solution pourquoi ce n'est pas en conception ?

bellangerq commented 1 year ago

Hier on est parti sur l'idée d'afficher un texte d'aide avec un lien vers une documentation (https://www.markdownguide.org/basic-syntax). J'ai 2 questions à ce propos :

  1. Actuellement, le label des champs est caché visuellement (dans la PJ, le "Description de l'erreur", c'est le titre de l'accordéon). Du coup je sais pas si on peut afficher uniquement un texte d'aide au-dessus du champ tout en gardant le label caché.
  2. Est-ce qu'on affiche cette mention sur tous les textareas ? Donc "Description de l'erreur" + "Recommandation de correction" si NC et "Commentaires (optionnel)" si C ou NA ?
benoitdequick commented 1 year ago

Comme vu dans la page suivante https://ara.numerique.gouv.fr/rapports/0FLfK2Gy1rH7jHxXAAza9/detail-des-resultats, les raccourcis basiques sont ok : gras, italique, barré, lien, titre, paragraphes, passage à la ligne, liste à puce, code en ligne, bloc de code, citation.

Où mettre le lien vers l'aide ? Le mettre à chaque zone de saisie surchargerait un peu trop la page. Voir comment le mettre en haut de page...

AdrienMuzyczka commented 1 year ago

2 solutions à tester :

AdrienMuzyczka commented 1 year ago

Maquettes : https://www.figma.com/file/kBe9Ds7SErQiFUsMJNRskf/Ara_V0.5_B%C3%AAta?node-id=442%3A415562&t=0cEcqPh1bFHc255D-1

Une préférence pour la V2 où l'information est liée à l'élément concerné.

bellangerq commented 1 year ago

Pareil, plutôt partisan d'avoir l'info là où on en a besoin.

benoitdequick commented 1 year ago

Ok pour la v2. Affichage des infos nécessaires dans une modale.

Titre
### Titre Niveau N 
#### Titre Niveau N+1
##### Titre Niveau N+2

Paragraphe, liste à puce et retour à la ligne
* Un retour à la ligne ajoute un paragraphe 
* Un astérisque introduit un item de liste 
* Deux espaces en fin de ligne suivi d’un retour à la ligne permettent d'ajouter un saut de ligne

Mise en exergue
Mettre de texte en **gras** ou en *italique*

Code et citation
un simple backticks permet d'introduire `une ligne de code` et trois backticks un bloc de code 
> Un bloc de citation est ajouté grâce au chevron simple >
AdrienMuzyczka commented 1 year ago

Maquette de la modale à afficher au clic sur le lien "Markdown pris en compte". J'ai ajouté un sommaire pour faciliter l'accès à l'information lors d'une recherche spécifique.

Règles DSFR :

hissalht commented 1 year ago

Question :

Image

Pour les exemples de titres, est-ce qu'on rend des "vrais" titres ? Ou est-ce qu'on aria-hidden-ise la section avec le rendu ? Pour éviter que les technos d'assistance parsent des titres bidons.

benoitdequick commented 1 year ago

aria-masquons les.