Cambiar idioma: English

Sugerencias de escritura

Las sugerencias de escritura proporcionan una función parecida a la encontrada en entornos de desarrollo integrados como Visual Studio o Eclipse para insertar términos y contenido dinámico. Las surencias en Sublime Text se ofrecen mediante la lista de sugerencias o presionando Tab.

Formato

Los archivos de sugerencias de escritura utilizan JSON y tienen la extensión .sublime-completions.

Estructura de una lista de sugerencias

scope
Determina si las sugerencias del archivo en cuestión serán importadas en el contexto actual. Ver Contextos para obtener más información.
completions
Matriz de sugerencias.

Veamos un ejemplo extraído del archivo de sugerencias para html:

{
   "scope": "text.html - source - meta.tag, punctuation.definition.tag.begin",

   "completions":
   [
      { "trigger": "a", "contents": "<a href=\"$1\">$0</a>" },
      { "trigger": "abbr", "contents": "<abbr>$0</abbr>" },
      { "trigger": "acronym", "contents": "<acronym>$0</acronym>" }

   ]
}

Tipos de sugerencias

Cadenas simples

Las cadenas simples son equivalentes a una entrada donde trigger es idéntico a contents:

"foo"

# es equivalente a:

{ "trigger": "foo", "contents": "foo" }

Sugerencias con combinación de teclas

trigger
Texto que se mostrará en la lista de sugerencias y que desencadenará la inserción de contents una vez validado.
contents
Texto que se insertará en el búfer. Puede contener funciones de las plantillas.

Fuentes de sugerencias

Estas son las fuentes de sugerencias que el usuario puede controlar:

  • archivos .sublime-completions;
  • EventListener.on_query_completions()

Además, las siguientes fuentes de sugerencias contribuyen elementos a la lista final:

  • plantillas;
  • contenido del búfer.

Prioridad de las fuentes de sugerencias

  • plantillas;
  • API;
  • archivos .sublime-completions;
  • contenido del búfer.

Las plantillas solo serán completadas automáticamente si el prefijo coincide exactamente con su combinación de teclas asignada. El resto de las sugerencias se filtra con una búsqueda parcial que no distingue entre mayúsculas y minúsculas.

Lista de sugerencias

Para usar la lista de sugerencias:

  • pulsa Ctrl+spacebar;
  • optativamente, pulsa Ctrl+spacebar otra vez para seleccionar la siguiente entrada;
  • pulsa Enter o Tab para validar la selección.

Note

El elemento seleccionado en la lista de sugerencias se puede validar con cualquier signo de puntuación que no esté asignado a una plantilla.

Las plantillas se muestran con el siguiente formato en la lista de sugerencias: <tab_trigger> : <name>. Para el resto de las sugerencias, solo se verá el texto para insertar.

Si se puede reducir la lista de sugerencias a un solo elemento, se omitirá la lista de sugerencias y el contenido correspondiente será insertado automáticamente de acuerdo con las reglas de prioridad mencionadas antes.

Uso de Tab para insertar sugerencias

La opción tab_completion está configurada en true por omisión. Cámbiala a false si prefieres que Tab deje de insertar la mejor sugerencia. Esta opción no afecta a las combinaciones de teclas de las plantillas: las plantillas siempre serán insertadas si se pulsa Tab tras su combinación de teclas.

Si tab_completions está activada, se aplica el mismo orden de preferencia explicado antes, pero, a diferencia de la lista de sugerencias, Sublime Text siempre insertará una sugerencia, incluso en caso de ambigüedad.

Inserción de un carácter tabulador literal

Con tab_completion en true, se puede pulsar Shift+Tab tras cualquier prefijo para insertar un carácter tabulador literal.