Nota: Este documento es parte de una traducción al castellano de la Recomendación del W3C "HTML 4.01 Specification" (más información). Puede consultar laversión original del mismo. Para cualquier comentario o corrección acerca de la traducción póngase en contacto con el traductor en jrpozoarroba conclase punto net. Gracias por su colaboración.
Véase elAviso de copyright de la traducción.
Contenidos
Los scripts ofrecen a los autores la posibilidad de extender losdocumentos HTML de maneras activas e interactivas. Por ejemplo:
Hay dos tipos de scripts que los autores pueden asociar a un documentoHTML:
Nota. Esta especificación incluye información más detalladasobre scripts en la sección sobremacros de scripts.
Las siguientes secciones tratan sobre cuestiones que afectan a los agentesde usuario que soportan scripts.
<!ELEMENTSCRIPT - -%Script; -- sentencias de script --><!ATTLIST SCRIPTcharset%Charset; #IMPLIED -- codif. de caracteres del recurso vinculado--type%ContentType; #REQUIRED -- tipo de contenido del lenguaje de scripts --src%URI; #IMPLIED -- URI del script externo --defer (defer) #IMPLIED -- El AU puede retrasar la ejecución -- >
Etiqueta inicial:obligatoria, Etiqueta final:obligatoria
Definiciones de atributos
Atributos definidos en otros lugares
El elementoSCRIPT coloca un script dentro de un documento. Este elemento puedeaparecer cualquier número de veces en elHEAD o en elBODY de un documento HTML.
El script puede estar definido dentro de los contenidos del elementoSCRIPT o en un fichero externo. Si el atributosrcno está establecido, los agentes de usuario deben interpretar que los contenidosdel elemento son el script. Sisrc tiene un valor URI, los agentes de usuario no deben teneren cuenta los contenidos del elemento y deben obtener el script mediante el URI.Obsérvese que el atributocharset se refiere a lacodificación decaracteres del script designado por el atributosrc; no afecta alcontenido del elementoSCRIPT.
Los scripts son evaluados pormotores de scripts, con los cualesdeben poder comunicarse los agentes de usuario.
Lasintaxis de los datos de scripts dependedel lenguaje de scripts.
Al no estar ligado el HTML a un lenguaje de scripts específico, losautores de los documentos deben decir explícitamente a los agentes de usuarioel lenguaje de cada script. Esto puede hacerse o bien mediante una declaraciónpor defecto o bien mediante una declaración local.
Los autores deberían especificar el lenguaje de scripts por defectode todos los scripts de un documento incluyendo la siguiente declaraciónMETA en elHEAD:
<META http-equiv="Content-Script-Type" content="type">
donde "type" es untipo de contenidoque se refiere al lenguaje de scripts. Como ejemplos de este valor tenemos "text/tcl","text/javascript", "text/vbscript".
En ausencia de una declaraciónMETA, el valor por defecto puede ser establecido con unencabezado HTTP "Content-Script-Type".
Content-Script-Type: type
donde "type" es nuevamente untipode contenido que se refiere al lenguaje de scripts.
Los agentes de usuario deberían determinar el lenguaje de scriptspor defecto de un documento de acuerdo con los siguiente pasos (ordenadosde prioridad más alta a más baja):
Los documentos que no especifiquen información relativa al lenguaje descripts por defecto y que contengan elementos que especifiquen un scriptdeevento intrínseco son incorrectos. Los agentes de usuarioaún pueden intentar interpretar scripts especificados incorrectamente, pero nose requiere que lo hagan. Las herramientas de creación deberían generar informaciónsobre el lenguaje de scripts por defecto para ayudar a que los autores evitenla creación de documentos incorrectos.
Se debe especificar el atributotypede todos los elementosSCRIPT de un documento. El valor del atributotype de un elementoSCRIPT prevalece sobre el languajede scripts por defecto de ese elemento.
En este ejemplo, declaramos que el lenguaje de scripts por defecto es"text/tcl". Incluimos unSCRIPT en la cabecera, cuyo script se localiza en un ficheroexterno y que está en el lenguaje de scripts "text/vbscript". También incluimosunSCRIPT en el cuerpo, que contiene su propioscript escrito en "text/javascript".
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"><HTML><HEAD><TITLE>Un documento con SCRIPT</TITLE><META http-equiv="Content-Script-Type" content="text/tcl"><SCRIPT type="text/vbscript" src="http://algunsitio.com/progs/vbcalc"></SCRIPT></HEAD><BODY><SCRIPT type="text/javascript">...algo en JavaScript...</SCRIPT></BODY></HTML>
Cada lenguaje de scripts tiene sus propias convenciones para referirsea objetos HTML desde dentro del script. Esta especificación no defineun mecanismo estándar para referirse a objetos HTML.
Sin embargo, los scripts deberían hacer referencia a un elementode acuerdo con su nombre asignado. Los motores de scripts deberían seguirlas siguientes reglas de precedencia cuando identifiquen un elemento:un atributoname prevalece sobre un atributoid si ambos están establecidos. En caso contrario, se puede usaruno u otro.
Nota. Se avisa a los autores de documentos HTML quese espera que haya cambios en el ámbito de los eventos intrínsecos (p.ej.,cómo se ligan los scripts a los eventos). La investigación en este campo estásiendo llevada a cabo por miembros del Grupo de Trabajo del Modelo de Objetosdel Documento del W3C (ver el sitio web del W3C enhttp://www.w3.org/ para más información).
Definiciones de atributos
Es posible asociar una acción con un cierto número de eventos queocurren cuando un usuario interacciona con un agente de usuario. Cada unode los "eventos intrínsecos" recién enumerados toma como valor un script.El script se ejecuta cada vez que el evento ocurre para ese elemento. Lasintaxis de los datos del scriptdepende del lenguaje de scripts.
Los elementos de control tales comoINPUT,SELECT,BUTTON,TEXTAREA y
Por ejemplo, los autores pueden querer incluir botones en sus documentosque no envíen un formulario pero que puedan comunicarse con un servidor cuandoson activados.
Los siguientes ejemplos muestran posibles comportamientos de controlese interfaces de usuario basados en eventos intrínsecos.
En el siguiente ejemplo,nombreUsuario es un campo de texto obligatorio.Cuando un usuario intenta abandonar el campo, el eventoonblurllama a una función JavaScript para confirmar que nombreUsuario tiene unvalor aceptable.
<INPUT NAME="nombreUsuario" onblur="validarNombreUsuario(this.value)">
Aquí tenemos otro ejemplo en #"num" onchange="if (!checkNum(this.value, 1, 10)) {this.focus();this.select();} else {thanks()}" VALUE="0">
Aquí tenemos un ejemplo en VBScript de un manejador de eventospara un campo de texto:
<INPUT name="edit1" size="50"> <SCRIPT type="text/vbscript"> Sub edit1_cambiado() If edit1.value = "abc" Then button1.enabled = True Else button1.enabled = False End If End Sub </SCRIPT>
Aquí tenemos el mismo ejemplo usando Tcl:
<INPUT name="edit1" size="50"> <SCRIPT type="text/tcl"> proc edit1_cambiado {} { if {[edit value] == abc} { button1 enable 1 } else { button1 enable 0 } } edit1 onChange edit1_cambiado </SCRIPT>Aquí tenemos un ejemplo en JavaScript que asocia un evento con un script.En primer lugar vemos un manejador sencillo de clics:
<BUTTON type="button" name="miboton" value="10"><SCRIPT type="text/javascript"> function mi_onclick() { . . . } document.form.miboton.onclick = mi_onclick </SCRIPT> </BUTTON>Aquí tenemos un manejador de ventanas más interesante:
<SCRIPT type="text/javascript"> function mi_onload() { . . . } var ventana = window.open("algun/otro/URI") if (ventana) ventana.onload = mi_onload</SCRIPT>En Tcl esto sería algo así:
<SCRIPT type="text/tcl"> proc mi_onload {} { . . . } set ventana [window open "algun/otro/URI"] if {$ventana != ""} { $ventana onload mi_onload } </SCRIPT>Obsérvese que un "document.write" o sus sentencias equivalentesen un manejador de eventos intrínsecos lo que hacen es crear un nuevodocumento y escribir en él, no modificar el documento actual.
Los scripts que se ejecutan cuando un documento es cargado pueden modificarlos contenidos del documento dinámicamente. La capacidad de hacer esto dependedel lenguaje de scripts en sí (p.ej., la sentencia "document.write" en elmodelo de objetos de HTML no está soportada por algunas marcas).
La modificación dinámica de un documento puede ser modelizada de lasiguiente manera:
Los documentos HTML deben ser conformes con el DTD del HTML tanto antes comodespués del procesamiento de cualquiera de los elementosSCRIPT.
El ejemplo siguiente ilustra cómo puede un script modificarun documento dinámicamente. El siguiente script:
<TITLE>Documento de prueba</TITLE> <SCRIPT type="text/javascript"> document.write("<p><b>¡Hola Mundo!<\/b>") </SCRIPT>tiene el mismo efecto que este código HTML:
<TITLE>Documento de prueba</TITLE> <P><B>¡Hola Mundo!</B>
Las siguientes secciones tratan sobre cómo pueden los autores creardocumentos que funcionen para agentes de usuario que no soporten scripts.
<!ELEMENTNOSCRIPT - - (%block;)+ -- contenedor de contenido alternativo para representación no basada en scripts --><!ATTLIST NOSCRIPT%attrs; --%coreattrs,%i18n,%events -- >
Etiqueta inicial:obligatoria, Etiqueta final:obligatoria
El elementoNOSCRIPT permite a los autores proporcionar contenido alternativo cuandoun script no es ejecutado. El contenido de un elementoNOSCRIPT sólo debería serrepresentado por un agente de usuario capaz de reconocer scripts en los casossiguientes:Los agentes de usuario que no soporten scripts en el lado del cliente debenrepresentar los contenidos de este elemento.
En el ejemplo siguiente, un agente de usuario que ejecute elSCRIPTincluirá en el documento algunos datos creados dinámicamente. Si el agentede usuario no soporta scripts, el usuario aún podrá obtener los datospor medio de un vínculo.
<SCRIPT type="text/tcl">...scripts Tcl para insertar datos...</SCRIPT><NOSCRIPT> <P>Acceder a los <A href="http://algunsitio.com/datos">datos.</A></NOSCRIPT>
Es probable que los agentes de usuario que no reconozcan el elementoSCRIPTrepresenten los contenidos del elemento como texto. Algunos motores de scripts,incluyendo los de los lenguajes JavaScript, VBScript y Tcl, permiten que lassentencias de los scripts estén contenidas en un comentario SGML. Los agentesde usuario que no reconozcan el elementoSCRIPTignorarán así el comentario, mientras que los motores de scripts quefuncionen correctamente entenderán que los scripts de los comentarios deberíanser ejecutados.
Otra solución al problema es mantener los scripts en documentos externosy hacer referencia a ellos con el atributo
Comentando scripts en Javascript
El motor de JavaScript permite que aparezca la cadena "<!--" al principiodel elemento SCRIPT, e ignora el resto de los caracteres hasta el final dela línea. JavaScript interpreta "//" como el inicio de un comentario quese extiende hasta el final de la línea actual. Esta cadena es necesaria paraocultar la cadena "-->" al analizador JavaScript.
<SCRIPT type="text/javascript"><!-- para ocultar los contenidos del script a los navegadores viejos function cuadrado(i) { document.write("La llamada pasó ", i ," a la función.","<BR>") return i * i } document.write("La función devolvió ",cuadrado(5),".")// dejar de ocultar contenidos a los navegadores viejos --></SCRIPT>Comentando scripts en VBScript
En VBScript, un carácter de comilla simple hace que el resto de la línea actualsea tratada como un comentario. Puede usarse por tanto para ocultar a VBScriptla cadena "-->", por ejemplo:
<SCRIPT type="text/vbscript"> <!-- Sub blabla() ... End Sub ' --> </SCRIPT>
Comentando scripts en TCL
En Tcl, el carácter "#" comenta el resto de la línea:
<SCRIPT type="text/tcl"><!-- para ocultar los contenidos del script a los navegadores viejos proc cuadrado {i} { document write "La llamada pasó $i a la función.<BR>" return [expr $i * $i] } document write "La función devolvió [cuadrado 5]."# dejar de ocultar los contenidos a los navegadores viejos --></SCRIPT>Nota. Algunos navegadores cierran los comentarios alencontrar el primer carácter ">", de modo que para ocultar el contenidode los scripts de estos navegadores, se pueden invertir los operandos de losoperadores relacionales y de desplazamiento (p.ej., usar "y < x" en vezde "x > y") o se pueden usar caracteres de escape dependientes del lenguajede scripts para ">".