@jsenv/navi 0.29.81 → 0.29.82
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/jsenv_navi.js +15 -1
- package/dist/jsenv_navi.js.map +3 -3
- package/docs/autofocus.md +25 -5
- package/package.json +1 -1
package/docs/autofocus.md
CHANGED
|
@@ -9,6 +9,7 @@ decision.
|
|
|
9
9
|
- [A popup that is read before it is filled](#a-popup-that-is-read-before-it-is-filled)
|
|
10
10
|
- [The most precise wins](#the-most-precise-wins)
|
|
11
11
|
- [On a touch device: the surface is what one arrives on](#on-a-touch-device-the-surface-is-what-one-arrives-on)
|
|
12
|
+
- [Opting a field back in](#opting-a-field-back-in)
|
|
12
13
|
- [What a field says about itself](#what-a-field-says-about-itself)
|
|
13
14
|
- [When the opening places nothing](#when-the-opening-places-nothing)
|
|
14
15
|
|
|
@@ -100,14 +101,33 @@ the terms checkbox, the submit button. Landing there scrolls the popup to it and
|
|
|
100
101
|
the title is above the top edge again, keyboard or no keyboard. The cause
|
|
101
102
|
changes, the user sees the same thing.
|
|
102
103
|
|
|
103
|
-
Nothing to pass, and nothing to remember per call site.
|
|
104
|
-
|
|
105
|
-
|
|
104
|
+
Nothing to pass, and nothing to remember per call site.
|
|
105
|
+
|
|
106
|
+
### Opting a field back in
|
|
107
|
+
|
|
108
|
+
Some popups really are opened to type in: one comment box, one rename field.
|
|
109
|
+
There, the field says so itself, and that beats the device — step 2 of the
|
|
110
|
+
ladder comes before step 3 was ever skipped.
|
|
111
|
+
|
|
112
|
+
```jsx
|
|
113
|
+
<Dialog>
|
|
114
|
+
<Heading>Leave a comment</Heading>
|
|
115
|
+
<Textarea name="comment" autoFocus />
|
|
116
|
+
</Dialog>
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
Worth saying out loud before writing it: a popup holding one field is not
|
|
120
|
+
necessarily a popup opened to fill it — it is often opened to READ what the
|
|
121
|
+
field holds, and raising the keyboard over it then costs the reading for nothing.
|
|
122
|
+
The default answers that case; `autoFocus` on the field answers the other, and
|
|
123
|
+
saying which is which is the caller's to make because nothing about the markup
|
|
124
|
+
can tell them apart.
|
|
106
125
|
|
|
107
126
|
## What a field says about itself
|
|
108
127
|
|
|
109
|
-
- `autoFocus` — "I am what the user came for". A picker's search box
|
|
110
|
-
|
|
128
|
+
- `autoFocus` — "I am what the user came for". A picker's search box, the field
|
|
129
|
+
of a popup opened to type in it. It holds on a touch device too: it is how a
|
|
130
|
+
field opts back into a keyboard the surface would otherwise keep down.
|
|
111
131
|
- `autoFocus="restore"` — "never on a fresh open, but bring me back". A field
|
|
112
132
|
the user was typing in when a popup over it closed: reopening returns to it,
|
|
113
133
|
opening for the first time does not raise a keyboard on it.
|