Ayuda de contenido

La ayuda 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 ayuda de contenido proporcione sugerencias de finalización.

La mayoría de editores de texto estructurado tienen ayuda de contenido. Para ver una lista de los editores que tienen ayuda de contenido, consulte Editores de texto estructurado para lenguajes de códigos. Puede encontrar más información sobre cómo obtener ayuda de contenido en Obtener ayuda de contenido en editores de texto estructurado

En los siguientes apartados se describen los detalles de la ayuda de contenido HTML, la ayuda de contenido JavaScript y la ayuda de contenido JSP.

Ayuda de contenido HTML

HTML es flexible, ya que algunos elementos HTML permiten omitir de manera opcional códigos finales como, por ejemplo, P, DT, DD, LI, THEAD, TR, TD, TH, etc. Otros elementos HTML que están definidos para no tener contenido pueden necesitar que se omita siempre el código final como, por ejemplo, BR, HR, LINK, META y IMG. Esta flexibilidad hace que la función de ayuda de contenido del editor de páginas fuente HTML sea menos precisa de lo que sería con un lenguaje de códigos más restringido.

La ayuda de contenido HTML ofrece muchas ventajas cuando tiene que finalizar un nombre de código, añadir un par de nombre-valor de atributo en un código de inicio o realizar una selección en una lista enumerada de valores de atributo.

Aunque la ayuda 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 una o cero apariciones de un código TITLE en el contenido. Si solicita la ayuda de contenido en un contenido HEAD que ya contiene un código TITLE, la ayuda de contenido mostrará TITLE en la 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 ubicación donde la ayuda de contenido está disponible, aparece una lista emergente de opciones disponibles. La lista depende del contexto. Por ejemplo, si utiliza la ayuda de contenido directamente después de un código de abertura de párrafo (<p>), el primer elemento de la lista de ayuda de contenido será el código de cierre de párrafo (</p>) correspondiente.

La lista de ayuda 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 ayuda de contenido por omisión de un ejemplo de código de párrafo:

Ayuda de contenido HTML

Las propuestas de código se ordenan alfabéticamente. Si escribe un < (para iniciar un nuevo código) antes de solicitar la ayuda 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 ayuda 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 se utiliza Linux (Motif o GTK) y un entorno local DBCS, una doble pulsación en la lista de ayuda de contenido puede hacer que la Java VM termine. 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.

Ayuda de contenido JavaScript

Los elementos de la lista de ayuda de contenido JavaScript están precedidos por un icono de Internet Explorer, un icono de Netscape, o ambos, para indicar si los objetos, métodos o funciones de JavaScript específicos están soportados por uno o los dos navegadores. Si aparece el icono de Internet Explorer, el objeto, método o función está soportado por Internet Explorer Versión 5.0 o superior. Si aparece el icono de Netscape, el objeto, método o función está soportado por Netscape Navigator Versión 4.7 o superior. Un icono de interrogante (Icono de interrogante) en lugar de uno de los iconos de navegador indica que no se sabe si el navegador da soporte al objeto, el método o la función.

La siguiente imagen muestra la lista de ayuda de contenido por omisión dentro de un archivo JavaScript:

Ayuda de contenido JavaScript

Las propuestas de código se ordenan alfabéticamente. Si escribe un . (incluir el espacio) antes de solicitar la ayuda 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, para reducir (parcialmente) la cantidad de desplazamiento necesario para localizar el código que desea.

Ayuda de contenido JSP

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

Todos los códigos JSP están incluidos en la lista de plantilla y en formato XML (por ejemplo, <jsp:expression>). 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 ayuda de contenido. Seleccione Ayuda 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 se encuentra en un scriptlet, escribe código Java puro. Por lo tanto, la ayuda de contenido funciona exactamente de la misma forma que para el editor Java. Por ejemplo, si solicita la ayuda de contenido después de System, la ayuda de contenido muestra una lista de métodos.
Nota: La ayuda de contenido Java sólo funciona en un proyecto Web, ya que requiere una vía de acceso de creación para encontrar las clases Java adecuadas.
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 denominado aString del tipo String. Posteriormente, cuando utilice la ayuda de contenido, se reconocerá como una variable declarada. Por ejemplo, si utiliza la ayuda de contenido después de aString, como se indica a continuación:

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