Add g:which_key_ignore_outside_mappings

README.md

@@ -177,6 +177,8 @@ nnoremap <leader>_b :echom '_b'<CR>
 let g:which_key_map['_'] = { 'name': 'which_key_ignore' }
 ```
 
+If you want to hide all mappings outside of the elements of the description dictionary, use: `let g:which_key_ignore_outside_mappings = 1`.
+
 #### Example
 
 You can configure a Dict for each prefix so that the display is more readable.

autoload/which_key.vim

@@ -175,7 +175,9 @@ function! s:merge(target, native) " {{{
     endif
   endfor
 
-  call extend(target, native, 'keep')
+  if !g:which_key_ignore_outside_mappings
+    call extend(target, native, 'keep')
+  endif
 endfunction
 
 function! s:echo_prompt() abort

doc/vim-which-key.txt

@@ -309,9 +309,13 @@ Default: `1`
 
 Ignore the invalid key and let you continue to input the valid ones. Otherwise
 an error message will be popuped and abort the guide buffer.
+                                         *g:which_key_ignore_outside_mappings*
+Type: |Number|
+Default: `0`
 
+Hides all mappings outside of the elements of the description dictionary.
                                                           *'which_key_ignore'*
-If you wish to hide a mapping from the menu set its description to
+If you wish to hide a specific mapping from the menu set its description to
 `'which_key_ignore'`:
 >
     nnoremap <leader>1 :1wincmd w<CR>

plugin/which_key.vim

@@ -21,6 +21,7 @@ let g:which_key_sort_horizontal = get(g:, 'which_key_sort_horizontal', 0)
 let g:which_key_run_map_on_popup = get(g:, 'which_key_run_map_on_popup', 1)
 let g:which_key_align_by_seperator = get(g:, 'which_key_align_by_seperator', 1)
 let g:which_key_ignore_invalid_key = get(g:, 'which_key_ignore_invalid_key', 1)
+let g:which_key_ignore_outside_mappings = get(g:, 'which_key_ignore_outside_mappings', 0)
 let g:which_key_fallback_to_native_key = get(g:, 'which_key_fallback_to_native_key', 0)
 let g:which_key_default_group_name = get(g:, 'which_key_default_group_name', '+prefix')
 let g:which_key_use_floating_win = (exists('*nvim_open_win') || exists('*popup_create')) && get(g:, 'which_key_use_floating_win', 1)