Go to main content
Bypass navigation bar Referencia HTML Tags HTML Tutoriales HTML
Bypass language selection
Bypass location bar

Location: Inicio > Referencia HTML > Tags HTML > Tag HTML colgroup

Bypass main content

Tag HTML colgroup

 Nota: Si no sabes lo que es un elemento/tag o cómo debes utilizarlo, te recomiendo que leas el tutorial "Tags y atributos en HTML", que puedes encontrar en la sección de tutoriales HTML.

Bypass main content

Descripción

El elemento HTML colgroup es usado en tablas para agrupar columnas. Debe ser insertado justo después del tag de apertura del elemento HTML table.

El atributo "span" es aquel que permite la agrupación, ya que especifica el número de columnas que se agruparán, de izquierda a derecha, respetando el orden. Su valor por defecto es 1.

Aún cuando la principal razón de su existencia es la de separar semánticamente griupos de columnas, este elemento también puede definir atributos comunes a las columnas afectadas. Esta propiedad puede ser potenciada usando a este elemento junto con el tag HTML col.

Note, that some attributes available for this tag are purely presentational (align, valign, width, char and charoff), reason for which their use is not recommended.

Ejemplos

El siguiente ejemplo muestra un uso común del elemento HTML colgroup. Allí, las columnas son agrupadas temáticamente.

Código
<table>
<colgroup></colgroup>
<colgroup span="3"></colgroup>
<colgroup span="2"></colgroup>
<tr>
<th>País</th>
<th>Salmón</th>
<th>Camarones</th>
<th>Ostras</th>
<th>Arroz</th>
<th>Trigo</th>
</tr>
<tr>
<td>Reino Unido</td>
<td>2050</td>
<td>1545</td>
<td>1156</td>
<td>5007</td>
<td>12254</td>
</tr>
<tr>
<td>Estados Unidos</td>
<td>1358</td>
<td>1884</td>
<td>784</td>
<td>10597</td>
<td>24554</td>
</tr>
<tr>
<td>Australia</td>
<td>985</td>
<td>65</td>
<td>518</td>
<td>2548</td>
<td>10548</td>
</tr>
</table>
Vista
País Salmón Camarones Ostras Arroz Trigo
Reino Unido 2050 1545 1156 5007 12254
Estados Unidos 1358 1884 784 10597 24554
Australia 985 65 518 2548 10548

En el próximo ejemplo, la misma tabla es representada, usando el elemento HTML coulgroup junto al elemento HTML col para definir algunos atributos a las columnas. La semántica del ejemplo anterior permanece intacta.

Código
<table>
<colgroup style="background: #BBBBFF;"></colgroup>
<colgroup span="3">
<col style="background: #AAFFAA;" />
<col style="background: #BBFFBB;" />
<col style="background: #CCFFCC;" />
</colgroup>
<colgroup span="2">
<col style="background: #FFBBBB;" />
<col style="background: #FFCCCC;" />
</colgroup>
<tr>
<th>País</th>
<th>Salmón</th>
<th>Camarones</th>
<th>Ostras</th>
<th>Arroz</th>
<th>Trigo</th>
</tr>
<tr>
<td>Reino Unido</td>
<td>2050</td>
<td>1545</td>
<td>1156</td>
<td>5007</td>
<td>12254</td>
</tr>
<tr>
<td>Estados Unidos</td>
<td>1358</td>
<td>1884</td>
<td>784</td>
<td>10597</td>
<td>24554</td>
</tr>
<tr>
<td>Australia</td>
<td>985</td>
<td>65</td>
<td>518</td>
<td>2548</td>
<td>10548</td>
</tr>
</table>
Vista
País Salmón Camarones Ostras Arroz Trigo
Reino Unido 2050 1545 1156 5007 12254
Estados Unidos 1358 1884 784 10597 24554
Australia 985 65 518 2548 10548

Atributos

id (name)

El atributo "id" asigna un identificador al elemento asociado. Este identificador debe ser único en todo el documento y puede ser usado para referirse a este elemento en otras instancias (por ejemplo, desde un script del lado cliente).

<p id="parrafo1">Este es el primer párrafo, llamado "parrafo1". Para cambiar dinámicamente sus prpiedades usa este identificador.</p>

class (cdata)

El atributo "class" asigna un nombre de clase (o una lista de nombres de clases separadas por espacios) al elemento contenedor. Es usado junto con hojas de estilos y le dice al navegador la clase (o clases) a las que el elemento está asociado.

Una clase da atributos presentacionales a los elementos (lee más en el tutorial "Hojas de estilo en cascada").

<p class="referencias">Este artículo está basado en el libro "Viento en los árboles" de Jhon L. Brooks</p>
<p class="referencias importante">Este artículo está basado en el libro "Viento en los árboles" de Jhon L. Brooks... y es más importante que el anterior.</p>

style (style)

Este atributo es utilizado para definir atributos presentacionales para el elemento contenedor, y su valor debería estar compuesto por propiedades de hojas de estilo. Aunque en algunos casos es particularmente útil, es una mejor práctica poner los atributos presentacionales en archivos externos, relacionándolos a los elementos a través del atributo "class". De este modos, se mejora la separación de las partes semántica y presentacional de tu documento.

Puedes encontrar más información acerca de los atributos presentacionales en el tutorial "Hojas de estilo en cascada".

<p style="color: #0000FF; font-size: 12pt">Este es un párrafo con un estilo definido.</p>
<p>Y este es otro texto sin estilo.</p>

title (text)

El propósito de este atributo es proveer un título para el elemento. Su valor debe ser una descripción corta y precisa del contenido del elemento. Habitualmente, los navegadores muestran el contenido de este atributo en un recuadro al posar el mouse encima del contenido del elemento por un pequeño período de tiempo.

Código
<a title="HTMLQuick.com" href="http://www.htmlquick.com/es/">Código HTML</a>
Vista

lang (langcode)

Especifica el lenguaje del contenido de un elemento. El valor por defecto es "desconocido".

Al escribir documentos XHTML 1.0, el atributo usado para especificar el lenguaje de un elemento es "xml:lang". Para compatibilidad con los dos tipos de estándar ambos atributos pueden ser usados simultáneamente como en el ejemplo a continuación. Nota que en XHTML 1.1, el atributo "lang" ha sido completamente reemplazado por "xml:lang" y su uso ya no es válido.

<p lang="en" xml:lang="en">This is a paragraph in English.</p>
<p lang="es" xml:lang="es">Este es un párrafo en español.</p>

dir

Este atributo indica la dirección en que el texto del elemento debe ser leído. Esto incluye al contenido, los valores de los atributos y las tablas. Tiene dos valores posibles que son insensibles a mayúsculas/minúsculas:

  • RTL: derecha a izquierda.
  • LTR: izquierda a derecha.
<q lang="he" dir="rtl">...una cita en Hebreo...</q>

span (number)

Este atributo especifica el número consecutivo de columnas "unificadas" o afectadas por el elemento o sus atributos.

<col span="2" style="border: none;" />
<col span="5" style="background: red;" />

width (multi-length)

Este atributo especifica el ancho para todas las celdas en las columnas afectadas.

<col width="50" />

align

Establece la alineación para el texto dentro de una celda en las columnas afectadas. Puede tomar uno de los siguientes valores insensibles a mayúsculas/minúsculas:

  • left: la información es alineada a la izquierda. Este es el valor por defecto para las celdas comunes (tag HTML td).
  • center: la información es centrada. Este es el valor por defecto para las celdas de encabezado (tag HTML th).
  • right: la información es alineada a la derecha.
  • justify: la información es justificada, es decir, alineada a ambos márgenes.
  • char: el texto es alineado según un carácter específico. se utiliza junto con el atributo "char".
<col align="center" />

valign

Establece la alineación vertical para el texto dentro de una celda en las columnas afectadas. Puede tomar uno de los siguientes valores insensibles a mayúsculas/minúsculas:

  • top: la información es alineada a la margen superior.
  • middle: la información es centrada verticalmente.
  • bottom: la información es alineada a la margen inferior.
  • baseline: todas las celdas en una fila que contengan esta alineación deberían tener su primera línea de texto en una base común.
<col valign="top" />

char (character)

Especifica un carácter que actuará como eje para la alineación del texto. Para que este valor sea considerado, el atributo "align" debe presentar el valor "char".

Nota que a los navegadores no se les requiere soporte para este atributo. Esto, sumado a su naturaleza presentacional, constituye una buena razón para no confiar en el.

<col align="char" char="." />

charoff (length)

Especifica un desplazamiento para el carácter de alineación (primera aparición) en cada línea. La dirección del texto, establecida con el atributo "dir", debe ser tenida en cuenta a la hora de decidir cuál será la primera aparición.

Nota que a los navegadores no se les requiere soporte para este atributo. Esto, sumado a su naturaleza presentacional, constituye una buena razón para no confiar en el.

<col align="char" char="." charoff="1" />

Eventos

  • onclick
  • ondblclick
  • onmousedown
  • onmouseup
  • onmouseover
  • onmousemove
  • onmouseout
  • onkeypress
  • onkeydown
  • onkeyup

Ve a la lista completa de eventos en HTML.

Diseño y desarrollo: Latitud29.com

Vínculos y logos|Contacto|Más allá de HTML|Herramientas y recursos|Mapa del sitio|Webmaster|Dona