@jsenv/navi 0.29.454 → 0.29.455
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/dev/jsenv_navi.js +29 -69
- package/dist/dev/jsenv_navi.js.map +5 -5
- package/dist/jsenv_navi.js +26 -68
- package/dist/jsenv_navi.js.map +5 -5
- package/docs/control_value.md +18 -0
- package/package.json +1 -1
package/docs/control_value.md
CHANGED
|
@@ -65,6 +65,21 @@ picker's own signal follows its popup the same way, gesture by gesture, and so
|
|
|
65
65
|
does its `uiAction`. What waits for the close is the picker's `action` — and a
|
|
66
66
|
suggestion nobody touched, which becomes the answer when the popup closes on it.
|
|
67
67
|
|
|
68
|
+
A change made while the popup is **closed** has no close to wait for, so it is
|
|
69
|
+
sent at once: the clear cross, a `Picker.Chip`'s cross, a paste or a cut on the
|
|
70
|
+
trigger, a [`--navi-update`](#a-button-that-proposes-a-value-is---navi-update)
|
|
71
|
+
aimed at it — each runs the picker's `action` on the spot, and a failure puts
|
|
72
|
+
the value back. That is what lets a picker whose every gesture saves stand alone,
|
|
73
|
+
with no "Save" button around it. Three things send nothing:
|
|
74
|
+
|
|
75
|
+
- a value written from elsewhere (its signal, a rollback): the picker is told,
|
|
76
|
+
nobody acted;
|
|
77
|
+
- a button with an `action` of its own, whose command clears or updates the
|
|
78
|
+
picker: that action already made the request, and the command only brings
|
|
79
|
+
the picker in line with it;
|
|
80
|
+
- a picker that picks nothing (`type="confirm"`): its `action` is the yes of its
|
|
81
|
+
question, never something its trigger can say.
|
|
82
|
+
|
|
68
83
|
The write-back replaces the `uiAction` that copies the value into a signal:
|
|
69
84
|
|
|
70
85
|
```jsx
|
|
@@ -135,6 +150,9 @@ offered to that control. It is not an action, and not a signal to write by hand:
|
|
|
135
150
|
- the **target** is `commandFor`, naming the control's id — left out, the
|
|
136
151
|
nearest control around the button, which is what a button placed inside the
|
|
137
152
|
control it proposes to wants;
|
|
153
|
+
- a closed picker with an `action` sends the value at once, as it does for any
|
|
154
|
+
change made to it while closed (see
|
|
155
|
+
[above](#a-bound-signal-works-in-both-directions));
|
|
138
156
|
- the press goes through the same gate as every other interaction, so a
|
|
139
157
|
read-only, disabled or busy control **refuses it and says why**.
|
|
140
158
|
|