Tooltips

Onofficiële Beta-vertaling

Deze pagina is vertaald door PageTurner AI (beta). Niet officieel goedgekeurd door het project. Een fout gevonden? Probleem melden →

informatie

Vanwege huidige beperkingen (of omdat we nog geen manier hebben gevonden) werkt deze functie momenteel alleen in fish, zsh, powershell (ConstrainedLanguage-modus wordt niet ondersteund) en cmd (vanaf Clink v1.2.46+).

Tooltips zijn segmenten die rechts uitgelijnd worden weergegeven terwijl je bepaalde trefwoorden intypt. Ze gedragen zich vergelijkbaar met andere segmenten qua weergave en timing, zodat je ze kunt aanpassen naar wens. Het belangrijkste verschil is dat je ze kunt activeren via tips - dit zijn de commando's die je aan het typen bent. Omdat aliassen kunnen worden gebruikt, kun je precies instellen voor welk trefwoord het segment moet verschijnen.

Configuratie

Je moet een aangepast thema maken of uitbreiden met je tooltips. Bijvoorbeeld:

json

{
  "blocks": [],
  "tooltips_action": "replace",
  "tooltips": [
    {
      "type": "git",
      "tips": [
        "git",
        "g"
      ],
      "style": "diamond",
      "foreground": "#193549",
      "background": "#fffb38",
      "leading_diamond": "",
      "trailing_diamond": "",
      "template": "{{ .HEAD }}{{ if .Staging.Changed }}  {{ .Staging.String }}{{ end }}{{ if and (.Working.Changed) (.Staging.Changed) }} |{{ end }}{{ if .Working.Changed }}  {{ .Working.String }}{{ end }}",
      "options": {
        "fetch_status": true,
        "fetch_upstream_icon": true
      }
    }
  ]
}

yaml

blocks: []
tooltips_action: replace
tooltips:
  - type: git
    tips:
      - git
      - g
    style: diamond
    foreground: "#193549"
    background: "#fffb38"
    leading_diamond: 
    trailing_diamond: 
    template: "{{ .HEAD }}{{ if .Staging.Changed }}  {{ .Staging.String }}{{ end
      }}{{ if and (.Working.Changed) (.Staging.Changed) }} |{{ end }}{{ if
      .Working.Changed }}  {{ .Working.String }}{{ end }}"
    options:
      fetch_status: true
      fetch_upstream_icon: true

toml

blocks = []
tooltips_action = "replace"

[[tooltips]]
type = "git"
tips = [ "git", "g" ]
style = "diamond"
foreground = "#193549"
background = "#fffb38"
leading_diamond = ""
trailing_diamond = ""
template = "{{ .HEAD }}{{ if .Staging.Changed }}  {{ .Staging.String }}{{ end }}{{ if and (.Working.Changed) (.Staging.Changed) }} |{{ end }}{{ if .Working.Changed }}  {{ .Working.String }}{{ end }}"

[tooltips.options]
fetch_status = true
fetch_upstream_icon = true

Deze configuratie toont een rechts uitgelijnd git-segment wanneer je git of g intypt gevolgd door een spatie. Een tip mag geen spaties bevatten. Houd er rekening mee dat dit een blokkerende aanroep is: als het segment traag wordt weergegeven, kun je niet verder typen totdat het zichtbaar is. Optimalisaties hiervoor worden onderzocht.

Je kunt meerdere tooltips voor dezelfde tip definiëren om informatie te combineren. Zo toont deze configuratie zowel het AWS-profiel als Azure-abonnementsinformatie wanneer je terraform typt gevolgd door een spatie.

json

{
  "blocks": [],
  "tooltips": [
    {
      "type": "aws",
      "tips": [
        "aws",
        "terraform"
      ],
      "style": "plain",
      "foreground": "#e0af68",
      "template": "f {{.Profile}}{{if .Region}}@{{.Region}}{{end}}"
    },
    {
      "type": "az",
      "tips": [
        "az",
        "terraform"
      ],
      "style": "plain",
      "foreground": "#b4f9f8",
      "template": " {{ .Name }}"
    }
  ]
}

yaml

blocks: []
tooltips:
  - type: aws
    tips:
      - aws
      - terraform
    style: plain
    foreground: "#e0af68"
    template: f {{.Profile}}{{if .Region}}@{{.Region}}{{end}}
  - type: az
    tips:
      - az
      - terraform
    style: plain
    foreground: "#b4f9f8"
    template:  {{ .Name }}

toml

blocks = []

[[tooltips]]
type = "aws"
tips = [ "aws", "terraform" ]
style = "plain"
foreground = "#e0af68"
template = "f {{.Profile}}{{if .Region}}@{{.Region}}{{end}}"

[[tooltips]]
type = "az"
tips = [ "az", "terraform" ]
style = "plain"
foreground = "#b4f9f8"
template = " {{ .Name }}"

Tooltips-actie

Je kunt instellen of tooltips worden toegevoegd aan de huidige rprompt of deze vervangen (standaardgedrag). Dit regel je via de tooltips_action eigenschap in je configuratie. Mogelijke waarden zijn:

• replace: Vervangt de huidige rprompt door de tooltips (standaardinstelling).

• extend: Voegt de tooltips toe aan de huidige rprompt.

• prepend: Plaatst de tooltips vóór de huidige rprompt.

Je stelt deze eigenschap als volgt in in je configuratie:

json

{
  "blocks": [],
  "tooltips_action": "extend",
  "tooltips": []
}

yaml

blocks: []
tooltips_action: extend
tooltips: []

toml

blocks = []
tooltips_action = "extend"
tooltips = []