Bloque

Traducción Beta No Oficial

Esta página fue traducida por PageTurner AI (beta). No está respaldada oficialmente por el proyecto. ¿Encontraste un error? Reportar problema →

Profundicemos en lo que define un bloque.

json

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

yaml

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

toml

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

Configuraciones

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

Tipo

Indica al motor qué hacer con el bloque. Hay dos opciones:

• prompt: renderiza uno o más segmentos

• rprompt: renderiza uno o más segmentos alineados a la derecha del cursor. Solo se permite un bloque rprompt. Compatible con bash (usando ble.sh), zsh, PowerShell, cmd, nu y fish.

Nueva línea

Inicia el bloque en una nueva línea - por defecto false. Para pwsh y cmd esto no imprimirá una nueva línea definida en el primer bloque cuando el prompt está en la primera línea (al usar clear), o cuando inicia la sesión de shell (1er prompt). Para habilitar este comportamiento en bash y zsh, establece enable_cursor_positioning en true. Esto puede tener el efecto secundario de "tragar" comandos que escribas mientras carga el prompt, o durante la ejecución del comando actual. Esta es una limitación del shell, no de Oh My Posh.

Alineación

• left (izquierda)

• right (derecha)

Indica al motor si el bloque debe alinearse a la izquierda o derecha.

Relleno

Para unir bloques alineados a izquierda y derecha con caracteres repetidos, añade los caracteres a repetir en esta propiedad. Agrega esta propiedad al bloque alineado a la derecha. Soporta el uso de sobreescrituras de color.

json

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

yaml

blocks:
  - alignment: right
    filler: .

toml

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

El relleno permite especificar una plantilla para ajustar el texto usado. Esta plantilla se comporta igual que las plantillas de segmentos, pero con menos propiedades 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

Es útil si deseas usar texto de relleno cuando no hay desbordamiento, y espacio vacío cuando el bloque derecho está oculto o en nueva línea por desbordamiento.

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

Desbordamiento

• break (romper)

• hide (ocultar)

Cuando el bloque alineado a la derecha es tan largo que desborda al izquierdo, el motor romperá el bloque u lo ocultará según esta configuración. Por defecto se imprime en la misma línea.

Diamante inicial

Carácter usado como diamante inicial en el primer segmento, para mantener siempre el mismo diamante de inicio, independientemente de qué segmentos estén activos.

Diamante final

Carácter usado como diamante final en el último segmento, para mantener siempre el mismo diamante de cierre, independientemente de qué segmentos estén activos.

Segmentos

Arreglo de uno o más segmentos.

Forzar

Si es true, el bloque siempre se renderizará aunque todos los segmentos estén vacíos. Por defecto false.

Índice

Posición del bloque en la configuración. Se usa para sobreescribir bloques específicos en configuraciones base. Es un índice basado en 1 (el primer bloque es 1).