mirror of
https://github.com/ghostty-org/ghostty.git
synced 2025-07-14 15:56:13 +03:00
114 lines
2.6 KiB
Plaintext
114 lines
2.6 KiB
Plaintext
import VTSequence from "@/components/VTSequence";
|
|
|
|
# Delete Line (DL)
|
|
|
|
<VTSequence sequence={["CSI", "Pn", "M"]} />
|
|
|
|
Deletes `n` lines at the current cursor position and shifts existing
|
|
lines up.
|
|
|
|
The parameter `n` must be an integer greater than or equal to 1. If `n` is less than
|
|
or equal to 0, adjust `n` to be 1. If `n` is omitted, `n` defaults to 1.
|
|
|
|
If the current cursor position is outside of the current scroll region,
|
|
this sequence does nothing. The cursor is outside of the current scroll
|
|
region if it is above the [top margin](#TODO), below the [bottom margin](#TODO),
|
|
left of the [left margin](#TODO), or right of the [right margin](#TODO).
|
|
|
|
This sequence unsets the pending wrap state.
|
|
|
|
This sequence moves the cursor column to the left margin.
|
|
|
|
Remove the top `n` lines of the current scroll region, and shift existing
|
|
lines up. The space created at the bottom of the scroll region should be
|
|
blank with the background color set according to the current SGR state.
|
|
|
|
If a [left margin](#TODO) or [right margin](#TODO) is set, only the cells
|
|
within and including the margins are deleted or shifted.
|
|
Other existing contents to the left of the left margin or right of the
|
|
right margin remains untouched.
|
|
|
|
If a multi-cell character would be split, erase the full multi-cell
|
|
character. For example, if "橋" is printed to the left of the left margin
|
|
and shifting the line down as a result of DL would split the character,
|
|
the cell should be erased.
|
|
|
|
## Validation
|
|
|
|
### DL V-1: Simple Delete Line
|
|
|
|
```bash
|
|
printf "\033[1;1H" # move to top-left
|
|
printf "\033[0J" # clear screen
|
|
printf "ABC\n"
|
|
printf "DEF\n"
|
|
printf "GHI\n"
|
|
printf "\033[2;2H"
|
|
printf "\033[M"
|
|
```
|
|
|
|
```
|
|
|ABC_____|
|
|
|GHI_____|
|
|
```
|
|
|
|
### DL V-2: Cursor Outside of Scroll Region
|
|
|
|
```bash
|
|
printf "\033[1;1H" # move to top-left
|
|
printf "\033[0J" # clear screen
|
|
printf "ABC\n"
|
|
printf "DEF\n"
|
|
printf "GHI\n"
|
|
printf "\033[3;4r" # scroll region top/bottom
|
|
printf "\033[2;2H"
|
|
printf "\033[M"
|
|
```
|
|
|
|
```
|
|
|ABC_____|
|
|
|DEF_____|
|
|
|GHI_____|
|
|
```
|
|
|
|
### DL V-3: Top/Bottom Scroll Regions
|
|
|
|
```bash
|
|
printf "\033[1;1H" # move to top-left
|
|
printf "\033[0J" # clear screen
|
|
printf "ABC\n"
|
|
printf "DEF\n"
|
|
printf "GHI\n"
|
|
printf "123\n"
|
|
printf "\033[1;3r" # scroll region top/bottom
|
|
printf "\033[2;2H"
|
|
printf "\033[M"
|
|
```
|
|
|
|
```
|
|
|ABC_____|
|
|
|GHI_____|
|
|
|________|
|
|
|123_____|
|
|
```
|
|
|
|
### DL V-4: Left/Right Scroll Regions
|
|
|
|
```bash
|
|
printf "\033[1;1H" # move to top-left
|
|
printf "\033[0J" # clear screen
|
|
printf "ABC123\n"
|
|
printf "DEF456\n"
|
|
printf "GHI789\n"
|
|
printf "\033[?69h" # enable left/right margins
|
|
printf "\033[2;4s" # scroll region left/right
|
|
printf "\033[2;2H"
|
|
printf "\033[M"
|
|
```
|
|
|
|
```
|
|
|ABC123__|
|
|
|DHI756__|
|
|
|G___89__|
|
|
```
|