secciones.rst 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331
  1. .. 4.3
  2. =======================
  3. Secciones
  4. =======================
  5. El elemento ``body``
  6. ====================
  7. Representa el contenido de un documento HTML. Sólo puede haber un elemento
  8. ``<body>`` en un documento.
  9. El elemento ``<body>`` expone como atributos de contenidos del controlador
  10. de eventos un número de manejadores de eventos del objeto Window.
  11. Los controladores de eventos ``onblur``, ``onerror``, ``onfocus``, ``onload``,
  12. ``onresize`` y ``onscroll`` del objeto **Window**, expuestos en el elemento
  13. ``body``, reemplazan los manejadores de eventos genéricos por los mismos
  14. nombres normalmente admitidos por los elementos HTML.
  15. .. code-block:: html
  16. <!DOCTYPE html>
  17. <html lang="es">
  18. <head>
  19. <meta charset="UTF-8">
  20. <title>Comprobar estado navegador</title>
  21. <script>
  22. function update(online) {
  23. document.getElementById('status').textContent = online ? 'Conectado' : 'Desconectado';
  24. }
  25. </script>
  26. </head>
  27. <body ononline="update(true)"
  28. onoffline="update(false)"
  29. onload="update(navigator.onLine)">
  30. <p>Tú estás: <span id="status">(Desconocido)</span></p>
  31. </body>
  32. </html>
  33. En este ejemplo podemos ver como se le asocia a los distintos eventos
  34. **ononline**, **onoffline** un metodo predefinido por el programador el cual
  35. recibe por parametro un valor booleano y mediante la propiedad **onLine** del
  36. objeto ``navigator`` muestra en la etiqueta ``<span>`` si el navegador
  37. esta conectado a internet.
  38. El elemento ``article``
  39. =======================
  40. El elemento ``<article>`` representa una composición completa o autónoma
  41. en un documento, una página, una aplicación o un sitio web. Esto podría ser una
  42. revista, un periódico, un artículo técnico o académico, un ensayo o informe,
  43. un blog u otro mensaje de medios sociales.
  44. Cada ``<article>`` debe ser identificado, típicamente incluyendo un encabezado
  45. elemento (``<h1>``, ``<h2>``...) como un elemento hijo del elemento del
  46. ``<article>``.
  47. .. code-block:: html
  48. <article>
  49. <header>
  50. <h2><a href="https://www.w3.org/TR/html51/">Indice de contenidos</a></h2>
  51. <p>Posteado el Domingo, 1 Enero 2017 por Raul Vela Salas.
  52. <a href="https://www.w3.org/TR/html51/sections.html#sections">Ejemplo de secciones</a></p>
  53. </header>
  54. <p>En esta parte podemos encontrar todo tipo de elementos y referencias relacionado con las secciones
  55. de la version mas reciente de HTML 5.1 , es por ello que es importante tenerla de referencia</p>
  56. <p><a href="https://www.w3.org/TR/html51/index.html#contents/">Continúa leyendo más sobre este tema</a></p>
  57. </article>
  58. El elemento ``section``
  59. =======================
  60. .. image:: imagenes/bodyStructureSection.png
  61. El elemento ``<section>`` representa una sección genérica de un documento o aplicación.
  62. Una ``<section>`` en este contexto es una agrupación temática de contenido.
  63. Cada ``<section>`` debe identificarse, típicamente incluyendo un encabezado del
  64. elemento ``<h1>``-``<h6>`` como hijo del elemento de la sección.
  65. .. code-block:: html
  66. <article>
  67. <header>
  68. <h2>Manzanas</h2>
  69. <p>¡Sabrosa, deliciosa fruta!</p>
  70. </header>
  71. <p>La manzana es la fruta pomácea del manzano.</p>
  72. <section aria-label="Manzanas rojas.">
  73. <h3>Delicionas Rojas</h3>
  74. <p>Estas manzanas rojas brillantes son las más comunes que se encuentran en muchos supermercados.</p>
  75. </section>
  76. <section aria-label="Manzanas verdes.">
  77. <h3>Granny Smith</h3>
  78. <p>Estas jugosas manzanas verdes hacen un gran relleno para pasteles de manzana.</p>
  79. </section>
  80. </article>
  81. El elemento ``nav``
  82. ===================
  83. .. image:: imagenes/bodyStructureNav.png
  84. El elemento ``<nav>`` representa una sección de una página que enlaza con otras
  85. páginas o con partes de la página. Es una sección con vínculos de navegación.
  86. .. code-block:: html
  87. <body>
  88. <h1>Ejemplo de la etiqueta nav</h1>
  89. <nav>
  90. <ul>
  91. <li><a href="#">Principal</a></li>
  92. <li><a href="/events">Eventos Actuales</a></li>
  93. </ul>
  94. </nav>
  95. <article>
  96. <header>
  97. <h2>Ejemplo de nav</h2>
  98. <p>Creado por R.V.S.</p>
  99. </header>
  100. <nav>
  101. <ul>
  102. <li><a href="#publico">Demostracion Pública </a></li>
  103. <li><a href="#destruir">Destruir</a></li>
  104. </ul>
  105. </nav>
  106. <div>
  107. <section id="publico">
  108. <h2>Demostracion Pública</h2>
  109. <p>...mas contenido...</p>
  110. </section>
  111. <section id="destruir">
  112. <h2>Destruir</h2>
  113. <p>...mas contenido...</p>
  114. </section>
  115. </div>
  116. <footer>
  117. <p><a href="?editar">Editar</a> | <a href="?delete">Borrar</a> | <a href="?Rename">Renombrar</a></p>
  118. </footer>
  119. </article>
  120. <footer>
  121. <p><small>Ejemplo proporcionado por HTML 5.1</small></p>
  122. </footer>
  123. </body>
  124. El elemento ``aside``
  125. =======================
  126. .. image:: imagenes/bodyStructureAside.png
  127. El elemento ``<aside>`` representa una sección de una página que consiste en
  128. contenido que está relacionado con el contenido principal de la sección del elemento
  129. padre y que podría considerarse por separado de ese contenido principal.
  130. Las secciones se representan a menudo como barras laterales.
  131. El elemento se puede utilizar para efectos tipográficos como barras laterales,
  132. para publicidad, para grupos de elementos de navegación y para otros contenidos
  133. que se consideran separados del contenido principal.
  134. .. code-block:: html
  135. <article>
  136. <h2>Estoy aprendiendo a cocinar</h2>
  137. <p>Hoy he completado con éxito una receta de cocina...</p>
  138. <p>Espero seguir mejorando mis habilidades como cocinera.</p>
  139. </article>
  140. <aside class="anuncio">
  141. <p><strong>Encuentra rápido lo que buscas con el buscador <a href="https://searx.me/">Searx</a></strong>.
  142. Nuestro buscador respeta la privacidad del usuario y es software libre.</p>
  143. </aside>
  144. Los elemento ``h1``, ``h2``, ``h3``, ``h4``, ``h5`` y ``h6``
  145. ============================================================
  146. Estos elementos representan **encabezados** para sus secciones.
  147. Estos elementos tienen un **rango** dado por el número que acompaña a su nombre.
  148. El elemento ``<h1>`` tiene el rango **más alto**, el elemento ``<h6>`` tiene el rango
  149. **más bajo**, y dos elementos con el mismo nombre tienen mismo rango.
  150. .. code-block:: html
  151. <body>
  152. <h1>Más alto nivel de rango del encabezado</h1>
  153. <section><h2>Segundo nivel de encabezado</h2>
  154. <section><h3>Tercer nivel de encabezado</h3>
  155. <section><h4>Cuarto nivel de encabezado</h4>
  156. <section><h5>Quinto nivel de encabezado</h5>
  157. <section><h6>Sexto nivel de encabezado</h6>
  158. </section>
  159. </section>
  160. </section>
  161. </section>
  162. </section>
  163. </body>
  164. Los elementos ``<h1>``-``<h6>`` no deben usarse para subrayar subtítulos, títulos
  165. alternativos y etiquetas de linea a menos que se prevea que sean el encabezado
  166. de una nueva sección o subsección.
  167. El elemento ``header``
  168. ======================
  169. .. image:: imagenes/bodyStructureHeader.png
  170. El elemento ``<header>`` representa un grupo de ayudas introductorias
  171. o de navegación. Puede contener algunos elementos de encabezado, pero también
  172. otros elementos como un logo, una sección que aglutine secciones de encabezados,
  173. una formulario de búsqueda o cosas parecidas.
  174. Cuando el ancestro más cercano como las secciones de contenido ``<article>``,
  175. ``<aside>``, ``<nav>`` y ``<section>`` o de la secciones de raiz ``<blockquote>``
  176. ``<body>``, ``<details>``, ``<fieldset>``, ``<figure>``, ``<td>`` son un elemento
  177. del ``<body>``, entonces es aplicado a toda la página.
  178. .. code-block:: html
  179. <!DOCTYPE html>
  180. <html>
  181. <head>
  182. <title></title>
  183. </head>
  184. <body>
  185. <header>
  186. <h1>Graficos Vectoriales Escalables (SVG) 1.2</h1>
  187. <p>W3C 2017</p>
  188. <dl>
  189. <dt>Actual versión:</dt>
  190. <dd><a href="https://www.w3.org/TR/2004/WD-SVG12-20041027/">https://www.w3.org/TR/2004/WD-SVG12-20041027/</a></dd>
  191. <dt>Anterior version:</dt>
  192. <dd><a href="https://www.w3.org/TR/2004/WD-SVG12-20040510/">https://www.w3.org/TR/2004/WD-SVG12-20040510/</a></dd>
  193. <dt>Anterior version de SVG 1.2:</dt>
  194. <dd><a href="https://www.w3.org/TR/SVG12/">https://www.w3.org/TR/SVG12/</a></dd>
  195. <dt>La última recomendación de SVG :</dt>
  196. <dd><a href="https://www.w3.org/TR/SVG/">https://www.w3.org/TR/SVG/</a></dd>
  197. <dt>Editor:</dt>
  198. <dd>Dean Jackson, W3C, <a href="mailto:dean@w3.org">dean@w3.org</a></dd>
  199. <dt>Autor:</dt>
  200. <dd>Ver <a href="#authors">Lista de autores</a></dd>
  201. </dl>
  202. <p class="copyright"><a href="https://www.w3.org/Consortium/Legal/ipr-notic"></a></p>
  203. </header>
  204. </body>
  205. </html>
  206. El elemento ``header`` no secciona el contenido: **no introduce una nueva sección**.
  207. El elemento ``footer``
  208. ======================
  209. .. image:: imagenes/bodyStructureFooter.png
  210. El elemento ``<footer>`` de una página representa un pie de página para su seccion
  211. de contenido del antepasado más cercano o del elemento raíz seccionado. Un pie de
  212. página normalmente contiene información sobre su sección, como quién la
  213. escribió, enlaces a documentos relacionados, datos de copyright y similares.
  214. Cuando el elemento ``<footer>`` de la página contiene secciones enteras,
  215. representan apéndices, índices, colofones largos, acuerdos de licencia detallados
  216. y otros contenidos similares.
  217. Los elementos ``<footer>`` no necesariamente tienen que aparecer al final de una
  218. sección, aunque normalmente lo hacen.
  219. El elemento ``<footer>`` no secciona el contenido: no introduce una nueva sección.
  220. .. code-block:: html
  221. <body>
  222. <footer><a href="../">Regresa al Indice...</a></footer>
  223. <div>
  224. <h1>Lorem ipsum</h1>
  225. <p>The ipsum of all lorems</p>
  226. </div>
  227. <p>A dolor sit amet, consectetur adipisicing elit, sed do eiusmod
  228. tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim
  229. veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex
  230. ea commodo consequat. Duis aute irure dolor in reprehenderit in
  231. voluptate velit esse cillum dolore eu fugiat nulla
  232. pariatur. Excepteur sint occaecat cupidatat non proident, sunt in
  233. culpa qui officia deserunt mollit anim id est laborum.</p>
  234. <footer><a href="../">Regresa al Indice..</a></footer>
  235. </body>
  236. Algunos diseños de sitios web tienen lo que a veces se conoce como **fat footer**
  237. , ``footer`` de página que contienen una gran cantidad de material, incluyendo
  238. imágenes, enlaces a otros artículos, enlaces a páginas para enviar comentarios,
  239. En algunos aspectos, una 'página de inicio' completa en el pie de página.
  240. .. code-block:: html
  241. <body>
  242. <!-- Contenido... -->
  243. <footer>
  244. <nav>
  245. <section>
  246. <h2>Articulos</h2>
  247. <p><img src="https://images.template.net/wp-content/uploads/2014/09/Gym-Logo-E-G.jpg" alt="Elite Gym logo" width="50">
  248. ¡Ir al gimnasio con nuestra clase de saltos mortales!<br> Nuestro maestro Jim <br>
  249. te lleva a través de los pasos en este artículo en dos partes. <a href="articles/somersaults/1">Parte1</a>
  250. <a href="articles/somersaults/2">Parte 2</a></p>
  251. <p><img alt="Crossfit performance" src="https://image.freepik.com/free-vector/logo-for-a-gym_1195-54.jpg" width="50"> Cansado de caminar en el borde ?<br>
  252. Nuestra escritora invitada Lara le enseña a caminar a través de las barras.. <a href="articles/kindplus/1">Leermas...</a></p>
  253. <p><img alt="chips" src="http://www.molomart.com/uploads/images/chips.png" width="120"> Abandona las patatas fritas , engordar una barbaridad <a href="articles/crisps/1">Leer mas...</a></p>
  254. </section>
  255. <ul>
  256. <li> <a href="/about">Sobre nosotros...</a>
  257. <li> <a href="/feedback">Envia feedback!</a>
  258. <li> <a href="/sitemap">Sitemap</a>
  259. </ul>
  260. </nav>
  261. <p><small>Copyright © 2015 El Snacker — <a href="/tos">Terminos del servicio</a></small></p>
  262. </footer>
  263. </body>
  264. El elemento ``address``
  265. =======================
  266. El elemento ``<address>`` representa la información de contacto de su antecesor
  267. ``<article>`` o elemento ``<body>`` más próximo. Si ese es el elemento del
  268. ``<body>``, entonces la información de contacto se aplica al documento como un todo.
  269. .. code-block:: html
  270. <address>
  271. <a href="../gente/Raul/">Raul Vela Salas</a>,
  272. <a href="../gente/Jorge/">Jorge Maldonado Ventura </a>,
  273. Contactar con las personas <a href="activismo">W3C HTML activismo</a>
  274. </address>