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.
Tabla de contenidos
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:
- Una sintaxis válida de mes representando un año y un mes.
- Un signo menos o guión ("-").
- 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:
- Una sintaxis válida de fecha representando año, mes y día.
- Una letra T mayúscula o un carácter de espacio (" ").
- Una sintaxis válida de hora representando la hora.
- 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:
- Una sintaxis válida de fecha representando año, mes y día, convertida a la zona horaria UTC.
- Una letra T mayúscula.
- 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).
- 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:
- Un año mayor que cero, compuesto por, al menos, cuatro dígitos.
- Un signo menos o guión ("-").
- 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:
- Dos dígitos representando una hora entre 0 y 23.
- Un carácter de dos puntos (":").
- Un minuto de dos dígitos entre 0 y 59.
- La siguiente información, que es opcional si el número de segundos es cero:
- Un carácter de dos puntos (":").
- Dos dígitos representando la parte entera de los segundos, entre 0 y 59.
- La siguiente información, que es opcional si el número de segundos es entero:
- Un punto (".").
- 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:
- Un signo menos o guión ("-") si el desplazamiento es negativo, y un signo más ("-") en caso contrario.
- Dos dígitos representando una hora entre 0 y 23.
- Opcionalmente, un carácter de dos puntos (":").
- 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.
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.