mirror of
https://github.com/JanDeDobbeleer/oh-my-posh.git
synced 2024-11-10 04:54:03 -08:00
3ff30f993e
Instead of rendering only the last tooltip that matches a given tip it will now render all tooltips that trigger for that tip.
75 lines
2.5 KiB
Plaintext
75 lines
2.5 KiB
Plaintext
---
|
|
id: tooltips
|
|
title: Tooltips
|
|
sidebar_label: Tooltips
|
|
---
|
|
|
|
:::info
|
|
Due to limitations (or not having found a way just yet), this feature only works in `fish`, `zsh`, `powershell`
|
|
(`ConstrainedLanguage` mode unsupported) and `cmd` (as of [Clink][clink] v1.2.46+) for the time being.
|
|
:::
|
|
|
|
|
|
|
|
Tooltips are segments that are rendered as a right-aligned prompt while you're typing certain keywords.
|
|
They behave similarly to the other segments when it comes to how and when they are shown so you can tweak
|
|
them to act and look like you want. The key difference is that they can be invoked using `tips` which are the
|
|
commands you are typing. Due to the possibility of the use of an alias, you can define for which keyword
|
|
the segment should be rendered.
|
|
|
|
### Configuration
|
|
|
|
You need to extend or create a custom theme with your tooltips. For example:
|
|
|
|
import Config from '@site/src/components/Config.js';
|
|
|
|
<Config data={{
|
|
"blocks": [],
|
|
"tooltips": [
|
|
{
|
|
"type": "git",
|
|
"tips": ["git", "g"],
|
|
"style": "diamond",
|
|
"foreground": "#193549",
|
|
"background": "#fffb38",
|
|
"leading_diamond": "\ue0b6",
|
|
"trailing_diamond": "\ue0b4",
|
|
"template": "{{ .HEAD }}{{ if .Staging.Changed }} \uF046 {{ .Staging.String }}{{ end }}{{ if and (.Working.Changed) (.Staging.Changed) }} |{{ end }}{{ if .Working.Changed }} \uF044 {{ .Working.String }}{{ end }}",
|
|
"properties": {
|
|
"fetch_status": true,
|
|
"fetch_upstream_icon": true
|
|
}
|
|
}
|
|
]
|
|
}}/>
|
|
|
|
This configuration will render a right-aligned git segment when you type `git` or `g` followed by a space.
|
|
A tip should not include any spaces. Keep in mind that this is a blocking call, meaning that if the segment renders slow,
|
|
you can't type until it's visible. Optimizations in this space are being explored.
|
|
|
|
Note that you can also define multiple tooltips for the same tip to compose tooltips for individual commands. For example,
|
|
this configuration will render the AWS profile as well as the Azure subscription information when you type `terraform`
|
|
followed by a space.
|
|
|
|
<Config data={{
|
|
"blocks": [],
|
|
"tooltips": [
|
|
{
|
|
"type": "aws",
|
|
"tips": ["aws", "terraform"],
|
|
"style": "plain",
|
|
"foreground": "#e0af68",
|
|
"template": "\uf0e0f {{.Profile}}{{if .Region}}@{{.Region}}{{end}}"
|
|
},
|
|
{
|
|
"type": "az",
|
|
"tips": ["az", "terraform"],
|
|
"style": "plain",
|
|
"foreground": "#b4f9f8",
|
|
"template": "\uebd8 {{ .Name }}"
|
|
}
|
|
]
|
|
}}/>
|
|
|
|
[clink]: https://chrisant996.github.io/clink/
|