mirror of
https://github.com/NotAShelf/specs.nvim.git
synced 2024-12-28 13:42:24 +00:00
6efd3e066d
This section shows the user the availability of the `show_specs()` function which gives them the ability to add it to keybinds to find the cursor easily. Shows them example use cases as well outside of just invoking it regularly.
102 lines
3.7 KiB
Markdown
102 lines
3.7 KiB
Markdown
# specs.nvim 👓
|
|
Show where your cursor moves when jumping large distances (e.g between windows). Fast and lightweight, written completely in Lua.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Install
|
|
Using [packer.nvim](https://github.com/wbthomason/packer.nvim):
|
|
```lua
|
|
use {'edluffy/specs.nvim'}
|
|
```
|
|
Using [vim-plug](https://github.com/junegunn/vim-plug):
|
|
```vimscript
|
|
Plug 'edluffy/specs.nvim'
|
|
```
|
|
## Usage
|
|
If you are using init.vim instead of init.lua, remember to wrap block below with `lua << EOF` and `EOF`
|
|
```lua
|
|
require('specs').setup{
|
|
show_jumps = true,
|
|
min_jump = 30,
|
|
popup = {
|
|
delay_ms = 0, -- delay before popup displays
|
|
inc_ms = 10, -- time increments used for fade/resize effects
|
|
blend = 10, -- starting blend, between 0-100 (fully transparent), see :h winblend
|
|
width = 10,
|
|
winhl = "PMenu",
|
|
fader = require('specs').linear_fader,
|
|
resizer = require('specs').shrink_resizer
|
|
},
|
|
ignore_filetypes = {},
|
|
ignore_buftypes = {
|
|
nofile = true,
|
|
},
|
|
}
|
|
```
|
|
|
|
- `:lua require('specs').toggle()`
|
|
- Toggle Specs on/off
|
|
|
|
Faders:
|
|
- linear_fader `▁▂▂▃▃▄▄▅▅▆▆▇▇██`
|
|
- exp_fader `▁▁▁▁▂▂▂▃▃▃▄▄▅▆▇`
|
|
|
|
- pulse_fader `▁▂▃▄▅▆▇█▇▆▅▄▃▂▁`
|
|
|
|
- empty_fader `▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁`
|
|
|
|
Resizers:
|
|
- shrink_resizer `░░▒▒▓█████▓▒▒░░`
|
|
|
|
- slide_resizer `████▓▓▓▒▒▒▒░░░░`
|
|
|
|
- empty_resizer `███████████████`
|
|
|
|
You can implement your own custom fader/resizer functions for some pretty cool effects:
|
|
```lua
|
|
require('specs').setup{
|
|
popup = {
|
|
-- Simple constant blend effect
|
|
fader = function(blend, cnt)
|
|
if cnt > 100 then
|
|
return 80
|
|
else return nil end
|
|
end,
|
|
-- Growing effect from left to right
|
|
resizer = function(width, ccol, cnt)
|
|
if width-cnt > 0 then
|
|
return {width+cnt, ccol}
|
|
else return nil end
|
|
end,
|
|
}
|
|
}
|
|
```
|
|
|
|
### Keybinds
|
|
|
|
You can invoke specs from anywhere by using `:lua require('specs').show_specs()`
|
|
Add a keybind for this to make it easy to find your cursor at any time.
|
|
|
|
```lua
|
|
-- Press <C-b> to call specs!
|
|
vim.api.nvim_set_keymap('n', '<C-b>', ':lua require("specs").show_specs()', { noremap = true, silent = true })
|
|
|
|
-- You can even bind it to search jumping and more, example:
|
|
vim.api.nvim_set_keymap('n', 'n', 'n:lua require("specs").show_specs()<CR>', { noremap = true, silent = true })
|
|
vim.api.nvim_set_keymap('n', 'N', 'N:lua require("specs").show_specs()<CR>', { noremap = true, silent = true })
|
|
```
|
|
|
|
## Planned Features
|
|
- [ ] More builtin faders + resizers
|
|
- [ ] Colorizers
|
|
- [ ] Optional highlight on text yank
|