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 marcos HTML permiten a los autores presentar documentos con vistas múltiples,que pueden ser ventanas o subventanas independientes. Las vistas múltiples ofrecena los autores una manera de mantener cierta información visible mientras otrasvistas se desplazan o se sustituyen. Por ejemplo, dentro de una misma ventana, unmarco podría mostrar un gráfico estático, un segundo marco un menú de navegación,y un tercero el documento principal que puede ser desplazado, o reemplazado alnavegar por el segundo marco.
Aquí tenemos un documento simple con marcos:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN" "http://www.w3.org/TR/html4/frameset.dtd"><HTML><HEAD><TITLE>Un documento simple con marcos</TITLE></HEAD><FRAMESET cols="20%, 80%"> <FRAMESET rows="100, 200"> <FRAME src="contenidos_del_marco1.html"> <FRAME src="contenidos_del_marco2.gif"> </FRAMESET> <FRAME src="contenidos_del_marco3.html"> <NOFRAMES> <P>Este conjunto de marcos contiene: <UL> <LI><A href="contenidos_del_marco1.html">Contenidos chéveres</A> <LI><IMG src="contenidos_del_marco2.gif" alt="Una imagen chévere"> <LI><A href="contenidos_del_marco3.html">Más contenidos chéveres</A> </UL> </NOFRAMES></FRAMESET></HTML>
Esto podría crear una disposición de marcos como la siguiente:
---------------------------------------| | || | || Marco 1 | || | || | ||---------| || | Marco 3 || | || | || | || Marco 2 | || | || | || | || | | ---------------------------------------
Si el agente de usuario no puede mostrar marcos o está configuradopara no mostrarlos, representará los contenidos del elementoNOFRAMES.
Los documentos HTML que describen una disposición de marcos (llamadosdocumentos con marcos) tienen una estructura diferente a lade los documentos HTML sin marcos. Un documento normal tiene una secciónHEAD y una secciónBODY. Un documento con marcos tieneuna secciónHEAD, y un
La secciónFRAMESET de un documento especifica la disposición de las vistas enla ventana principal del agente de usuario. Además, la secciónFRAMESET puede contener un elementoNOFRAMES que proporcionecontenido alternativopara los agentes de usuario que no soporten marcos o que estén configurados parano mostrar marcos.
Los elementos que normalmente podrían colocarse en el elementoBODY no deben aparecer antes del primer elementoFRAMESET o elFRAMESET no será tenido en cuenta.
<![%HTML.Frameset; [<!ELEMENTFRAMESET - - ((FRAMESET|FRAME)+ & NOFRAMES?) -- subdivisión en ventanas --><!ATTLIST FRAMESET%coreattrs; --id,class,style,title --rows%MultiLengths; #IMPLIED -- lista de longitudes, por defecto: 100% (1 fila) --cols%MultiLengths; #IMPLIED -- lista de longitudes, por defecto: 100% (1 columna) --onload%Script; #IMPLIED -- todos los marcos han sido cargados --onunload%Script; #IMPLIED -- todos los marcos han sido quitados -- >]]>
Definiciones de atributos
Atributos definidos en otros lugares
ElelementoFRAMESET especifica la organización dela ventana principal del usuario en términos de subespacios rectangulares.
Cuando se establece el atributo
Si no se establece el atributorows, cada columna se extiende a lo largo detoda la longitud de la página. Si no se establece el atributocols, cada filase extiende a lo largo de toda la anchura de la página. Si no se estableceninguno de los dos atributos, el marco tiene exactamente el mismo tamaño quela página.
Los marcos se crean de izquierda a derecha para las columnas y de arribaa abajo para las filas. Cuando se especifican ambos atributos, las vistasse crean de izquierda a derecha en la fila superior, de izquierda a derechaen la segunda fila, etc.
En este primer ejemplo dividimos la pantalla verticalmente en dos (es decir,creamos una mitad superior y una mitad inferior).
<FRAMESET rows="50%, 50%">...el resto de la definición...</FRAMESET>
El siguiente ejemplo crea tres columnas: la segunda tiene una anchura fijade 250 píxeles (lo cual es útil, por ejemplo, para incluir una imagen de tamañoconocido). La primera recibe el 25% del espacio restante, y la tercera el 75%del espacio restante.
<FRAMESET cols="1*,250,3*">...el resto de la definición...</FRAMESET>
El siguiente ejemplo crea una cuadrícula de 2x3 subespacios.
<FRAMESET rows="30%,70%" cols="33%,34%,33%">...el resto de la definición...</FRAMESET>
Para el siguiente ejemplo, supongamos que la ventana del navegador tieneactualmente una altura de 1000 píxeles. Para la primera vista se asignael 30% de la altura total (300 píxeles). Para la segunda vista se especificaque tenga una altura de exactamente 400 píxeles. Esto deja 300 píxeles pararepartir entre los otros dos marcos. La altura del cuarto marco se haespecificado como "2*", de modo que es el doble de alto que el tercer marco,cuya altura es sólo "*" (equivalente a 1*). Por tanto el tercer marco seráde 100 píxeles de alto y el cuarto tendrá una altura de 200 píxeles..
<FRAMESET rows="30%,400,*,2*">...el resto de la definición...</FRAMESET>
Las longitudes absolutas que no sumen el 100% del espacio real disponibledeberían ser ajustadas por los agentes de usuario. Cuando sobre espacio,el espacio sobrante debería repartirse proporcionalmente entre cada vista.Cuando falte espacio, debería reducirse cada vista en función de la relaciónentre el espacio especificado y el espacio total.
Los grupos de marcos pueden anidarse hasta cualquier nivel.
En el siguiente ejemplo, elFRAMESET exterior divide elespacio disponible en tres columnas iguales. A continuación elFRAMESET interior divide lasegunda área en dos filas de alturas diferentes.
<FRAMESET cols="33%, 33%, 34%">...contenidos del primer marco... <FRAMESET rows="40%, 50%">...contenidos del segundo marco, primera fila......contenidos del segundo marco, segunda fila... </FRAMESET>...contenidos del tercer marco...</FRAMESET>
Los autores pueden compartir datos entre varios marcos incluyendo estosdatos a través de un elementoOBJECT. Los autores deberían incluir el elementoOBJECT en el elementoHEAD del documento con marcosy darle un nombre con el atributoid. Cualquier documento que seael contenido de un marco del documento con marcos puede hacer referenciaa este identificador.
El siguiente ejemplo ilustra cómo podría hacer referencia un scripta un elementoOBJECT definido para todo un grupo de marcos:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN" "http://www.w3.org/TR/html4/frameset.dtd"><HTML><HEAD><TITLE>Esto es un documento con marcos con un OBJECT en el HEAD</TITLE><!-- ¡Este OBJECT no se representa! --><OBJECT data="datos.dat"></OBJECT></HEAD><FRAMESET> <FRAME src="blanca.html" name="blanca"></FRAMESET></HTML><!-- En blanca.html --><HTML><HEAD><TITLE>Página de Blanca</TITLE></HEAD><BODY>...comienzo del documento...<P><SCRIPT type="text/javascript">parent.miobjeto.mipropiedad</SCRIPT>...el resto del documento...</BODY></HTML>
<![%HTML.Frameset; [<!-- los nombres de marcos reservados comienzan con "_", los demás con una letra --><!ELEMENTFRAME - O EMPTY -- subventana --><!ATTLIST FRAME%coreattrs; --id,class,style,title --longdesc%URI; #IMPLIED -- vínculo a descripción larga (complementa al título) --nameCDATA #IMPLIED -- nombre destino del marco --src%URI; #IMPLIED -- origen del contenido del marco --frameborder (1|0) 1 -- ¿poner bordes al marco? --marginwidth%Pixels; #IMPLIED -- anchuras de los márgenes en píxeles --marginheight%Pixels; #IMPLIED -- alturas de los márgenes en píxeles --noresize (noresize) #IMPLIED -- ¿permitir a los usuarios redimensionar los marcos? --scrolling (yes|no|auto) auto -- barra de desplazamiento o no -- >]]>
Definiciones de atributos
Atributos definidos en otros lugares
El elementoFRAME define los contenidos y la apariencia de un marco dado.
El atributosrc especifica el documento inicial que contendrá el marco.
El siguiente ejemplo de documento HTML:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN" "http://www.w3.org/TR/html4/frameset.dtd"><HTML><HEAD><TITLE>Un documento con marcos</TITLE></HEAD><FRAMESET cols="33%,33%,33%"> <FRAMESET rows="*,200"> <FRAME src="contenidos_del_marco1.html"> <FRAME src="contenidos_del_marco2.gif"> </FRAMESET> <FRAME src="contenidos_del_marco3.html"> <FRAME src="contenidos_del_marco4.html"></FRAMESET></HTML>
debería crear una distribución de marcos parecida a ésta:
------------------------------------------|Marco 1 |Marco 3 |Marco 4 || | | || | | || | | || | | || | | || | | || | | |-------------| | ||Marco 2 | | || | | || | | | ------------------------------------------
y hacer que el agente de usuario cargara cada fichero en una vista separada.
Los contenidos de un marco no deben estar en el mismo documento que ladefinición del marco.
EJEMPLO ILEGAL:
La siguiente definición de un grupo de marcos no es legal según HTML, ya que loscontenidos del segundo marco están en el mismo documento que la definicióndel grupo de marcos.
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN" "http://www.w3.org/TR/html4/frameset.dtd"><HTML><HEAD><TITLE>Un documento con marcos</TITLE></HEAD><FRAMESET cols="50%,50%"> <FRAME src="contenidos_del_marco1.html"> <FRAME src="#vinculo_al_mismo_documento"> <NOFRAMES>...texto... <H2><A name="vinculo_al_mismo_documento">Sección importante</A></H2>...texto... </NOFRAMES></FRAMESET></HTML>
El siguiente ejemplo ilustra el uso de los atributos decorativos deFRAME.Especificamos que el marco 1 no permitirá barras de desplazamiento. El marco2 dejará espacio en blanco alrededor de sus contenidos (inicialmente, unfichero de imagen) y el marco no será redimensionable. No se dibujará ningúnborde entre los marcos 3 y 4. Se dibujarán los bordes (por defecto) entre losmarcos 1, 2 y 3.
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN" "http://www.w3.org/TR/html4/frameset.dtd"><HTML><HEAD><TITLE>Un documento con marcos</TITLE></HEAD><FRAMESET cols="33%,33%,33%"> <FRAMESET rows="*,200"> <FRAME src="contenidos_del_marco1.html" scrolling="no"> <FRAME src="contenidos_del_marco2.gif" marginwidth="10" marginheight="15" noresize> </FRAMESET> <FRAME src="contenidos_del_marco3.html" frameborder="0"> <FRAME src="contenidos_del_marco4.html" frameborder="0"></FRAMESET></HTML>
Nota. Para información sobre las prácticas actualesreferentes a la determinación del marco destino, consulte lasnotas sobre marcos del apéndice.
Definiciones de atributos
Consulte la sección sobrenombres de marcos destino para información sobre nombres de marcos reconocidos.
Este ejemplo ilustra cómo es posible mediante la especificación de un destinola modificación dinámica de los contenidos de un marco. Primero definimos un grupode marcos en el documentoframeset.html, mostrado a continuación:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN" "http://www.w3.org/TR/html4/frameset.dtd"><HTML><HEAD><TITLE>Un documento con marcos</TITLE></HEAD><FRAMESET rows="50%,50%"> <FRAME name="fijo" src="inicial_fijo.html"> <FRAME name="dinamico" src="inicial_dinamico.html"></FRAMESET></HTML>
Después, eninicial_dinamico.html, hacemos un vínculo al marcollamado "dinamico".
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><HTML><HEAD><TITLE>Un documento con vínculos con destinos específicos</TITLE></HEAD><BODY>...comienzo del documento...<P>Puede avanzar ahora a la <A href="diapo2.html">diapositiva 2.</A>...más documento...<P>Lo está haciendo muy bien. Vaya ahora a la <A href="diapo3.html">diapositiva 3.</A></BODY></HTML>
Si se activa cualquiera de los vínculos se abre un nuevo documentoen el marco llamado "dinamico", mientras que el otro marco, "fijo",mantiene sus contenidos iniciales.
Actualmente no hay ninguna manera de codificar con un URI el estado realde un grupo de marcos. Por tanto, muchos agentes de usuario no permiten a los usuarios asignar un marcador a un grupo de marcos.
Cuando muchos vínculos del mismo documento designan al mismo destino,es posible especificar el destino una sola vez para que no sea necesarioincluir el atributotarget en todos los elementos. Esto se haceestableciendo el atributotargetdel elemento
Volvemos al ejemplo anterior, esta vez definiendo la información sobreel destino en el elementoBASE para quitarla de los elementosA.
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><HTML><HEAD><TITLE>Un documento con un destino específico en BASE</TITLE><BASE href="http://www.micom.com/Diapos"></HEAD><BODY>...comienzo del documento...<P>Puede avanzar ahora a la <A href="diapo2.html">diapositiva 2.</A>...más documento...<P>Lo está haciendo muy bien. Vaya ahora a la <A href="diapo3.html">diapositiva 3.</A></BODY></HTML>
Los agentes de usuario deberían determinar el marco destino en elque cargar un recurso vinculado de acuerdo con las siguientes reglasde precedencia (ordenadas de mayor a menor prioridad):
Los agentes de usuario pueden proporcionar a los usuarios un mecanismopara deshabilitar el atributotarget.
Los autores deberían proporcionar contenido alternativo para aquellosagentes de usuario que no soporten marcos o que estén configurados para nomostrar marcos.
<![%HTML.Frameset; [<!ENTITY % noframes.content "(BODY) -(NOFRAMES)">]]><!ENTITY % noframes.content "(%flow;)*"><!ELEMENTNOFRAMES - -%noframes.content; -- contenedor de contenido alternativo para representación no basada en marcos --><!ATTLIST NOFRAMES%attrs; --%coreattrs,%i18n,%events -- >
Atributos definidos en otros lugares
El elementoNOFRAMES especifica un contenido que sólo deberían mostrar los agentesde usuario que no soporten marcos o que estén configurados para no mostrar marcos.Los agentes de usuario que soporten marcos sólo deben mostrar los contenidos de unadeclaraciónNOFRAMES cuando se configuren para no mostrar marcos. Los agentesde usuario que no soporten marcos deben mostrar los contenidos deNOFRAMES en cualquier caso.
El elementoNOFRAMES es parte tanto delDTD transicional como del de documentos con marcos.En un documento que use el DTD de documentos con marcos,NOFRAMES
Por ejemplo:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN" "http://www.w3.org/TR/html4/frameset.dtd"> <HTML> <HEAD> <TITLE>Un documento con marcos con NOFRAMES</TITLE> </HEAD> <FRAMESET cols="50%, 50%"> <FRAME src="principal.html"> <FRAME src="tabla_de_contenidos.html"> <NOFRAMES> <P>Aquí puede encontrar la <A href="principal-sinmarcos.html"> version sin marcos del documento.</A> </NOFRAMES> </FRAMESET> </HTML>
NOFRAMES se puede usar, por ejemplo, en un documento que sea elorigen de un marco y que use el DTD transicional. Esto permite a los autoresexplicar el propósito del documento en los casos en que éste se vea fuera delgrupo de marcos o con un agente de usuario que no soporte marcos.
El atributolongdesc permite a los autores hacer los documentoscon marcos más accesibles a las personas que utilizan agentes de usuario no visuales.Este atributo designa un recurso que proporciona una descripción larga del marco.Los autores deberían recordar que las descripciones largas asociadas con los marcosse refieren almarco, y no a los contenidos del marco. Como los contenidospueden variar con el tiempo, la descripición larga inicial podría ser inapropiadapara los contenidos posteriores del marco. En particular, los autores no deberíanincluir una imagen como único contenido de un marco.
El siguiente documento con marcos describe dos marcos. El marco izquierdocontiene una tabla de contenidos y el marco derecho contiene inicialmente laimagen de un avestruz:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN" "http://www.w3.org/TR/html4/frameset.dtd"><HTML><HEAD><TITLE>Un documento con marcos mal diseñado</TITLE></HEAD><FRAMESET cols="20%, 80%"> <FRAME src="tabla_de_contenidos.html"> <FRAME src="avestruz.gif" longdesc="desc-avestruz.html"></FRAMESET></HTML>
Obsérvese que la imagen ha sido incluida en el marco independientementede cualquier elemento HTML, de modo que el autor no tiene ninguna manera deespecificar un texto alternativo aparte de usar el atributolongdesc. Si los contenidos del marco derechocambian (p.ej., el usuario selecciona una serpiente de cascabel en la tablade contenidos), los usuarios no tendrán acceso textual a los nuevos contenidosdel marco.
Por tanto, los autores no deberían poner una imagen en un marcodirectamente. En su lugar, la imagen debería especificarse en un documentoHTML independiente, en el cual se podría adjuntar el texto alternativoapropiado:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN" "http://www.w3.org/TR/html4/frameset.dtd"><HTML><HEAD><TITLE>Una documento con marcos bien diseñado</TITLE></HEAD><FRAMESET cols="20%, 80%"> <FRAME src="tabla_de_contenidos.html"> <FRAME src="contenedor_avestruz.html"></FRAMESET></HTML>
<!-- En contenedor_avestruz.html: --><HTML><HEAD><TITLE>El avestruz, robusto y veloz</TITLE></HEAD><P><OBJECT data="avestruz.gif" type="image/gif">¡Estos avestruces seguro que están ricos!</OBJECT></HTML>
<!ELEMENTIFRAME - - (%flow;)* -- subventana en línea --><!ATTLIST IFRAME%coreattrs; --id,class,style,title --longdesc%URI; #IMPLIED -- vínculo a descripción larga (complementa al título) --nameCDATA #IMPLIED -- nombre destino del marco --src%URI; #IMPLIED -- origen del contenido del marco --frameborder (1|0) 1 -- ¿poner bordes al marco? --marginwidth%Pixels; #IMPLIED -- anchuras de los márgenes en píxeles --marginheight%Pixels; #IMPLIED -- alturas de los márgenes en píxeles --scrolling (yes|no|auto) auto -- barra de desplazamiento o no --align%IAlign; #IMPLIED -- alineación vertical u horizontal --height%Length; #IMPLIED -- altura del marco --width%Length; #IMPLIED -- anchura del marco -- >
Definiciones de atributos
Atributos definidos en otros lugares
El elementoIFRAME permite a los autores insertar un marco dentro de un bloque detexto. Insertar un marco en línea dentro de una sección de texto es muy similara insertar un objeto mediante un elementoOBJECT: ambos permiten insertar un documento HTMLen medio de otro, ambos pueden alinearse con el texto circundante, etc.
La información a insertar en línea se designa mediante el atributosrc de este elemento. Loscontenidos del elementoIFRAME,por su parte, sólo deberían ser mostrados por los agentes de usuario que nosoporten marcos o que estén configurados para no mostrar marcos.
Para aquellos agentes de usuario que soporten marcos, el siguiente ejemplocolocará un marco en línea rodeado por un borde en medio del texto.
<IFRAME src="blabla.html" width="400" height="500" scrolling="auto" frameborder="1"> [Su agente de usuario no soporta marcos o está actualmente configurado para no mostrar marcos. Sin embargo, puede visitar <A href="blabla.html">el documento relacionado.</A>] </IFRAME>
Los marcos en línea no pueden ser redimensionados (y por lo tantono tienen un atributonoresize).
Nota. También puede incluirse un documento HTML dentro de otro documento HTML por medio del elementoOBJECT. Véase la sección sobredocumentos incluidos paramás detalles.