106 lines
4 KiB
Markdown
106 lines
4 KiB
Markdown
fzf.vim
|
|
=======
|
|
|
|
A set of [fzf][fzf]-based Vim commands.
|
|
|
|
Rationale
|
|
---------
|
|
|
|
[fzf][fzf] in itself is not a Vim plugin, and the official repository only
|
|
provides the [basic wrapper function][run] for Vim and it's up to the users to
|
|
write their own Vim commands with it. However, I've learned that many users of
|
|
fzf are not familiar with Vimscript and are looking for the "default"
|
|
implementation of the features they can find in the alternative Vim plugins.
|
|
|
|
This repository is a bundle of fzf-based commands extracted from my
|
|
[.vimrc][vimrc] to address such needs. The commands are opinionated and not
|
|
designed to be extremely flexible or configurable, and they are not guaranteed
|
|
to be backward-compatible.
|
|
|
|
Installation
|
|
------------
|
|
|
|
Using [vim-plug](https://github.com/junegunn/vim-plug):
|
|
|
|
```vim
|
|
Plug 'junegunn/fzf', { 'dir': '~/.fzf', 'do': 'yes \| ./install' }
|
|
Plug 'junegunn/fzf.vim'
|
|
```
|
|
|
|
List of commands
|
|
----------------
|
|
|
|
| Command | List |
|
|
| --- | --- |
|
|
| `Files [PATH]` | Files (similar to `:FZF`) |
|
|
| `Buffers` | Open buffers |
|
|
| `Colors` | Color schemes |
|
|
| `Ag [PATTERN]` | [ag][ag] search result (`CTRL-A` to select all, `CTRL-D` to deselect all) |
|
|
| `Lines` | Lines in loaded buffers |
|
|
| `Tags` | Tags in the project (`ctags -R`) |
|
|
| `BTags` | Tags in the current buffer |
|
|
| `Locate PATTERN` | `locate` command output |
|
|
| `History` | `v:oldfiles` and open buffers |
|
|
| `Snippets` | Snippets ([UltiSnips][us]) |
|
|
| `Commands` | User-defined commands |
|
|
|
|
- All commands except `Colors` support `CTRL-T` / `CTRL-X` / `CTRL-V` key
|
|
bindings to open in a new tab, a new split, or in a new vertical split.
|
|
- Bang-versions of the commands (e.g. `Ag!`) will open fzf in fullscreen
|
|
|
|
### Customization
|
|
|
|
```vim
|
|
" This is the default extra key bindings
|
|
let g:fzf_action = {
|
|
\ 'ctrl-t': 'tab split',
|
|
\ 'ctrl-x': 'split',
|
|
\ 'ctrl-v': 'vsplit' }
|
|
```
|
|
|
|
Fuzzy completion helper
|
|
-----------------------
|
|
|
|
`fzf#complete` is a helper function for creating custom fuzzy completion using
|
|
fzf. If the first parameter is a command string or a Vim list, it will be used
|
|
as the source.
|
|
|
|
```vim
|
|
" Replace the default dictionary completion with fzf-based fuzzy completion
|
|
inoremap <expr> <c-x><c-k> fzf#complete('cat /usr/share/dict/words')
|
|
```
|
|
|
|
For advanced uses, you can pass an options dictionary to the function. The set
|
|
of options is pretty much identical to that for `fzf#run` only with the
|
|
following exceptions:
|
|
|
|
- `reducer` (funcref)
|
|
- Reducer transforms the output lines of fzf into a single string value
|
|
- `prefix` (string; default: `\k*$`)
|
|
- Regular expression pattern to extract the completion prefix
|
|
- Both `source` and `options` can be given as funcrefs that take the
|
|
completion prefix as the argument and return the final value
|
|
- `sink` or `sink*` are not allowed
|
|
|
|
```vim
|
|
function! s:first_line_in_uppercase(lines)
|
|
return toupper(a:lines[0])
|
|
endfunction
|
|
|
|
inoremap <expr> <c-x><c-k> fzf#complete({
|
|
\ 'source': 'cat /usr/share/dict/words',
|
|
\ 'reducer': function('<sid>first_line_in_uppercase'),
|
|
\ 'options': '--no-multi --reverse --margin 15%,0',
|
|
\ 'left': 20})
|
|
```
|
|
|
|
License
|
|
-------
|
|
|
|
MIT
|
|
|
|
[fzf]: https://github.com/junegunn/fzf
|
|
[run]: https://github.com/junegunn/fzf#usage-as-vim-plugin
|
|
[vimrc]: https://github.com/junegunn/dotfiles/blob/master/vimrc
|
|
[ag]: https://github.com/ggreer/the_silver_searcher
|
|
[us]: https://github.com/SirVer/ultisnips
|