atributos-globales.rst 7.7 KB

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