Typing is what this exists for: a field editor records one change per keystroke, so without a
rule the user has to press Ctrl+Z once per character to take a title back. What counts as one
user action is editing policy, driven by how people type, and it changes independently of what
a change is — which is why it lives here rather than as a merge method on
org.. A second rule can arrive without touching the value model.
org. answers the same question for autosave, backup and
shared-database writes, and deliberately answers it differently: see there for why the two
rules are not shared.
The journal decides when to ask: only for a change recorded as EditSource#TYPING, never
inside a recording block, never across a save, and never across a boundary a caller drew with
UndoManager#endStep. A command that writes the field the user was typing in is therefore its
own step, however well it would have fitted the rule below.
| Modifier and Type | Field and Description |
|---|---|
| public static final CoalescingPolicy | CONSECUTIVE_FIELD_EDITS
Keystrokes in one field become one step, up to the end of a word. |
| public static final CoalescingPolicy | NONE
Every change is its own step. |
| Modifier and Type | Method and Description |
|---|---|
| private static boolean | |
| public Optional |
| CONSECUTIVE_FIELD_EDITS | back to summary |
|---|---|
| public static final CoalescingPolicy CONSECUTIVE_FIELD_EDITS Keystrokes in one field become one step, up to the end of a word. Two field changes are one action when they describe the same field of the same entry and the second starts where the first ended — the shape a run of keystrokes has. The merged change spans the run: from the value the field held before the first keystroke to the value it holds after the last. A completed word ends the run, the way every other editor breaks a run of typing. Without it, Ctrl+Z on a typo at the end of an abstract takes back the whole abstract: Ctrl+Y brings it back, but a user who has just watched a paragraph vanish does not think of Ctrl+Y first. | |
| NONE | back to summary |
|---|---|
| public static final CoalescingPolicy NONE Every change is its own step. | |
| endsInWhitespace | back to summary |
|---|---|
| private static boolean endsInWhitespace(@Nullable String value) Whether the run so far ends on a word boundary. An absent field counts as empty: there is no word to have finished. | |
| merge | back to summary |
|---|---|
| public Optional | |
