Vertically aligns all cursors/selections by inserting whitespace. A very simple, quick, easy, and agnostic way to align code/text however you want.
Spaces are used by default, but tabs can also be used. The "Using Indentation Settings" variant will automatically use tabs or spaces based on your current indentation settings. Consider rebinding the default alt+a keybinding to whichever you prefer.
| Command | Description |
|---|---|
| Align Cursors | Aligns all cursors using spaces. |
| Align Cursors (Pad Front) | Aligns all cursors using spaces, adding padding to the front of selections rather than to the end. |
| Align Cursors Using Tabs | Aligns all cursors using tabs. |
| Align Cursors Using Indentation Settings | Aligns all cursors using either spaces or tabs based on the current indentation settings. |
| Align Line Last Cursors | Aligns the last curor of each line by adding spaces to the front of each line. |
Note: A "cursor" is actually a selection with a length of 0.
Inserts whitespace to the left of selections until all the selection starts are aligned with the right-most selection start. Adds whitespace to the end of selections until all selections are the same length as the longest selection.
If there are multiple selections per line. Selections are grouped into columns from left to right. All selections within a column are aligned with each other.
If tabs are used for alignment, the start and end of all selections are aligned with tab stops.
If the "Pad Front" variant is used, spaces are added to the front of selections rather than the end. This can be useful when right-aligning text.
The "Align Line Last Cursors" command behaves differently from the rest. It adds spaces to the front of each line until the right-most selection end of all lines are aligned. This can be useful when right-aligning lines.
Multiline selections don't make much sense with this tool. As such they are ignored.
See Issues.
If instead of aligning cursors a character is inserted or nothing happens, the default alt+a keybinding may be being caught higher up (ex: at the OS level). Try changing the keybinding.
If you continue to have problems, please open a new issue here.
Aligning using tabs is a bit more complicated than spaces due to the requirement that tabs must start and end at tab stops in order to be aligned. As such, in some scenarios it may seem as though unneeded tabs are being inserted. However, these tabs are indeed necessary to ensure the rule "the start and end of all selections are aligned with tab stops."
It is not possible to ensure a consistent ending position when tabs are involved. For example, it is impossible to make the ends of these two lines align:
a→ X
b→ cX
This is due to an underlying issue with vscode: microsoft/vscode#100730
There is no way to know how wide a character will be when displayed in vscode. It is completely up to the render engine with many environmental variables involved (font, ligatures, grapheme clustering, etc.). A character may even have a fractional width! Thus, there are some scenarios that are simply impossible to align correctly.
For example, this emoji 👨👩👦👦 is actually 7 characters: U+1F468 U+200D U+1F469 U+200D U+1F466 U+200D U+1F466. In vscode, placing the cursor after this emoji advances the column position by 7, indicating that it would take up the width of 7 characters. However, visually the emoji spans about 2.2 characters.
On the flip side, the Japanese Kanji for man 男 is the single character U+7537, advances the cursor column position by 1, yet visually spans about 1.9 columns.
See CHANGELOG.md