secciones.rst 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458
  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="en">
  18. <head>
  19. <title>Comprobar estado navegador</title>
  20. <script>
  21. function update(online) {
  22. document.getElementById('status').textContent = online ? 'Online' : 'Offline';
  23. }
  24. </script>
  25. </head>
  26. <body ononline="update(true)"
  27. onoffline="update(false)"
  28. onload="update(navigator.onLine)">
  29. <p>You are : <span id="status">(Unknown)</span></p>
  30. </body>
  31. </html>
  32. En este ejemplo podemos ver como se le asocia a los distintos eventos
  33. **ononline**, **onoffline** un metodo predefinido por el programador el cual
  34. recibe por parametro un valor booleano y mediante la propiedad **onLine** del
  35. objeto ``navigator`` muestra en la etiqueta ``<span>`` si el navegador
  36. esta conectado a internet.
  37. El elemento ``article``
  38. =======================
  39. El elemento de ``<article>`` representa una composición completa o autónoma
  40. en un documento, una página, una aplicación o un sitio web. Esto podría ser una
  41. revista, un periódico, un artículo técnico o académico, un ensayo o informe,
  42. un blog u otro mensaje de medios sociales.
  43. Cada ``<article>`` debe ser identificado, típicamente incluyendo un encabezado
  44. elemento (``<h1>``, ``<h2>``...) como un elemento hijo del elemento del
  45. ``<article>``.
  46. .. code-block:: html
  47. <article>
  48. <header>
  49. <h2><a href="https://www.w3.org/TR/html51/">Indice de contenidos</a></h2>
  50. <p>Posteado el Domingo, 1 Enero 2017 por Raul Vela Salas.
  51. <a href="https://www.w3.org/TR/html51/sections.html#sections">Ejemplo de secciones</a></p>
  52. </header>
  53. <p>En esta parte podemos encontrar todo tipo de elementos y referencias relacionado con las secciones
  54. de la version mas reciente de HTML 5.1 , es por ello que es importante tenerla de referencia</p>
  55. <p><a href="https://www.w3.org/TR/html51/index.html#contents/">Continúa leyendo más sobre este tema</a></p>
  56. </article>
  57. El elemento ``section``
  58. =======================
  59. .. image:: imagenes/bodyStructureSection.png
  60. El elemento ``<section>`` representa una sección genérica de un documento o aplicación.
  61. Una ``<section>`` en este contexto es una agrupación temática de contenido.
  62. Cada ``<section>`` debe identificarse, típicamente incluyendo un encabezado del
  63. elemento ``<h1>``-``<h6>`` como hijo del elemento de la sección.
  64. .. code-block:: html
  65. <article>
  66. <header>
  67. <h2>Manzanas</h2>
  68. <p>¡Sabrosa, deliciosa fruta!</p>
  69. </header>
  70. <p>La manzana es la fruta pomácea del manzano.</p>
  71. <section aria-label="Manzanas rojas.">
  72. <h3>Delicionas Rojas</h3>
  73. <p>Estas manzanas rojas brillantes son las más comunes que se encuentran en muchos supermercados.</p>
  74. </section>
  75. <section aria-label="Manzanas verdes.">
  76. <h3>Granny Smith</h3>
  77. <p>Estas jugosas manzanas verdes hacen un gran relleno para pasteles de manzana.</p>
  78. </section>
  79. </article>
  80. El elemento ``nav``
  81. ===================
  82. .. image:: imagenes/bodyStructureNav.png
  83. El elemento ``<nav>`` representa una sección de una página que enlaza con otras
  84. páginas o con partes de la página. Es una sección con vínculos de navegación.
  85. .. code-block:: html
  86. <body>
  87. <h1>Ejemplo de la etiqueta nav</h1>
  88. <nav>
  89. <ul>
  90. <li><a href="/">Principal</a></li>
  91. <li><a href="/events">Eventos Actuales</a></li>
  92. </ul>
  93. </nav>
  94. <article>
  95. <header>
  96. <h2>Ejemplo de nav</h2>
  97. <p>Creado por R.V.S.</p>
  98. </header>
  99. <nav>
  100. <ul>
  101. <li><a href="#publico">Demostracion Pública </a></li>
  102. <li><a href="#destruir">Destruir</a></li>
  103. </ul>
  104. </nav>
  105. <div>
  106. <section id="publico">
  107. <h2>Demostracion Pública</h2>
  108. <p>...mas contenido...</p>
  109. </section>
  110. <section id="destruir">
  111. <h2>Destruir</h2>
  112. <p>...mas contenido...</p>
  113. </section>
  114. </div>
  115. <footer>
  116. <p><a href="?editar">Editar</a> | <a href="?delete">Borrar</a> | <a href="?Rename">Renombrar</a></p>
  117. </footer>
  118. </article>
  119. <footer>
  120. <p><small>Ejemplo proporcionado por HTML 5.1</small></p>
  121. </footer>
  122. </body>
  123. El elemento ``aside``
  124. =======================
  125. .. image:: imagenes/bodyStructureAside.png
  126. El elemento ``<aside>`` representa una sección de una página que consiste en
  127. contenido que está relacionado con el contenido principal de la sección del elemento
  128. padre y que podría considerarse por separado de ese contenido principal.
  129. Las secciones se representan a menudo como barras laterales.
  130. El elemento se puede utilizar para efectos tipográficos como barras laterales,
  131. para publicidad, para grupos de elementos de navegación y para otros contenidos
  132. que se consideran separados del contenido principal.
  133. .. code-block:: html
  134. <body>
  135. <header>
  136. <h1>Mi maravilloso blog/h1>
  137. <p>Mi linea principal</p>
  138. </header>
  139. <aside>
  140. <!-- Este apartado contiene dos secciones que están tangencialmente relacionadas
  141. con la página, enlaces a otros blogs, y enlaces a posts
  142. de este blog -->
  143. <nav>
  144. <h2>Mi enlace a otros blogs</h2>
  145. <ul>
  146. <li><a href="https://www.example.com//">Ejemplo de Enlace a un Dominio</a>
  147. </ul>
  148. </nav>
  149. <nav>
  150. <h2>Archivos</h2>
  151. <ol reversed>
  152. <li><a href="/last-post">Mi ultima publicacion</a>
  153. <li><a href="/first-post">Mi primera publicacion</a>
  154. </ol>
  155. </nav>
  156. </aside>
  157. <aside>
  158. <!-- Este ``aside`` es tangencialmente relacionado con la página también,
  159. contiene mensajes de twitter desde el autor del blog -->
  160. <h2>Twitter</h2>
  161. <blockquote cite="https://twitter.example.net/t31351234">
  162. Estoy de vacaciones , escribiendo en mi blog
  163. </blockquote>
  164. <blockquote cite="https://twitter.example.net/t31219752">
  165. Me iré de vacaciones pronto..
  166. </blockquote>
  167. </aside>
  168. <article>
  169. <!-- Esto es una publicacion de blog -->
  170. <h2>Mi ultima publicacion</h2>
  171. <p>Este es mi ultima publicacion</p>
  172. <footer>
  173. <p><a href="/last-post" rel=bookmark>Permalink</a>
  174. </footer>
  175. </article>
  176. <article>
  177. <!-- Este tambien es mi ultima publicacion de blog -->
  178. <h2>Mi primera publicacion</h2>
  179. <p>Esta es mi primera publicacion.</p>
  180. <aside>
  181. <!-- Este aparte es sobre la publicación del blog, ya que es dentro del elemento
  182. <article>; sería erróneo, por ejemplo, poner el blogroll desde
  183. aquí, ya que el blogroll no es realmente relacionado con este post
  184. en concreto, sólo a la página como un todo -->
  185. <h1>Publicando</h1>
  186. <p>Mientras estoy pensando esto, quería decir algo sobre
  187. que publicar. ¡Publicar es divertido!</p>
  188. </aside>
  189. <footer>
  190. <p><a href="/first-post" rel=bookmark>Permalink</a>
  191. </footer>
  192. </article>
  193. <footer>
  194. <nav>
  195. <a href="/archives">Archivos</a>
  196. <a href="/about">Sobre mi</a>
  197. <a href="/copyright">Copyleft</a>
  198. </nav>
  199. </footer>
  200. </body>
  201. Los elemento ``h1``, ``h2``, ``h3``, ``h4``, ``h5`` y ``h6``
  202. ============================================================
  203. Estos elementos representan **encabezados** para sus secciones.
  204. Estos elementos tienen un **rango** dado por el número que acompaña a su nombre.
  205. El elemento ``<h1>`` tiene el rango **más alto**, el elemento ``<h6>`` tiene el rango
  206. **más bajo**, y dos elementos con el mismo nombre tienen mismo rango.
  207. .. code-block:: html
  208. <body>
  209. <h1>Más alto nivel de rango del encabezado</h1>
  210. <section><h2>Segundo nivel de encabezado</h2>
  211. <section><h3>Tercer nivel de encabezado</h3>
  212. <section><h4>Cuarto nivel de encabezado</h4>
  213. <section><h5>Quinto nivel de encabezado</h5>
  214. <section><h6>Sexto nivel de encabezado</h6>
  215. </section>
  216. </section>
  217. </section>
  218. </section>
  219. </section>
  220. </body>
  221. El elemento ``header``
  222. ======================
  223. .. image:: imagenes/bodyStructureHeader.png
  224. El elemento ``<header>`` representa un grupo de ayudas introductorias
  225. o de navegación. Puede contener algunos elementos de encabezado, pero también
  226. otros elementos como un logo, una sección que aglutine secciones de encabezados,
  227. una formulario de búsqueda o cosas parecidas.
  228. Cuando el ancestro más cercano como las secciones de contenido ``<article>``
  229. ``<aside>`` ``<nav>`` ``<sectiono>`` o de la secciones de raiz ``<blockquote>``
  230. ``<body>`` ``<details>`` ``<fieldset>`` ``<figure>`` ``<td>`` son un elemento
  231. del ``<body>``, entonces es aplicado a toda la página.
  232. .. code-block:: html
  233. <!DOCTYPE html>
  234. <html>
  235. <head>
  236. <title></title>
  237. </head>
  238. <body>
  239. <header>
  240. <h1>Graficos Vectoriales Escalables (SVG) 1.2</h1>
  241. <p>W3C 2017</p>
  242. <dl>
  243. <dt>Actual versión:</dt>
  244. <dd><a href="https://www.w3.org/TR/2004/WD-SVG12-20041027/">https://www.w3.org/TR/2004/WD-SVG12-20041027/</a></dd>
  245. <dt>Anterior version:</dt>
  246. <dd><a href="https://www.w3.org/TR/2004/WD-SVG12-20040510/">https://www.w3.org/TR/2004/WD-SVG12-20040510/</a></dd>
  247. <dt>Anterior version de SVG 1.2:</dt>
  248. <dd><a href="https://www.w3.org/TR/SVG12/">https://www.w3.org/TR/SVG12/</a></dd>
  249. <dt>La última recomendación de SVG :</dt>
  250. <dd><a href="https://www.w3.org/TR/SVG/">https://www.w3.org/TR/SVG/</a></dd>
  251. <dt>Editor:</dt>
  252. <dd>Dean Jackson, W3C, <a href="mailto:dean@w3.org">dean@w3.org</a></dd>
  253. <dt>Autor:</dt>
  254. <dd>Ver <a href="#authors">Lista de autores</a></dd>
  255. </dl>
  256. <p class="copyright"><a href="https://www.w3.org/Consortium/Legal/ipr-notic"></a></p>
  257. </header>
  258. </body>
  259. </html>
  260. El elemento de ``header`` no secciona el contenido: **no introduce una nueva sección**.
  261. El elemento ``footer``
  262. ======================
  263. .. image:: imagenes/bodyStructureFooter.png
  264. El elemento ``<footer>`` de una página representa un pie de página para su seccion
  265. de contenido del antepasado más cercano o del elemento raíz seccionado. Un pie de
  266. página normalmente contiene información sobre su sección, como quién la
  267. escribió, enlaces a documentos relacionados, datos de copyright y similares.
  268. Cuando el elemento ``<footer>`` de la página contiene secciones enteras,
  269. representan apéndices, índices, colofones largos, acuerdos de licencia detallados
  270. y otros contenidos similares.
  271. Los elementos ``<footer>`` no necesariamente tienen que aparecer al final de una
  272. sección, aunque normalmente lo hacen.
  273. El elemento ``<footer>`` no secciona el contenido: no introduce una nueva sección.
  274. .. code-block:: html
  275. <body>
  276. <footer><a href="../">Regresa al Indice...</a></footer>
  277. <div>
  278. <h1>Lorem ipsum</h1>
  279. <p>The ipsum of all lorems</p>
  280. </div>
  281. <p>A dolor sit amet, consectetur adipisicing elit, sed do eiusmod
  282. tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim
  283. veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex
  284. ea commodo consequat. Duis aute irure dolor in reprehenderit in
  285. voluptate velit esse cillum dolore eu fugiat nulla
  286. pariatur. Excepteur sint occaecat cupidatat non proident, sunt in
  287. culpa qui officia deserunt mollit anim id est laborum.</p>
  288. <footer><a href="../">Regresa al Indice..</a></footer>
  289. </body>
  290. Algunos diseños de sitios web tienen lo que a veces se conoce como **fat footer**
  291. , ``footer`` de página que contienen una gran cantidad de material, incluyendo
  292. imágenes, enlaces a otros artículos, enlaces a páginas para enviar comentarios,
  293. En algunos aspectos, una 'página de inicio' completa en el pie de página.
  294. .. code-block:: html
  295. <body>
  296. <!-- Contenido... -->
  297. <footer>
  298. <nav>
  299. <section>
  300. <h2>Articulos</h2>
  301. <p><img src="/https://images.template.net/wp-content/uploads/2014/09/Gym-Logo-E-G.jpg" alt="Elite Gym logo" width="50">
  302. ¡Ir al gimnasio con nuestra clase de saltos mortales!<br> Nuestro maestro Jim <br>
  303. te lleva a través de los pasos en este artículo en dos partes. <a href="articles/somersaults/1">Parte1</a>
  304. · <a href="articles/somersaults/2">Parte 2</a></p>
  305. <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>
  306. Nuestra escritora invitada Lara le enseña a caminar a través de las barras.. <a href="articles/kindplus/1">Leermas...</a></p>
  307. <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>
  308. </section>
  309. <ul>
  310. <li> <a href="/about">Sobre nosotros...</a>
  311. <li> <a href="/feedback">Envia feedback!</a>
  312. <li> <a href="/sitemap">Sitemap</a>
  313. </ul>
  314. </nav>
  315. <p><small>Copyright © 2015 El Snacker — <a href="/tos">Terminos del servicio</a></small></p>
  316. </footer>
  317. </body>
  318. El elemento ``address``
  319. =======================
  320. El elemento de ``<address>`` representa la información de contacto de su antecesor
  321. ``<article>`` o elemento de ``<body>`` más próximo. Si ese es el elemento del
  322. ``<body>``, entonces la información de contacto se aplica al documento como un todo.
  323. .. code-block:: html
  324. <address>
  325. <a href="../gente/Raul/">Raul Vela Salas</a>,
  326. <a href="../gente/Jorge/">Jorge Maldonado Ventura </a>,
  327. Contactar con las personas <a href="activismo">W3C HTML activismo</a>
  328. </address>
  329. ``Encabezamientos`` y ``secciones``
  330. ===================================
  331. Los elementos ``<h1>``-``<h6>`` son encabezados.
  332. El primer elemento del contenido del encabezado en un elemento de seccion de
  333. contenido que representa el encabezado para esa sección.
  334. Los encabezamientos posteriores de rango son iguales o superiores y comienzan
  335. nuevas secciones **implícitas**, los encabezamientos de menor rango comienzan
  336. subsecciones que son parte de la anterior. En ambos casos, el elemento
  337. representa el encabezado de la sección implícita.
  338. Los elementos ``<h1>``-``<h6>`` no deben usarse para subrayar subtítulos, títulos
  339. alternativos y etiquetas de linea a menos que se prevea que sean el encabezado
  340. de una nueva sección o subsección. En su lugar utilice los patrones de marcado.
  341. Lenguajes comunes sin elementos dedicados sección de la especificación.
  342. Se dice que ciertos elementos están en las secciones de las raíces, incluyendo los
  343. elementos ``<blockquote>`` y ``<td>``. Estos elementos pueden tener sus propios
  344. contornos, pero las secciones y encabezamientos dentro de estos elementos no
  345. contribuyen a los contornos de sus ancestros como son
  346. ``<blockquote>`` , ``<body>`` , ``<details>`` , ``<fieldset>`` , ``<figure>`` , ``<td>``
  347. Las secciones de elementos de contenido siempre se consideran subsecciones de su
  348. raíz ancestro más cercano o de su elemento ancestro más cercano al contenido de
  349. sección, independientemente de qué secciones implícitas podrían haber creado otros títulos.
  350. .. code-block:: html
  351. <body>
  352. <h1>Foo</h1>
  353. <h2>Bar</h2>
  354. <blockquote>
  355. <h3>Bla</h3>
  356. </blockquote>
  357. <p>Baz</p>
  358. <h2>Quux</h2>
  359. <section>
  360. <h3>Thud</h3>
  361. </section>
  362. <p>Grunt</p>
  363. </body>
  364. La estructura sería:
  365. **Foo** (encabezamiento de la sección explícita del cuerpo, que contiene el párrafo 'Grunt')
  366. **Bar** - Partida que comienza la sección implícita, que contiene una cita de bloque y el párrafo **Baz**
  367. **Quux** - No hay contenido aparte del encabezado
  368. **Thud** - Título de sección explícita
  369. **Observe** - La sección termina en una sección implícita anterior de modo que un párrafo posterior **Grunt** vuelve al nivel superior.
  370. Otro ejemplo muestra la forma correcta de editarlo
  371. .. code-block:: html
  372. <body>
  373. <h1>Apples</h1>
  374. <p>Apples are fruit.</p>
  375. <section>
  376. <h2>Taste</h2>
  377. <p>They taste lovely.</p>
  378. <section>
  379. <h3>Sweet</h3>
  380. <p>Red apples are sweeter than green ones.</p>
  381. </section>
  382. </section>
  383. <section>
  384. <h3>Color</h3>
  385. <p>Apples come in various colors.</p>
  386. </section>
  387. </body>