[vim/vim] Implement opacity for popups (PR #19272)

mattn

unread,

Jan 29, 2026, 6:27:23 AM (7 days ago) Jan 29

to vim/vim, Subscribed

Popup windows in Vim currently have no transparency support. Users cannot create semi-transparent overlays that allow underlying text to be visible through the popup.

So, add a new opacity option for popup windows that controls transparency level.

image.png (view on web) image.png (view on web)

https://github.com/user-attachments/assets/cd8c2f9e-f6f5-42c6-b7c1-ef7e82fcfb71

### Usage

```vim
" Create a popup with 50% opacity (semi-transparent)
let winid = popup_create('Semi-transparent text', #{
    \ line: 5,
    \ col: 10,
    \ opacity: 50,
    \ })

" Change opacity dynamically
call popup_setoptions(winid, #{opacity: 80})

" Get current opacity value
echo popup_getoptions(winid).opacity

Opacity values

0 - Fully transparent (background text fully visible)
100 - Fully opaque (default, no transparency)
1-99 - Partially transparent

Requirements

Requires 'termguicolors' to be enabled for the blending effect to work

You can view, comment on, or merge this pull request online at:

https://github.com/vim/vim/pull/19272

Commit Summary

0084a1a Implement opacity for popups

File Changes

(8 files)

Patch Links:

—
Reply to this email directly, view it on GitHub.
You are receiving this because you are subscribed to this thread.

mattn

unread,

Jan 29, 2026, 6:31:29 AM (7 days ago) Jan 29

to vim/vim, Push

@mattn pushed 1 commit.

4191f25 Implement opacity for popups

—
View it on GitHub or unsubscribe.
You are receiving this because you are subscribed to this thread.

mattn

unread,

Jan 29, 2026, 6:37:27 AM (7 days ago) Jan 29

to vim/vim, Push

@mattn pushed 1 commit.

775e56c Implement opacity for popups

—
View it on GitHub or unsubscribe.

You are receiving this because you are subscribed to this thread.

mattn

unread,

Jan 31, 2026, 7:24:47 AM (4 days ago) Jan 31

to vim/vim, Push

@mattn pushed 1 commit.

71aec12 Fix popup opacity reset when calling popup_setoptions with other options

—
View it on GitHub or unsubscribe.

You are receiving this because you are subscribed to this thread.

mattn

unread,

7:20 AM (12 hours ago) 7:20 AM

to vim/vim, Push

@mattn pushed 1 commit.

e4ad85f Fix overlaped popups

—
View it on GitHub or unsubscribe.

You are receiving this because you are subscribed to this thread.

Reply all

Reply to author

Forward