atributos-globales.rst 7.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259
  1. ==================
  2. Atributos globales
  3. ==================
  4. Los atributos globales de HTML pueden ser utilizados con cualquier elemento.
  5. ``accesskey``
  6. =============
  7. El atributo ``accesskey`` es usado por el navegador para crear un atajo de
  8. teclado que active o se centre en el elemento.
  9. Los valores permitidos son caracteres imprimibles, excepto " " y caracteres que
  10. normalmente requieren pulsar varias teclas para escribirse.
  11. La operación para activar el ``accesskey`` depende del navegador de de la
  12. plataforma: https://developer.mozilla.org/es/docs/Web/HTML/Atributos_Globales/accesskey.
  13. El siguiente ejemplo nos permite acceder a las secciones numeradas de un
  14. documento usando atajos de teclado...
  15. .. code-block:: html
  16. <ul>
  17. <li><a accesskey="1" href="#1">Sección 1</a></li>
  18. <li><a accesskey="2" href="#2">Sección 2</a></li>
  19. <li><a accesskey="3" href="#3">Sección 3</a></li>
  20. </ul>
  21. ``class``
  22. =========
  23. Las clases permiten a CSS y JavaScript seleccionar y acceder a elementos
  24. específicos a través de selectores de clases o funciones DOM.
  25. Sus valores son una lista de separada por espacios de las clases del elemento.
  26. .. code-block:: html
  27. <head>
  28. <title>Importante</title>
  29. <style>
  30. h1.intro {
  31. color: blue;
  32. }
  33. .importante {
  34. font-size: large;
  35. }
  36. </style>
  37. </head>
  38. <body>
  39. <h1 class="intro importante">Encabezado importante</h1>
  40. <p class="importante">Atención: este párrafo es importante</p>
  41. </body>
  42. ``contenteditable``
  43. ===================
  44. Si se añade este atributo a un elemento, este puede ser modificado por el
  45. usuario. Por ejemplo, podemos hacer que el usuario pueda modificar un
  46. párrafo de un texto.
  47. .. code-block:: html
  48. <h2>Ejercicios de preposiciónes</h2>
  49. <p contenteditable>Me llamó ____ ir al cine</p>
  50. <p contenteditable>Esto servirá ____ dormir</p>
  51. <h2>Escribe una redacción usando las preposiciones que has aprendido</h2>
  52. <p contenteditable>El otro día fuimos... (continúa escribiendo)</p>
  53. ``contextmenu``
  54. ===============
  55. Permite crear un menú contextual. Puede contener menús con varios niveles de
  56. anidamiento. En la siguiente imagen se muestra la apariencia de este menú en
  57. el navegador Abrowser, el correspondiente código fuente se encuentra debajo
  58. de la imagen.
  59. .. image:: imagenes/contextmenu.png
  60. .. code-block:: html
  61. <div contextmenu="mymenu">
  62. <p>Usa el botón izquierdo del ratón aquí para ver el menú contextual</p>
  63. <menu type="context" id="mymenu">
  64. <menuitem label="Recargar" onclick="window.location.reload();"></menuitem>
  65. <menu label="Otro menú">
  66. <menu label="Y otro más">
  67. <menuitem label="Nivel 3"></menuitem>
  68. </menu>
  69. <menuitem label="kasjdh1"></menuitem>
  70. <menuitem label="2asd"></menuitem>
  71. <menuitem label="asda3"></menuitem>
  72. <menuitem label="4asd"></menuitem>
  73. <menuitem label="5"></menuitem>
  74. </menu>
  75. <menuitem label="Envía esta página por correo electrónico" onclick="window.location='mailto:?body='+window.location.href;"></menuitem>
  76. </menu>
  77. </div>
  78. ``dir``
  79. =======
  80. Establece la dirección del texto. Su valor ser de ``ltr`` (izquierda a
  81. derecha, *left to right*), ``rtl`` (de derecha a izquierda, *right to left*)
  82. o ``auto`` (la dirección debe ser determinada mirando el contenido). Este
  83. atributo es muy útil para idiomas que se escriben de derecha a izquierda.
  84. .. code-block:: html
  85. <p dir="rtl" lang="ar">للسيارات تابعة لمطار لودريدل بولاية فلوريدا الأميركية.<p>
  86. ``draggable``
  87. =============
  88. Sirve para indicar si el elemento puede ser arrastrado mediante la acción del
  89. usuario (por ejemplo usando el ratón). Puede tener tres estados: ``true``,
  90. ``false`` y ``auto``.
  91. .. code-block:: html
  92. <!DOCTYPE HTML>
  93. <html lang="es">
  94. <head>
  95. <meta charset="UTF-8">
  96. <style>
  97. #div1 {
  98. width: 350px;
  99. height: 70px;
  100. padding: 10px;
  101. border: 1px solid #aaaaaa;
  102. }
  103. </style>
  104. <script>
  105. function allowDrop(ev) {
  106. ev.preventDefault();
  107. }
  108. function drag(ev) {
  109. ev.dataTransfer.setData("Text", ev.target.id);
  110. }
  111. function drop(ev) {
  112. var data = ev.dataTransfer.getData("Text");
  113. ev.target.appendChild(document.getElementById(data));
  114. ev.preventDefault();
  115. }
  116. </script>
  117. </head>
  118. <body>
  119. <div id="div1" ondrop="drop(event)" ondragover="allowDrop(event)"></div>
  120. <br>
  121. <p id="drag1" draggable="true" ondragstart="drag(event)">Este párrafo
  122. puede ser arrastrado. Ponlo dentro del rectángulo.</p>
  123. </body>
  124. </html>
  125. ``dropzone``
  126. ============
  127. Indica qué tipos de contenido pueden ser soltados en un elemento, usando la
  128. `API drag and drop <https://developer.mozilla.org/es/docs/DragDrop/Drag_and_Drop>`__.
  129. Puede tener los siguientes valores:
  130. - ``copy``. Indica que el soltado creará una copia del elemento que fue arrastrado.
  131. - ``move``. Indica que el elemento que fue arrastrado será movido a su nueva localización.
  132. ``hidden``
  133. ==========
  134. El elemento al que se añade este atributo no es visible por el usuario.
  135. .. code-block:: html
  136. <p hidden>Este párrafo está oculto</p>
  137. ``id``
  138. ======
  139. Es un identificador único para un elemento. Permite diferenciar un elemento
  140. de otros de forma única y precisa.
  141. .. code-block:: html
  142. <p id="documento-de-identidad-de-alguien">21312312P</p>
  143. ``lang``
  144. ========
  145. Indica el idioma del contenido de un elemento.
  146. .. code-block:: html
  147. <p><div lang="de">Ich spreche kein Russisch</div>, aunque sí puedo hablar
  148. castellano, alemán e inglés.</p>
  149. ``spellcheck``
  150. ==============
  151. Indica si se debe comprobar si el elemento contiene errores de sintaxis.
  152. Puede tener los siguientes valores:
  153. - ``true``. Indica que, si es posible, el elemento debería ser analizado para
  154. detectar errores de sintaxis.
  155. - ``false``. Indica que el elemento no debe ser analizado para encontrar
  156. errores de sintaxis.
  157. .. code-block:: html
  158. <input spellcheck="true">
  159. ``style``
  160. =========
  161. Permite especifar reglas de estilo para cambiar la aparciencia del documento.
  162. Se recomienda evitar su uso, pues es mejor usar los
  163. atributos ``id`` y ``class`` y los selectores CSS para lograr indenpendencia
  164. entre el diseño y el contenido.
  165. .. code-block:: html
  166. <p style="text-align: center;">Párrafo centrado</p>
  167. ``tabindex``
  168. ============
  169. Indica el orden en el que obtienen el foco los elementos.
  170. .. code-block:: html
  171. <a href="https://searx.me/" tabindex="2">searX</a><br>
  172. <a href="https://trisquel.info/" tabindex="1">Trisquel</a><br>
  173. <a href="https://www.gnu.org/" tabindex="3">GNU</a>
  174. <p>Intenta elegir un enlace pulsando <kbd>Tabulador</kbd></p>
  175. ``title``
  176. =========
  177. Se usa para añadir información consultiva a un elemento, que pueda ser útil
  178. para mostrar texto de ayuda para el usuario. En un enlace, esto podría ser
  179. el título o la descripción del recurso enlazado; en una imagen, podría ser
  180. la atribución o la descripción de la imagen; en un cita, podría ser más
  181. información sobre la fuente...
  182. .. code-block:: html
  183. <p>Estoy interesado en aprender a usar el sistema operativo
  184. <abbr title="GNU's Not Unix">GNU</abbr>. Como núcleo usaré Linux-libre.</p>
  185. ``translate``
  186. =============
  187. Puede tener dos valores: ``yes`` y ``no``.
  188. Si se establece el valor ``yes``, el contenido del elemento debe ser
  189. traducido a otros idiomas.