TextExpander logo TextExpander Smile logo
 

Help: Expanding Snippets

Expand immediately vs. using delimiters

Under TextExpander > Preferences > Expansion, you can set when TextExpander expands a snippet.

TextExpander can expand your snippets immediately when you type the abbreviations. Many users prefer this mode because it feels faster and more seamless. However, you need to choose abbreviations that would not appear in your normal typing. For example, "sig" is a poor abbreviation when using "Expand immediately", because your snippet will be expanded every time you want to type the word "sign" or "signal".

If you use delimiters, you have more flexibility with abbreviations. No expansion occurs until you press a delimiter key, indicating that you want the abbreviation to be expanded. For example, you could use "sig" to enter your signature if you were using delimiters. Your signature snippet would not be expanded until you pressed a specified delimiter after typing "sig".

By default, space, tab, return and esc keys are designated delimiters, but you can use any of a large group of characters as additional delimiters. Go to TextExpander > Preferences > Expansion and click on the Set Delimiters... to see all the choices.

Suggest matching abbreviations

If you have a large snippet library, or you have trouble remembering your abbreviations, you will find the abbreviation matching suggestions useful. To invoke this feature, you need to set a hotkey.

  1. Go to TextExpander > Preferences > Hotkeys.
  2. Click “Push to set Hotkey” next to Suggest Matching Abbreviations.
  3. Press a key combination that includes Command, Control, Option and/or Shift plus any letter or number to set your hotkey; e.g. Control + s.

Cuando quieres ampliar un fragmento de código, pero no logras recordar la abreviatura, simplemente escribe una parte de la abreviatura que recuerdes, o una parte de las palabras en el fragmento de código contenido o etiqueta, luego presiona la combinación de teclas especificada. Los fragmentos compatibles se mostrarán en una ventana desplegable justo debajo del cursor en donde se esté escribiendo, similar a la manera en que OS X muestra la auto-corrección o opciones de ortografía.

Al escribir más se afinará la búsqueda, actualizando continuamente los resultados. Si hay resultados de la búsqueda, puedes presionar la barra espaciadora y luego añadir otra palabra para restringir aún más la búsqueda. Si no se encuentra ningún resultado, escribiendo Space cancelará la búsqueda. Presiona la tecla Retorno para expandir el primer fragmento de código en los resultados, o usa las flechas en el teclado para mover de arriba a abajo en la lista de resultados, y presiona Retorno cuando el fragmento deseado es seleccionado para expandirlo. También puedes hacer clic en el fragmento deseado para expandirlo, o escribir Command+1 a través de las 9 teclas equivalentes mostradas al lado de los nueve primeros fragmentos de código compatibles.

El truco para recordar con Suggest Matching Abbreviation es escribir unas pocas letras al inicio, luego presionar la tecla de acceso directo para buscar lo que escribiste. Si expandes un fragmento de los resultados sugeridos, cualquier palabra que hayas escrito será borrada como si fuera la abreviatura.

For information on other hotkeys, see Preferences: Hotkeys.

Search Snippets

Another way to find snippets is to use Search Snippets. You can open the Search Snippets window by clicking on the TextExpander icon in the menu and then clicking Search Snippets. You can also set a hotkey for Search Snippets in TextExpander > Preferences > Hotkeys. (Note that the hotkey will work even if you do not have the TextExpander icon displayed in the menu bar.)

Type a few letters of the snippet's contents or of its abbreviation into the search field. The search results are updated as you type.

Click on a snippet to expand it, or press return or tab to jump to the list of search results, where you can use the arrow keys to move up and down in the list. Press return to expand the selected snippet.

For information on other hotkeys, see Preferences: Hotkeys.

Enable/Disable TextExpander

Occasionally, you might want to disable TextExpander temporarily, when you don't want your snippet expansions to occur. You can do this by clicking on the TextExpander icon in the menu and then clicking Disable Expansion. To enable TextExpander again, click again on the TextExpander menu bar icon and then click Enable Expansion.

You can also accomplish this easily by assigning a hotkey for Enable/Disable TextExpander.

  1. Go to TextExpander > Preferences > Hotkeys.
  2. Click Push to set Hotkey next to Enable/Disable TextExpander.
  3. Press a key combination that includes Command, Control, Option and/or Shift plus any letter or number to set your hotkey; e.g. Control + d.

TextExpander will remember your assigned hotkey combination. You can use it to toggle TextExpander on and off.

For information on other hotkeys, see Preferences: Hotkeys.

 

 

 
 
© 2006-2014 SmileOnMyMac, LLC, dba Smile. All rights reserved.
TextExpander is a registered trademark, Smile and the Smile logo are trademarks of SmileOnMyMac, LLC, dba Smile.