Bloc

Traduction Bêta Non Officielle

Cette page a été traduite par PageTurner AI (bêta). Non approuvée officiellement par le projet. Vous avez trouvé une erreur ? Signaler un problème →

Examinons en détail ce qui définit un bloc.

json

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

yaml

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

toml

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

Paramètres

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

Indique au moteur comment traiter le bloc. Deux options sont disponibles :

• prompt affiche un ou plusieurs segments

• rprompt affiche un ou plusieurs segments alignés à droite du curseur. Un seul bloc rprompt est autorisé. Pris en charge sur bash (avec ble.sh), zsh, PowerShell, cmd, nu et fish.

Nouvelle ligne

Démarre le bloc sur une nouvelle ligne - par défaut false. Pour pwsh et cmd, cela n'imprimera pas de saut de ligne défini sur le premier bloc lorsque l'invite est sur la première ligne (après un clear), ou au démarrage de la session shell (1ère invite). Pour activer le même comportement sur bash et zsh, définissez enable_cursor_positioning sur true. Cela peut avoir l'effet secondaire d'absorber les commandes tapées pendant le chargement de l'invite, ou durant l'exécution d'une commande en cours. C'est une limitation du shell, non d'Oh My Posh.

Alignement

• left

• right

Indique au moteur si le bloc doit être aligné à gauche ou à droite.

Remplissage

Pour joindre un bloc aligné à gauche et un bloc aligné à droite avec des caractères répétés, ajoutez le(s) caractère(s) à répéter à cette propriété. Ajoutez cette propriété au bloc aligné à droite. Prend en charge les remplacements de couleur.

json

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

yaml

blocks:
  - alignment: right
    filler: .

toml

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

Le remplissage permet de spécifier un modèle pour ajuster le texte utilisé. Ce modèle se comporte comme les modèles de segments, mais avec moins de propriétés disponibles.

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

Cela peut être très utile pour utiliser un texte de remplissage lorsqu'il n'y a pas de débordement, et un espace vide lorsque le bloc droit est masqué ou affiché sur une nouvelle ligne à cause d'un débordement.

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 }}"

Débordement

• break

• hide

Lorsque le bloc aligné à droite est trop long et déborde sur le bloc gauche, le moteur va soit casser le bloc soit le masquer selon le paramètre. Par défaut, il est imprimé tel quel sur la même ligne.

Losange initial

Caractère à utiliser comme losange initial pour le premier segment, si vous souhaitez toujours démarrer le bloc avec le même losange, quel que soit le segment activé.

Losange final

Caractère à utiliser comme losange final pour le dernier segment, si vous souhaitez toujours terminer le bloc avec le même losange, quel que soit le segment activé.

Segments

Tableau d'un ou plusieurs segments.

Forcer

Lorsque défini sur true, le bloc sera toujours affiché, même si tous les segments sont vides. Par défaut false.

Index

Position du bloc dans la configuration. Utilisé pour [surcharger] un bloc spécifique dans une configuration de base. L'indexation commence à 1, donc le premier bloc a l'index 1.