Skip to content

Commit 176b666

Browse files
committed
doc: documented g:tmux_navigator_no_wrap_disable_when_zoomed
1 parent 61081e0 commit 176b666

File tree

1 file changed

+20
-0
lines changed

1 file changed

+20
-0
lines changed

README.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -302,6 +302,26 @@ bind-key -T copy-mode-vi 'C-k' if-shell -F '#{pane_at_top}' {} { select-pane
302302
bind-key -T copy-mode-vi 'C-l' if-shell -F '#{pane_at_right}' {} { select-pane -R }
303303
```
304304
305+
##### A note on the zoomed state
306+
307+
When wrapping is disabled and in zoomed state, navigation between tmux panes
308+
using `C-h,j,k,l` is not possible using the configuration above, as
309+
`#{pane_at_*}` are all `1` in zoomed state (they reflect the visible window
310+
layout, see `window_layout` vs `window_visible_layout` in `man tmux`).
311+
312+
One workaround is to replace the conditions `#{pane_at_*}` above with:
313+
```
314+
#{e|-:#{pane_at_*},#{window_zoomed_flag}}
315+
```
316+
317+
This will essentially disable the no-wrapping behavior when zoomed, resulting
318+
in unwrapped navigation (but a working one).
319+
320+
The same workaround can be enabled for vim using:
321+
```vim
322+
let g:tmux_navigator_no_wrap_disable_when_zoomed = 1
323+
```
324+
305325
#### Nesting
306326
If you like to nest your tmux sessions, this plugin is not going to work
307327
properly. It probably never will, as it would require detecting when Tmux would

0 commit comments

Comments
 (0)