docs(docs): rev 4 fix round: trial steps, held reasons, cited tests
This commit is contained in:
1 parent
7a9ccf149c
commit
462a22e74f
2 files changed
+36
-22
No files matched your search
@@ -769,26 +769,33 @@ Tablette en paysage (au moins 1 024 px de large ; en dessous, l'éditeur est en
|
||||
15. Reprendre le tracé (souris, 1 280 px). Action : outil « Zone », posez quatre sommets, fermez le tracé, puis
|
||||
« Reprendre le tracé ». Attendu : la zone fermée reste dessinée et montre ses poignées, comme sur la planche 04 C :
|
||||
des sommets, des « + » au milieu des segments, et le « − » du sommet choisi. Glissez un sommet, cliquez un « + »,
|
||||
puis un « − », puis déplacez un sommet aux flèches. Le dessin garde la forme corrigée. Cliquez « Créer » : « Zone
|
||||
créée » avec cette forme. Tant que le nom est vide, les poignées se lisent « Sommet n de cette nouvelle zone ».
|
||||
puis un « − », puis déplacez un sommet aux flèches. Le dessin garde la forme corrigée. Cliquez « Revenir aux
|
||||
propriétés » dans la bande, puis « Créer » dans la boîte : « Zone créée » avec cette forme. Tant que le nom est
|
||||
vide, les poignées se lisent « Sommet n de cette nouvelle zone ». Une forme reprise de plus de 40 sommets n'a pas
|
||||
de poignées, et la bande ne dit pas pourquoi : seuls « Revenir aux propriétés » et « Abandonner » restent.
|
||||
16. Clavier Mac (ou toute touche Retour arrière). Action : sélectionnez « Vertèbres thoraciques », donnez le focus
|
||||
à un sommet par Tab. Appuyez sur Retour arrière : le sommet est retiré, le suivant est choisi. Au minimum de
|
||||
trois sommets, la touche est refusée et le message le dit. Faites Cmd+Z : le sommet revient. Sur ce même sommet, qui
|
||||
garde le focus, appuyez de nouveau sur Retour arrière : il est retiré une seconde fois. Appuyez sur « + » (la
|
||||
touche, pas le bouton) : un sommet est inséré après le sommet focalisé. Avec un lecteur d'écran, le groupe se lit
|
||||
« Sommets de Vertèbres thoraciques ».
|
||||
17. Tablette : le focus après chaque geste. Action : faites une série (le curseur « Taille » ou des flèches sur une
|
||||
poignée), puis touchez une poignée ; recommencez en touchant ailleurs sur le dessin, puis
|
||||
« Déplacer … », « Redessiner », « Désélectionner » et « − ». Attendu : le focus n'est jamais perdu. La touche Tab
|
||||
suivante, ou une flèche, agit là où vous l'attendez. Seul un vrai iPad sous Safari prouve ce point : Chromium donne
|
||||
lui-même le focus à l'élément touché, ses tests n'en disent rien.
|
||||
17. Tablette avec un clavier physique : le focus après chaque geste. Les flèches demandent un clavier ; un doigt sur
|
||||
le curseur « Taille » enregistre dès qu'il se lève, sans série en attente. Action : faites une série de flèches
|
||||
sur une poignée ou sur le curseur, puis touchez une poignée ; recommencez en touchant ailleurs sur le dessin, puis
|
||||
« Déplacer … », « Redessiner », « Désélectionner », « − », un outil de la colonne et une pastille de vue.
|
||||
Attendu, sur ces chemins : le focus n'est jamais perdu. La touche Tab suivante, ou une flèche, agit là où vous
|
||||
l'attendez. Seul un vrai iPad sous Safari prouve ce point : Chromium donne lui-même le focus à l'élément touché,
|
||||
ses tests n'en disent rien.
|
||||
18. Tablette et fenêtres de 1 024, 1 180 et 1 280 px : la bande qui reste en haut. Action : faites défiler la page
|
||||
avec une annotation sélectionnée. Attendu : la bande reste entière sous la barre du haut, rien ne bouge et rien
|
||||
n'est caché derrière. Un Tab sur une commande de la bande ou sur un lien de la barre ne fait pas défiler la page.
|
||||
19. Refaire retenu. Action : pendant une création (outil « Point » ou « Zone », avant « Créer »), donnez le focus à
|
||||
« Refaire » puis à « Défaire » : un lecteur d'écran lit la raison. Appuyez dessus : la raison s'affiche sous le
|
||||
dessin et rien d'autre ne se passe. Puis abandonnez la création, déplacez un point par une série de flèches sans la
|
||||
valider et cliquez « Refaire » à la souris : la raison s'affiche, la série reste en attente.
|
||||
19. Refaire retenu. Préparez quelque chose à défaire et à refaire : créez un point, déplacez-le d'un pas aux flèches
|
||||
validé par Entrée, puis « Défaire ». Action : outil « Zone », posez un sommet (la boîte de « Point » s'ouvre tout
|
||||
de suite et cache l'en-tête : prenez « Zone »), puis donnez le focus à « Refaire » puis à « Défaire » : un lecteur
|
||||
d'écran lit la raison. Appuyez dessus : la raison s'affiche sous le dessin et rien d'autre ne se passe. Puis
|
||||
« Annuler le tracé », déplacez le point par deux flèches sans valider et cliquez « Refaire » à la souris : la
|
||||
raison s'affiche, la série reste en attente. Cliquez « Défaire » : la série est annulée, et « Refaire » remet le
|
||||
déplacement d'un pas. Sans rien à refaire, « Refaire » reste grisé sans phrase.
|
||||
|
||||
#### Acceptés pendant la construction
|
||||
Vous avez accepté ces quatre comportements ; ils ne sont plus à juger :
|
||||
@@ -842,12 +849,17 @@ Interprétations et écarts par rapport aux planches :
|
||||
message « deux doigts » s'affiche quand le doigt se lève, pas dès le début du glisser.
|
||||
- Ctrl+Z défait maintenant aussi quand le focus est sur le curseur « Taille » ou une case à cocher ; seuls les champs
|
||||
de texte gardent leur propre annulation.
|
||||
- « Refaire » attend la fin de la modification en cours (un déplacement, un redessin ou des pas aux flèches non
|
||||
enregistrés), et « Défaire » comme « Refaire » sont retenus pendant une création. Les deux phrases exactes :
|
||||
« Refaire attend la fin de la modification en cours : validez-la ou annulez-la. » et « Indisponible pendant une
|
||||
création : créez l'annotation ou abandonnez-la. » Un appui sur un bouton retenu affiche la raison sous le dessin
|
||||
et ne fait rien d'autre ; un appui à la souris n'enregistre plus une série en attente. Ctrl+Z ou Cmd+Z pendant la
|
||||
retenue reste muet. Sur un autre onglet, un appui n'affiche rien : la raison est seulement lue au focus.
|
||||
- « Refaire » est suspendu pendant une modification en cours (un déplacement, un redessin ou des pas aux flèches
|
||||
non enregistrés) et pendant une création ; « Défaire » est retenu pendant une création. Une raison ne s'affiche que
|
||||
si le bouton servirait sans cette cause : sans rien à refaire (ou à défaire), le bouton reste grisé sans phrase,
|
||||
comme avant. Les trois phrases exactes : « Refaire est suspendu pendant la modification en cours : annulez-la avec
|
||||
Défaire pour pouvoir refaire. », « Refaire est suspendu pendant une création : abandonnez-la pour pouvoir
|
||||
refaire. » et « Indisponible pendant une création : créez l'annotation ou abandonnez-la. » Un appui sur un bouton
|
||||
retenu affiche la raison sous le dessin et ne fait rien d'autre ; un appui à la souris n'enregistre plus une série
|
||||
en attente. « Défaire » pendant une modification en cours l'annule sans l'enregistrer, à la souris, au doigt ou
|
||||
par Ctrl+Z, et ce qui était à refaire le reste. Quitter la poignée par Tab enregistre la série, comme avant : il
|
||||
n'y a alors plus rien à refaire. Ctrl+Z ou Cmd+Z pendant une création reste muet. Sur un autre onglet, un appui
|
||||
n'affiche rien : la raison est seulement lue au focus.
|
||||
- La touche « + » sur un sommet focalisé insère un sommet après lui, et Retour arrière retire comme Suppr. Après un
|
||||
Ctrl+Z, ces touches agissent sur la poignée qui a le focus. « + » sur la boîte du dessin zoome toujours.
|
||||
- La bande reste collée sous la barre du haut à partir de 1 024 px. La loupe peut se peindre par-dessus la bande près
|
||||
@@ -856,9 +868,11 @@ Interprétations et écarts par rapport aux planches :
|
||||
est vide (« Sommets de cette nouvelle zone »).
|
||||
- Un appui sur « − » à la souris choisit et focalise le sommet suivant, comme Suppr au clavier ; à la souris, la
|
||||
bulle « − » réapparaît sur ce sommet.
|
||||
- Au toucher, une création commencée au doigt donne le focus aux commandes du tracé (au clavier il reste sur la boîte
|
||||
du dessin). Un glisser au doigt choisit le sommet glissé dès le début du glisser. Après un toucher sur un point qui
|
||||
ouvre sa boîte de propriétés, la fermer rend le focus à la rangée de l'annotation.
|
||||
- Sous Safari, une création commencée au doigt donne le focus aux commandes du tracé (à vérifier pendant l'essai ;
|
||||
sous Chromium l'outil touché le garde, puis la boîte du dessin le prend ; au clavier il reste sur la boîte du
|
||||
dessin). Depuis les commandes du tracé, Entrée et Retour arrière n'atteignent pas les touches du tracé. Un glisser
|
||||
au doigt choisit le sommet glissé dès le début du glisser. Après un toucher sur un point qui ouvre sa boîte de
|
||||
propriétés, la fermer rend le focus à la rangée de l'annotation.
|
||||
- Les poignées d'une zone portent maintenant le nom de la zone, lu par les lecteurs d'écran : « Sommet 3 de
|
||||
Vertèbres thoraciques », « Ajouter un sommet après le sommet 3 de … », « Retirer le sommet 3 de … », et leur groupe
|
||||
s'appelle « Sommets de … » (liste complète ci-dessous).
|
||||
|
||||
@@ -55,9 +55,9 @@ Implemented (plan `.claude/tasks/plans/2026-11-17-v1-2-6-u2.md`, rev 4; boards `
|
||||
| Kind | Tests |
|
||||
|---|---|
|
||||
| Unit (tables) | the press machine (`annotations.press.test.ts`): slop per kind (4, 6 and 10 CSS px), click and drag decisions, handle priority (vertex over « − » over « + », nearest first), double click within 400 ms and 8 px opens the dialog and never inserts, a second pointer cancels; slider stops, most-used radius, snap within 8 CSS px, range (`pointSize`); midpoint insert after the segment start, « − » refused at 3 vertices (`message.vertex_min`), vertex move, no-op move, the 40-vertex cap, « + » hidden under two hit radii (`polygonEdit`); Escape action (`escape`); `missingFields` names only the missing fields in form order; keyboard map (arrows by 0.5 % of the frame's longer side, Shift ×10, Insert and Delete on a vertex, Backspace while tracing, Enter, Escape, roving focus); arrows pan only when the box itself is focused (`useFraming`, catalogue defaults unchanged); two pointers translate without scaling (`twoPointerPan`) |
|
||||
| Unit (state) | every preview, keyboard series and chosen vertex carries the `documentText` it was computed on, and a stale stamp is refused (`annotations.workStore.test.ts`); a preview is cancelled and restored, never committed, on undo, document replacement, tab change and a second pointer; redo is held (the header « Refaire » `aria-disabled`, Ctrl+Shift+Z inert) while a move mode, a redraw or uncommitted arrow or slider steps are pending, so the pending work is kept, never dropped (`editor-zone-edit.test.tsx` « final review I-1 »); a held « Refaire » or « Défaire » (a creation holds both) carries its reason as the accessible description, a press shows the reason in the message line and does nothing else (a mouse press no longer commits a pending series), Ctrl+Z during a hold is silent, and another tab shows no message (`holdOf`, `HistoryButtons.tsx`); « + » and Backspace on a focused vertex handle insert and remove like Insert and Delete, and after an undo the keys act on the focused handle (`useZoneEdit.ts`); a resumed trace gets the polygon handles on its pending shape, named « cette nouvelle zone » or « ce nouvel accès » while the form has no name, with no interior drag and no handle above 40 vertices (`creationWork.ts`); an undo with a move mode, a slider or a series pending only cancels the preview (R-13); during a creation undo is inactive and « Défaire » is hidden (A12); the message line: « Point déplacé · Défaire » calls the same `undo()` as the header, any commit, undo or redo closes it, a refusal is `role="alert"` without « Défaire », 6 s, a mouse hover or the keyboard focus inside the line pauses it (WCAG 2.2.1) and a touch does not; the hint after a futile finger drag only when the line is free and never after a two-finger gesture worked (R-1); the slider commits once on release (history depth after a keyboard walk); the strip keeps a fixed height and truncates a long name before the status; dialogs mounted outside `EditOnly`: the width flip and the mode flip keep the draft, disable the save and commit nothing (R-14); a creation, a started move mode or a started redraw asks before a tab, a section, a view chip, a tool, Back, Escape, sign-out or leaving the editor, and a document change made elsewhere announces the dropped work (R-12, R-13); `Dialog` `anchor`, a click on the veil does nothing (R-6); undo history cap 8 MiB, about 47 equine steps (R-15) |
|
||||
| Unit (state) | every preview, keyboard series and chosen vertex carries the `documentText` it was computed on, and a stale stamp is refused (`annotations.workStore.test.ts`); a preview is cancelled and restored, never committed, on undo, document replacement, tab change and a second pointer; redo is held (the header « Refaire » `aria-disabled`, Ctrl+Shift+Z inert) while a move mode, a redraw or uncommitted arrow or slider steps are pending, so the pending work is kept, never dropped (`editor-zone-edit.test.tsx` « final review I-1 »); a held « Refaire » or « Défaire » (a creation holds both) carries its reason as the accessible description only when its cause alone holds it (something to redo or to undo), a press shows the reason in the message line and does nothing else (a mouse press no longer commits a pending series), a mouse or touch press on « Défaire » over pending work only cancels it and keeps the redo stack, Ctrl+Z during a hold is silent, and a press while another tab is shown leaves the hidden line empty and keeps the description (`holdOf`, `HistoryButtons.tsx`, `editor-history-buttons.test.tsx`); « + » and Backspace on a focused vertex handle insert and remove like Insert and Delete, and after an undo the keys act on the focused handle (`useZoneEdit.ts`); a Safari tap (no focus move) on a tool or a view chip after a keyboard series commits it and lands the focus on the pressed button, never on `body` (`editor-zone-edit.test.tsx`); a resumed trace gets the polygon handles on its pending shape, named « cette nouvelle zone » or « ce nouvel accès » while the form has no name, with no interior drag and no handle above 40 vertices (`editor-creation-dialog.test.tsx`); an undo with a move mode, a slider or a series pending only cancels the preview (R-13); during a creation undo is inactive and « Défaire » is hidden (A12); the message line: « Point déplacé · Défaire » calls the same `undo()` as the header, any commit, undo or redo closes it, a refusal is `role="alert"` without « Défaire », 6 s, a mouse hover or the keyboard focus inside the line pauses it (WCAG 2.2.1) and a touch does not; the hint after a futile finger drag only when the line is free and never after a two-finger gesture worked (R-1); the slider commits once on release (history depth after a keyboard walk); the strip keeps a fixed height and truncates a long name before the status; dialogs mounted outside `EditOnly`: the width flip and the mode flip keep the draft, disable the save and commit nothing (R-14); a creation, a started move mode or a started redraw asks before a tab, a section, a view chip, a tool, Back, Escape, sign-out or leaving the editor, and a document change made elsewhere announces the dropped work (R-12, R-13); `Dialog` `anchor`, a click on the veil does nothing (R-6); undo history cap 8 MiB, about 47 equine steps (R-15) |
|
||||
| Core | the per-view minimum visible radius (`PreviewState.min_point_radius`) equals the `marker_too_small` threshold on the equine views and on edge frames (`sheet_preview.rs`, `editor-min-point-radius.test.ts`) |
|
||||
| E2E mouse | drag a vertex, « + », « − », zone drag on a selected zone, redraw accepted, redraw refused by `interior_too_small` keeps and restores the old shape, undo and redo of each (`editor-zones.spec.ts`); a point: handle drag, size by a click on the track, the move mode (`editor-annotations.spec.ts`); the properties dialog opens over the right column and never over the drawing, a click on the veil does nothing, a double click on the selected zone opens it and inserts no vertex, a typed form then Back asks, a width crossing below 1 024 px keeps the draft (`editor-properties.spec.ts`); « Défaire » in the message line undoes the same entry as the header button, which carries the accessible name « Défaire la dernière modification » (T15; EN « Undo the last change ») |
|
||||
| E2E mouse | drag a vertex, « + », « − », zone drag on a selected zone, redraw accepted, redraw refused by `interior_too_small` keeps and restores the old shape, undo and redo of each (`editor-zones.spec.ts`); a point: handle drag, size by a click on the track, the move mode (`editor-annotations.spec.ts`); the properties dialog opens over the right column and never over the drawing, a click on the veil does nothing, a double click on the selected zone opens it and inserts no vertex, a typed form then Back asks, a width crossing below 1 024 px keeps the draft (`editor-properties.spec.ts`); « Défaire » in the message line undoes the same entry as the header button, which carries the accessible name « Défaire la dernière modification » (T15; EN « Undo the last change »); during a held arrow series a mouse press on « Défaire » cancels it and « Refaire » restores the earlier move (`editor-annotations.spec.ts`); a Tab and Shift+Tab walk over the drawing place's native controls, and a keyboard Delete whose next vertex starts under the strip, land below the strip at 1 024, 1 180 and 1 280 px (`editor-geometry.spec.ts`) |
|
||||
| E2E touch (`hasTouch`, 1 024, 1 180, 1 280 px; CDP `Input.dispatchTouchEvent`) | one finger drags a vertex and the point under the loupe; every handle hit circle is at least 44 px; one finger off the handles moves nothing and shows the hint once, with no hint over a page scroll; two fingers zoom and pan; finger 1 on a vertex handle then finger 2: the drag is cancelled, the shape restored, nothing committed, the pinch zooms (Review Focus 1); the move mode by a finger; a tap on the selected shape opens the dialog and it stays open (Review Focus 5), with a chosen vertex it unchooses; the trace closes from a finger within 22 px; page scroll over the canvas with a selection and outside it (`editor-touch.spec.ts`, `editor-properties.spec.ts`, `editor-deselect.spec.ts`) |
|
||||
| Layout (A14) | `expectNoShift` (`e2e/support/layout.ts`) at 1 024, 1 180 and 1 280 px: no box of the canvas, the strip, the aside or the header moves, `scrollHeight` and the scrollbar gutter are unchanged, and the layout-shift sum is zero around selection, strip content, a message showing and expiring, the hint, a dialog opening and closing, mode entry and exit, and the first commit's save line; `scrollbar-gutter: stable` on the editor page only (`editor-annotations.spec.ts`) |
|
||||
| Keyboard | create a zone, add and remove a vertex, move the zone, validate, without a pointer; « + » inserts and Backspace removes on a focused vertex, Backspace after an undo acts on the same focused handle; Ctrl+Z on a focused handle after arrow moves only cancels the preview and a later Enter commits nothing stale; after undoing « + », « − » never removes the wrong vertex; « Désélectionner » commits a pending series |
|
||||
|
||||
Reference in new issue
Block a user