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.
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:
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.
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 ()
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:
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.
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
en la lista de propuestas para insertar
<% %> en el
documento.
<% System.currentTimeMillis() %>
Este ejemplo evaluará la sentencia Java para obtener la hora actual en milisegundos.
<b>Esta es la hora : <%= System.currentTimeMillis()%></b>
<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.
<% a %>la ayuda de contenido sabe que existe aString, y lo muestra en la lista de ayuda de contenido.