VIM Zoom v0.3.4
A simple plugin to toggle zoom of current window within the current tab.
This is heavily inspired from tmux's zoom pane feature.
Installation
Use your favorite plugin manager to install this plugin (recommended).
pathogen.vim
git clone https://github.com/dhruvasagar/vim-zoom.git ~/.vim/bundle/vim-zoom
If however you don't use a plugin manager such as pathogen, vundle, neobundle, vim-plug then you can copy all files within this repository directly within your ~/.vim folder. (not recommended)
Usage
Simply use the provided mapping <C-W>m to toggle zoom in and out for the current window
NOTE: In an attempt to keep this plugin as lean as possible, it avoids having to deal with special buffers created by plugins that aren't backed by actual files. This is a trade-off we've made consiously and helps us keep our plugin less than 100 lines of code.
If that doesn't work for you and for other more advanced use cases you may want to consider alternate plugins such as goyo.vim
Statusline
VIM Zoom provides zoom#statusline() API to be used for adding
g:zoom#statustext value to your statusline while your window is zoomed.
g:zoom#statustext defaults to value 'zoomed'. You may add this to your
statusline like this :
set statusline+=%{zoom#statusline()}
If you're using some complex statusline plugin, you may need to refer to its documentation to figure out how to add this to your statusline.
Example configuration for lualine.nvim
-- Set lualine options
sections = {
-- left
lualine_a = { 'mode' },
lualine_b = { 'branch', 'diff', 'diagnostic' },
lualine_c = { 'filename' },
-- right
lualine_x = { "vim.fn['zoom#statusline']()", 'encoding', 'fileformat', 'filetype' },
lualine_y = { 'progress' },
lualine_z = { 'location' }
})Contributions of configurations for other statusline plugins are appreciated.
Contributing
Contributing to code :
- Fork it.
- Commit your changes and give your commit message some love.
- Push to your fork on github.
- Open a Pull Request.
Reporting an Issue :
Credits
This plugin was heavily inspired by tmux's zoom pane feature.