CleanCocoa / CleanCocoa/DeclarativeTextKit

Command block that restores scroll offsets and selection like Emac Lisp save-excursion

Aperta
#4 1 commento 0 reazioni 0 assegnatari Vedi su GitHub
enhancement
Lingua principale
Swift
Stelle
50
Fork
0
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Descrizione

> Note: This may not be needed in practice at all. We have to test this.

-------------

One feature that Emacs Lisp provides is to jump around in a buffer and read and write text, then restore the context exactly as it was before so that the user doesn't perceive anything. This is called `save-excursion`.

```swift
// Imagine we're in the middle of a long document here, like
// line 500 of 1000.

SaveExcursion {
Select(LineRange(at: 0)) {
// ... do stuff on the first line ...
}
Select(LineRange(at: buffer.endLocation)) {
// ... do stuff on the last line line ...
}
}

// At this point, we're at line 500 again and the scroll offset is the same as before
```

Unlike our `Buffer.character(at:)`, Emacs buffers can't access substrings without moving them into view. There, the buffer is the model, and moving the reading head also moves the scrolled viewport.

`NSTextView` can show similar behavior when you change characters in one place and attributes in a larger place and the effective range is enlargened; then the `NSTextStorage.processEditing()` run will move the insertion point:

![example](https://github.com/CleanCocoa/DeclarativeTextKit/assets/59080/3f19b40b-c1dd-49c7-8276-a1ccb6a3c328)
Source and fix:

`UITextView` doesn't have this problem.

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Direzione di ricerca

Inizia verificando se questo comportamento è necessario, quindi esamina il comportamento di Buffer.character(at:) e NSTextStorage.processEditing() descritto nell’issue. Confronta i casi NSTextView e UITextView prima di scegliere un approccio di implementazione. Il lavoro sarà completato quando un comando potrà eseguire mutazioni del buffer ripristinando al contempo la selezione precedente e l’offset di scorrimento quando il comportamento è richiesto.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
swift
Ambito
desktop-dev
Tipo di issue
Funzionalità
Difficoltà
5/5
Tempo stimato
Più di una settimana
Stato di attività
Ferma
Chiarezza
Da chiarire
Idoneità per principianti
25/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.