To use this segment, you need to activate it by adding vi_mode
to your
P9K_LEFT_PROMPT_ELEMENTS
or P9K_RIGHT_PROMPT_ELEMENTS
array, depending
where you want to show this segment.
This segment can have different states. You can customize the different states as you wish. Here is a quick overview:
This segment shows ZSH's current input mode. Note that this is only useful if
you are using the ZSH Line Editor
(VI mode). You can enable this either by .zshrc
configuration or using a plugin, like
Oh-My-Zsh's vi-mode plugin.
Variable | Default Value | Description |
---|---|---|
P9K_VI_MODE_INSERT_STRING |
"INSERT" |
String to display while in 'Insert' mode. |
P9K_VI_MODE_NORMAL_STRING |
"NORMAL" |
String to display while in 'Command' mode. |
P9K_VI_MODE_SEARCH_STRING |
"SEARCH" |
String to display while in 'Search' mode (requires the vim-mode plugin). |
P9K_VI_MODE_VISUAL_STRING |
"VISUAL" |
String to display while in 'Visual' mode. |
To hide the segment entirely when in INSERT
mode, set P9K_VI_MODE_INSERT_STRING=''
You can change the foreground and background color of this segment by setting
# VI Mode Normal
P9K_VI_MODE_NORMAL_FOREGROUND='red'
P9K_VI_MODE_NORMAL_BACKGROUND='blue'
# VI Mode Insert
P9K_VI_MODE_INSERT_FOREGROUND='red'
P9K_VI_MODE_INSERT_BACKGROUND='blue'
# VI Mode Search
P9K_VI_MODE_SEARCH_FOREGROUND='red'
P9K_VI_MODE_SEARCH_BACKGROUND='blue'
# VI Mode Visual
P9K_VI_MODE_VISUAL_FOREGROUND='red'
P9K_VI_MODE_VISUAL_BACKGROUND='blue'
The main Icon of this segment depends on its state. It can be changed by setting:
P9K_VI_MODE_NORMAL_ICON="my_icon"
P9K_VI_MODE_INSERT_ICON="my_icon"
P9K_VI_MODE_SEARCH_ICON="my_icon"
P9K_VI_MODE_VISUAL_ICON="my_icon"
The Icon color accordingly:
P9K_VI_MODE_NORMAL_ICON_COLOR="red"
P9K_VI_MODE_INSERT_ICON_COLOR="red"
P9K_VI_MODE_SEARCH_ICON_COLOR="red"
P9K_VI_MODE_VISUAL_ICON_COLOR="red"