quickr-preview.vim

Quickly preview quickfix and location results in vim without opening the file. Usually when one is browsing quickfix or location results, the file needs to be opened to see the result in detail. This spoils the buffer list and jump list. quickr-preview.vim lets you preview the result in detail without spoiling the buffer list and jump list. Everything is automatically cleaned up once quickfix window and/or location windows are closed.

Demo

Installation

This plugin follows the standard runtime path structure, and as such it can be installed with a variety of plugin managers:

Default Key maps

<leader><space> : Preview the quickfix/location result in a preview window
<enter>         : Open the quickfix/location result in a new buffer like usual

\ is the leader key by default. So the mapping is \<space> unless <leader> key is mapped to something else. Note that pressing <leader><space> multiple times on the same qiuckfix/location result will toggle the preview window.

Customization

Disable default key mappings

If you want to use your own key mappings, disable the default key mappings by adding following to your ~/.vimrc.

let g:quickr_preview_keymaps = 0

Define custom key mappings

Use <plug>(quickr_preview) to define a custom mapping for previewing the current quickfix/location results. For example:

nmap <leader>p <plug>(quickr_preview)

Use <plug>(quickr_preview_qf_close) to define a custom mapping for quickly closing the quickfix/location window (and in turn the preview window). For example:

nmap <leader>q <plug>(quickr_preview_qf_close)

Configuring the preview window position

The option g:quickr_preview_position is used to configure where the preview window will be opened relative to the qiuckfix/location window. Valid values are above, below, left, or right. If unspecified this option will default to the following:

let g:quickr_preview_position = 'above'

Configuring the preview window size

The option g:quickr_preview_size is used to configure the size of the preview window. Valid values range from zero to any positive integer. When set to zero the preview widows will automatically fill half of the available screen space. If unspecified this option will default to the following:

let g:quickr_preview_size = '0'

Configuring the preview window highlighting

The option g:quickr_preview_line_hl is used to configure the highlight group used to highlight the current result in the preview window. Valid values are any valid highlight group. If unspecified this option will default to the following:

let g:quickr_preview_line_hl = "Search"

Configuring the preview window options

The option g:quickr_preview_options is used to configure which vim settings will be applied to the buffer when it is opened within the preview window. Valid values are any vim settings that can be set with the setlocal command. If unspecified this option will default to the following:

let g:quickr_preview_options = 'number norelativenumber nofoldenable'

Auto-open preview window

The option g:quickr_preview_on_cursor is used to allow the preview window to be opened automatically each time the cursor moves to a new line within the quickfix/location window. Valid values are zero (to disable) or one (to enable). If unspecified this option will default to the following:

let g:quickr_preview_on_cursor = 0

Auto-close quickfix on enter

The option g:quickr_preview_exit_on_enter is used to define whether quickfix window will be automaticaly closed on enter or not. Valid values are zero (to disable) or one (to enable). If unspecified this option will default to the following:

let g:quickr_preview_exit_on_enter = 0

Allow modification of the contents of the preview window

The option g:quickr_preview_modifiable is used to define whether the quickfix window's contents are allowed to be modified. Valid values are zero (to disallow modification) or one (to enable modification). If unspecified this option will default to the following:

let g:quickr_preview_modifiable = 0

FAQ

Nothing happens when I press <leader><space> in quickfix/location window.

Make sure <leader><space> is not defined to something else by invoking :verbose map <leader><space>.

License

Copyright (c) Ronak Gandhi. Distributed under the same terms as Vim itself. See :help license