Skip to content

A Vim plugin to execute `:tjump` and select tag candidate with preview by fzf

License

Notifications You must be signed in to change notification settings

kg8m/vim-fzf-tjump

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

41 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

vim-fzf-tjump

A Vim plugin aiming to be an alternative to Vim's built-in :tjump.

  • Filter tag candidates and select a one by fzf
  • Show selected tag candidate's code preview
vim-fzf-tjump-demo.mp4

Functions

fzf_tjump#jump

Show tag candidates matched with given tag name and go to selected tag. Go directly if matched tag is only 1.

Use current word (<cword>) as given tag name if no argument is given or given tag name is an empty string.

Show selected tag's code preview.

Commands

:Tjump

A wrapper of fzf_tjump#jump.

g:fzf_command_prefix is respected. The command name is :FzfTjump if you configure as following:

let g:fzf_command_prefix = "Fzf"

Mappings

vim-fzf-tjump adds no mappings. You can add mappings.

Mapping example

" Press `g]` in normal mode to call `fzf_tjump#jump`.
" Press `g]` in visual mode to call `fzf_tjump#jump` with selected word.
map g] <Plug>(fzf-tjump)

Configurations

Let's execute as following for more information:

:h vim-fzf-tjump-variables

Installation

If you use dein.vim:

call dein#add("kg8m/vim-fzf-tjump")

Requirements

  • fzf 0.22+
    • fzf 0.22 supports preview window option for setting the initial scroll offset
  • fzf.vim
  • Tag file with line numbers of tag definitions
    • You can probably create it by ctags --fields=n command
  • Newer Vim
  • Linux or Mac

About

A Vim plugin to execute `:tjump` and select tag candidate with preview by fzf

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project