Asistencia de contenido

La asistencia de contenido permite insertar o finalizar un código o función, o finalizar una línea de código en un editor de texto estructurado. La ubicación del cursor en el archivo de origen proporciona el contexto para que la asistencia de contenido proporcione sugerencias de finalización.

La mayoría de editores de texto estructurado tienen asistencia de contenido. Para obtener una lista de editores con asistencia de contenido, consulte Editores de texto estructurado para lenguajes de código. Para obtener información sobre cómo obtener asistencia de contenido, consulte Obtener asistencia de contenido en editores de texto estructurado

Las siguientes secciones describen aspectos específicos de la asistencia de contenido HTML, de JavaScript™ y de JSP.

Asistencia de contenido HTML

HTML es flexible ya que ciertos elementos HTML permiten opcionalmente omitir los códigos de finalización, como P, DT, DD, LI, THEAD, TR, TD, TH, etc. Otros elementos HTML definidos para no tener contenido pueden requerir que siempre se omitan sus códigos de finalización como BR, HR, LINK, META e IMG. Esta flexibilidad hace que la función de asistencia de contenido en el editor de páginas fuente sea menos precisa que lo que sería con un lenguaje de códigos con restricciones más rígidas.

La asistencia de contenido HTML resulta de mayor ayuda cuando necesita completar un nombre de contenido, añadir un par nombre-valor de atributo dentro de un código de inicio o seleccionar a partir de una lista de valores de atributos.

Aunque la asistencia de contenido sólo muestra nombres de atributo que no se han especificado todavía en un código de inicio, no tiene en cuenta las restricciones de gramática de los códigos. Por ejemplo, el elemento HEAD en HTML sólo permite cero o una aparición del código TITLE en su contenido. Si solicita la asistencia de contenido dentro de un contenido HEAD que ya contiene un código TITLE, la asistencia de contenido seguirá mostrando TITLE en su lista de propuestas.

No obstante, si un atributo es necesario de acuerdo con DTD/esquema, ese atributo aparecerá al principio de la lista, con un indicador de círculo amarillo en su icono.

Si el cursor está en una posición en la que la asistencia de contenido está disponible, se muestra una lista emergente de opciones disponibles. La lista depende del contexto. Por ejemplo, si utiliza la asistencia de contenido directamente después de un código de párrafo de apertura (<p>), el primer elemento en la lista de asistencia de contenido será el código de párrafo de cierre correspondiente (</p>).

La lista de asistencia de contenido muestra todos los códigos disponibles para la ubicación actual del cursor, incluidas las plantillas. La siguiente imagen muestra la lista de asistencia de contenido predeterminada de un ejemplo de código de párrafo:
Asistencia de contenido HTML

Las propuestas de código aparecen listadas alfabéticamente. Si escribe un < (para iniciar un nuevo código) antes de solicitar la asistencia de contenido y empieza a escribir la primera o las dos primeras letras del código que desea añadir, la lista de propuestas se renueva automáticamente para reflejar las propuestas que coinciden con el patrón que ha escrito. Si no escribe un < antes de solicitar la asistencia de contenido, puede pulsar en la lista de propuestas y escribir la letra por la que empieza el código, para reducir (parcialmente) la cantidad de desplazamiento necesario para localizar el código que desea.

Cuando escribe la primera o las dos primeras letras de los nombres de atributo o de los valores de atributo enumerados que desea añadir a un código, la lista se renueva automáticamente para reflejar las propuestas que coinciden con el patrón que ha escrito.

Restricción: Para Linux. Cuando utilice Linux (Motif o GTK) u un entorno local DBCS, pulsar dos veces sobre la lista de asistencia de contenido puede provocar a veces que la máquina virtual de Java™ finalice. En lugar de efectuar una doble pulsación en la lista, utilice las teclas de flecha y la tecla Intro para realizar la selección en la lista.

Asistencia de contenido JSP

Tiene muchas opciones para incorporar código Java y HTML en las páginas JSP utilizando asistencia de contenido.

Todos los códigos JSP se incluyen en la lista de plantillas y en formato XML (por ejemplo, <jsp:expresión>). Para añadir códigos de scriptlet JSP, por ejemplo, mueva el cursor a la posición correspondiente en el archivo y pulse Control+Espacio para utilizar la asistencia de contenido. Seleccione asistencia de contenido de scriptlet JSP en la lista de propuestas para insertar <% %> en el documento.

Los scriptlets se insertan en un código <% %>. Por ejemplo:
<% System.currentTimeMillis() %>

Este ejemplo evaluará la sentencia Java para obtener la hora actual en milisegundos.

Para que el resultado de la sentencia se inserte en el archivo, coloque un signo igual (=) delante de la sentencia. Por ejemplo:
<b>Esta es la hora : <%= System.currentTimeMillis()%></b>
Cuando está dentro de un scriptlet está escribiendo código Java puro. Por lo tanto, el asistente de contenido funciona exactamente igual que lo hace para el editor de Java. Por ejemplo, si solicita asistencia de contenido después de System, la asistencia de contenido muestra una lista de métodos.
Nota: la asistencia de contenido Java sólo funciona en un proyecto web ya que requiere una buildpath para encontrar las clases Java correspondientes.
Existen también códigos especiales como useBean. Por ejemplo:
<jsp:useBean id="useBean" class="java.lang.String"/>

El código useBean permite crear un bean llamado aString del tipo String. Posteriormente, cuando utilice la asistencia de contenido, se reconocerá como una variable declarada. Por ejemplo, si utiliza la asistencia de contenido después de aString, como se muestra a continuación:

<% aString. %> 
la lista de asistencia de contenido muestra métodos disponibles. Esto se debe a que aString ha sido declarado como un bean del tipo String.
Si utiliza la asistencia de contenido después de a, tal como se muestra a continuación:
<% a %> 
el asistente de contenido sabe que aString existe, y aparece en la lista del asistente de contenido.
Conceptos relacionados
Editores de texto estructurado para lenguajes de códigos
Tareas relacionadas
Obtener asistencia de contenido en editores de texto estructurado
Añadir o eliminar plantillas HTML