Blok

Onofficiële Beta-vertaling

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

Laten we eens dieper ingaan op wat een blok definieert.

json

{
  "blocks": [
    {
      "type": "prompt",
      "alignment": "left",
      "segments": []
    }
  ]
}

yaml

blocks:
  - type: prompt
    alignment: left
    segments: []

toml

[[blocks]]
type = "prompt"
alignment = "left"
segments = []

Instellingen

Name	Type
type	string
newline	boolean
alignment	string
filler	string
overflow	string
leading_diamond	string
trailing_diamond	string
segments	array
force	boolean
index	int

Type

Geeft aan wat de engine met het blok moet doen. Er zijn twee opties:

• prompt rendert een of meer segmenten

• rprompt rendert een of meer segmenten rechts van de cursor uitgelijnd. Slechts één rprompt-blok is toegestaan. Ondersteund in bash (met ble.sh), zsh, PowerShell, cmd, nu en fish.

Nieuwe regel

Start het blok op een nieuwe regel - standaard false. Voor pwsh en cmd wordt geen nieuwe regel afgedrukt wanneer deze op het eerste blok is gedefinieerd en de prompt op de eerste regel staat (bij gebruik van clear), of wanneer de shellsessie start (1e prompt). Voor hetzelfde gedrag in bash en zsh, stel enable_cursor_positioning in op true. Dit kan als bijwerking hebben dat commando's die je typt tijdens het laden van de prompt, of tijdens een lopend commando, worden "opgeslokt". Dit is een beperking van de shell, niet van Oh My Posh.

Uitlijning

• left

• right

Geeft aan of het blok links of rechts moet worden uitgelijnd.

Opvulling

Om een rechts- en links uitgelijnd blok te verbinden met herhaalde tekens, voeg je de te herhalen karakter(s) toe aan deze eigenschap. Voeg deze eigenschap toe aan het rechts uitgelijnde blok. Ondersteunt het gebruik van kleuroverschrijvingen.

json

{
  "blocks": [
    {
      "alignment": "right",
      "filler": "."
    }
  ]
}

yaml

blocks:
  - alignment: right
    filler: .

toml

[[blocks]]
alignment = "right"
filler = "."

Met opvulling kun je een sjabloon specificeren om de gebruikte opvultekst aan te passen. Dit sjabloon gedraagt zich hetzelfde als segmentsjablonen, maar er zijn minder eigenschappen beschikbaar.

Name	Type	Description
.Overflow	text	if no overflow was needed, this is empty. Otherwise hide or break
.Padding	int	the computed length of the padding between left and right blocks

Handig als je opvultekst wilt gebruiken wanneer er geen overloop is, en lege ruimte wanneer het rechterblok verborgen is of op een nieuwe regel wordt getekend door overloop.

json

{
  "blocks": [
    {
      "alignment": "right",
      "overflow": "hide",
      "filler": "{{ if .Overflow }} {{ else }}-{{ end }}"
    }
  ]
}

yaml

blocks:
  - alignment: right
    overflow: hide
    filler: "{{ if .Overflow }} {{ else }}-{{ end }}"

toml

[[blocks]]
alignment = "right"
overflow = "hide"
filler = "{{ if .Overflow }} {{ else }}-{{ end }}"

Overloop

• break

• hide

Wanneer een rechts uitgelijnd blok te lang wordt en overloopt op het links uitgelijnde blok, zal de engine het blok óf afbreken óf verbergen op basis van deze instelling. Standaard wordt het ongewijzigd op dezelfde regel afgedrukt.

Voorafgaand diamantteken

Het teken dat als voorafgaand diamantteken moet dienen voor het eerste segment, voor een consistent begin van het blok, ongeacht welk segment is ingeschakeld.

Afsluitend diamantteken

Het teken dat als afsluitend diamantteken moet dienen voor het laatste segment, voor een consistent einde van het blok, ongeacht welk segment is ingeschakeld.

Segmenten

Array van een of meer segmenten.

Forceren

Indien ingesteld op true, wordt het blok altijd weergegeven, zelfs als alle segmenten leeg zijn. Standaard false.

Index

De positie van het blok in de configuratie. Gebruikt om een specifiek blok in een basisconfiguratie te overschrijven. Dit is een 1-gebaseerde index, dus het eerste blok heeft index 1.