Wikipedia utiliza dos plantillas independientes para generar información sobre herramientas. La plantilla {{ abbr }} se utiliza para escribir una abreviatura (incluido un acrónimo o una sigla) con su significado ampliado. Es un contenedor para el elemento HTML . La plantilla {{ tooltip }} utiliza el elemento para proporcionar notas genéricas. <abbr>...</abbr><span>...</span>
{{abbr}}Utilice o únicamente <abbr>para marcar abreviaturas (incluyendo acrónimos y siglas). Su uso para generar información sobre herramientas en otros lugares es un uso indebido del HTML subyacente y causa problemas de accesibilidad . Para información sobre herramientas de uso general, utilice {{tooltip}}en su lugar.
Los lectores que utilizan dispositivos móviles normalmente no tienen un ratón para desplazarse por la página y, por lo tanto, no suelen ver el contenido de la información sobre herramientas. A partir de 2023, se han visto más páginas de Wikipedia en inglés en dispositivos móviles que en navegadores de escritorio.[1]
{{Tooltip|text to display inline in the article|pop-up tip}}
Dos parámetros sin nombre (posicionales) (obligatorios) y tres parámetros con nombre (opcionales):
.svg/1280px-Test_Template_Info-Icon_-_Version_(2).svg.png){kind=icon}
|1=– el término que se va a explicar; se muestra como texto. Se permite el marcado wiki , pero funciona de manera más consistente cuando se envuelve la plantilla; consulte a continuación ejemplos de enlaces.|2=– la información sobre herramientas o ventana emergente ( no se permite el marcado wiki ni HTML ). La ventana emergente se crea mediante un title=atributo HTML, por lo que no puede contener HTML (o marcado que se resuelva en HTML cuando se renderiza). Esto incluye cosas simples como ''italics''.|class= – una o más clases CSS (separadas por espacios si hay más de una)|id= – un ID HTML debe ser único en toda la página.|style= – CSS para aplicar al texto mostrado (sin efecto en la información sobre herramientas o ventana emergente). Todos los valores de estilo con espacios en blanco incrustados deben estar entre comillas simples, por ejemplo|style=font-family: 'Times New Roman', serif;Al pasar el cursor sobre el texto " LSD ", aparecerá algo como Louisiana School for the Deaf como información sobre herramientas en los navegadores de escritorio. Los dispositivos móviles pueden mostrar una línea de puntos u otro indicador visual de abreviatura, pero no proporcionarán la información sobre herramientas. Ningún lector de pantalla para personas con discapacidad visual leerá la expansión de forma predeterminada; algunos proporcionan una configuración opcional para leer la expansión en voz alta.
En el ejemplo anterior, cada abreviatura se amplía primero en el cuerpo del texto entre paréntesis. La plantilla ofrece una forma adicional para que algunos usuarios accedan al significado más adelante en el texto. Consulte MOS:ABBR para obtener más información.
En el ejemplo anterior, todas las abreviaturas se amplían mediante la plantilla. Esto no se recomienda porque es la única forma en que los usuarios pueden acceder al significado. Los usuarios que leen en un dispositivo móvil, leen una copia impresa o escuchan un lector de pantalla probablemente no tengan acceso al significado completo.
En el ejemplo anterior, todas las abreviaturas se expanden mediante la plantilla y se incorpora una oración completa mediante la plantilla. Es la única forma en que los usuarios pueden acceder al significado. Un usuario que lea en un dispositivo móvil, lea una copia impresa o escuche un lector de pantalla probablemente no tendrá acceso al significado completo de la abreviatura y no tendrá una indicación clara de que existe la nota al pie incorporada.
En la medida de lo posible, no se deben utilizar notas emergentes dentro del cuerpo del texto de un artículo (consulte MOS:NOTOOLTIPS ). Las notas emergentes genéricas no sustituyen a las notas a pie de página y están pensadas para utilizarse en la navegación y otras funciones secundarias en las que el espacio es limitado. Consulte Template:Glossary link o Template:Cite book/doc#Usage para ver ejemplos prácticos.
Para vincular mediante wiki la abreviatura marcada por esta plantilla, envuelva la plantilla en el enlace; de lo contrario, la información sobre herramientas no aparecerá en algunos navegadores.
La plantilla {{ Abbr }} está destinada únicamente para usarse con abreviaturas (incluidos acrónimos y siglas).
Las Pautas de Accesibilidad al Contenido Web contienen pautas para usar el <abbr>elemento generado por esta plantilla; consulte la sección H28: Proporcionar definiciones de abreviaturas mediante el uso de los elementos abbr y accordion. Las especificaciones HTML (tanto las del W3C como las de WHATWG ) definen estrictamente el <abbr>elemento como reservado para el marcado de abreviaturas. Abusar de él para las descripciones emergentes al pasar el mouse rompe nuestro marcado semántico y hace que nuestro contenido sea HTML no válido (pasará incorrectamente una prueba de validación automatizada básica porque dicha herramienta no puede determinar que la aplicación lógica de los datos a la estructura no es correcta, solo que las etiquetas están anidadas correctamente).
Los siguientes nombres de plantillas redirigirán a {{ Abbr }} :
{{ Tooltip }} es una plantilla separada que comparte la misma documentación.
TemplateData para información sobre herramientas
Información sobre herramientas genérica que se muestra al pasar el mouse por encima.