Elemento ins

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

Descripción

El elemento ins representa contenido que ha sido agregado al documento. Este elemento, junto con el elemento del, permite a los autores hacer públicos los cambios editoriales que se producen en el documento. Esto resulta útil cuando los lectores del documento pueden beneficiarse de conocer los cambios que han sido aplicados a éste para que llegue a su estado actual.

Los atributos cite y datetime pueden usarse para proveer información acerca de la actualización. Mientras que cite contiene el URI del recurso que provee una explicación acerca de la actualización, datetime puede aportar la fecha y hora en que los cambios se llevaron a cabo. Ten en cuenta que los contenidos de datetime deben acoplarse a los siguientes formatos.

Fechas

La sintaxis de una fecha está compuesta por:

  1. Una sintaxis válida de mes representando un año y un mes.
  2. Un signo menos o guión ("-").
  3. Un día de dos dígitos entre 1 y el número de días del mes y año previamente especificados.

Ejemplo

<time>2014-07-05</time>
<time>1920-12-31</time>

Fecha y hora globales

La sintaxis de una fecha y hora global está compuesta por:

  1. Una sintaxis válida de fecha representando año, mes y día.
  2. Una letra T mayúscula o un carácter de espacio (" ").
  3. Una sintaxis válida de hora representando la hora.
  4. Una sintaxis válida de zona horaria representando el desplazamiento de zona horaria.

Ejemplo

<time>2014-01-14 00:12-03:00</time>
<time>2014-05-16T20:12+00:30</time>
<time>2201-08-20 03:04:22.5-5:00</time>
<time>2000-04-01T02:00:00.00+4:00</time>

Para que una fecha y hora global sea una cadena de fecha y hora global normalizada a UTC, debe estar compuesta por:

  1. Una sintaxis válida de fecha representando año, mes y día, convertida a la zona horaria UTC.
  2. Una letra T mayúscula.
  3. Una sintaxis válida de hora representando la hora, convertida a la zona horaria UTC y en su variante más corta (por ejemplo, con la omisión del número de segundos cuando es cero).
  4. Una letra Z mayúscula.

Ejemplo

<time>2014-02-03T22:00Z</time>
<time>2010-01-01T00:00:00.001Z</time>
<time>2050-01-03T23:59Z</time>
<time>1980-12-23T00:05Z</time>

Para construir una fecha o una fecha y hora global, puedes necesitar algunos de los siguientes formatos:

Meses

La sintaxis de un mes está compuesta por:

  1. Un año mayor que cero, compuesto por, al menos, cuatro dígitos.
  2. Un signo menos o guión ("-").
  3. Un mes entre 1 y 12, compuesto de dos dígitos.

Ejemplo

<time>2014-07</time>
<time>0512-12</time>

Horas

La sintaxis de una hora está compuesta por:

  1. Dos dígitos representando una hora entre 0 y 23.
  2. Un carácter de dos puntos (":").
  3. Un minuto de dos dígitos entre 0 y 59.
  4. La siguiente información, que es opcional si el número de segundos es cero:
    1. Un carácter de dos puntos (":").
    2. Dos dígitos representando la parte entera de los segundos, entre 0 y 59.
    3. La siguiente información, que es opcional si el número de segundos es entero:
      1. Un punto (".").
      2. La parte fraccionaria de los segundos compuesta por uno, dos o tres dígitos.

Ejemplo

<time>23:59:59.999</time>
<time>10:20:00.000</time>
<time>10:20</time>
<time>10:20:00</time>

Zonas horarias

La sintaxis de una zona horaria está compuesta por:

  1. Un signo menos o guión ("-") si el desplazamiento es negativo, y un signo más ("-") en caso contrario.
  2. Dos dígitos representando una hora entre 0 y 23.
  3. Opcionalmente, un carácter de dos puntos (":").
  4. Un minuto de dos dígitos entre 0 y 59.

Ejemplo

<time>-12:00</time>
<time>+00:00</time>
<time>+00:30</time>
<time>-1100</time>

Este formato permite un rango de zonas horarias más amplio de los que actualmente se utiliza en la práctica. La razón de este exceso es mejorar la adaptabilidad a futuros cambios en las zonas horarias, Ya que éstos están sujetos a decisiones políticas.

El elemento ins puede contener ambos tipos de contenido, flow (bloques de contenido habitualmente compuestos por uno o más elementos) o phrasing (pequeñas líneas de texto).

Ejemplos

En el siguiente ejemplo, tenemos un trozo de documento donde el autor ha marcado el texto agregado con el elemento ins para dejar en claro qué ha sido insertado. Aquí, sólo contiene una línea de texto (phrasing).

<p>...la ley permite a los ciudadanos de sexo masculino<ins> y femenino</ins> votar a sus representantes políticos...</p>

...la ley permite a los ciudadanos de sexo masculino y femenino votar a sus representantes políticos...

Ahora, otro documento con sus cambios visibles, esta vez, con el agregado de un párrafo completo. Aquí, también son provistas la fecha y una explicación de la actualización en los atributos cite y datetime respectivamente. Recuerda que cite toma un URI como valor, y que los contenidos de datetime deben cumplir con los formatos de fechas y fecha y hora globales.

<p>...El programa soporta los formatos wav, mp3 y wma.</p>
<ins cite="#update4" datetime="2014-04-01 02:15:11">
  <p>Nota: desde la versión 2 en adelante, el formato ogg también es soportado.</p>
</ins>

...El programa soporta los formatos wav, mp3 y wma.

Nota: desde la versión 2 en adelante, el formato ogg también es soportado.

En el tercero y último ejemplo, los atributos ins y del se utilizan para marcar el reemplazo de un trozo de contenido por otro. Solo de los contenidos de este ejemplo, puedes saber que el nivel de dificultad del juego ha sido ajustado para que resulte más desafiante.

<p>Las reglas de este juego solo permiten un total de <del>diez disparos en un período de 40 segundos (máximo)</del><ins>cinco disparos en un período de 20 segundos (máximo)</ins>.</p>

Las reglas de este juego solo permiten un total de diez disparos en un período de 40 segundos (máximo)cinco disparos en un período de 20 segundos (máximo).

Atributos

Atributos específicos

cite

El URI de un recurso que provee una explicación acerca de la actualización (¿por qué ha sido agregado el contenido?, ¿como conclusión de qué debate?, ¿con el concenso de qué porcentaje de los participantes?, etc.)

Ejemplo

<p>...<ins cite="el-por-que-de-las-actualizaciones.html#actualizacion12">por cuatro miembros del partido</ins>...</p>

datetime

La fecha y hora en que el contenido ha sido agregado. La información en este atributo debe cumplir con las regulaciones de fechas y fecha y hora globales.

Ejemplo

<p>...<ins datetime="2011-01-01">el delegado regional debe presentar el proyecto al consejo</ins>...</p>

Atributos globales

Para más información acerca de los atributos globales refiérete a esta lista de atributos gloables en HTML5.

Eventos

Eventos globales

Para más información acerca de los eventos globales refiérete a esta lista de eventos globales en HTML5.