Reference Tooltips/pt-br



O Reference Tooltips é um recurso que mostra notas quando você paira sobre elas. Uma dica aparece logo na linha, sem precisar rolar até o final da página.

Essa funcionalidade está ativada por padrão em várias wikis e usuários podem desativá-la acessando as opções de funcionalidades, que coloca um cookie; usuários autenticados podem desativar permanentemente na aba de Gadgets de Especial:Preferências.

Sobre
O script foi originalmente desenvolvido por User:Yair rand em 2012 e retrabalhado por User:Jack who built the house em 2019. Para instalar o gadget na sua wiki, você precisa transferir os seguintes arquivos lá:


 * w:MediaWiki:Gadget-ReferenceTooltips.js
 * Replace  with the appropriate URL for your own wiki (as of 27 April 2020, this is around line 479); failing to do so may cause an exception in the JavaScript console, and the tooltips will fail to show up
 * w:MediaWiki:Gadget-ReferenceTooltips.css
 * Add the line "ReferenceTooltips[ResourceLoader|default|type=general|dependencies=mediawiki.cookie,jquery.client]|ReferenceTooltips.js|ReferenceTooltips.css" to MediaWiki:Gadgets-definition
 * Create a description for the gadget to be displayed in the user preferences by editing MediaWiki:Gadget-ReferenceTooltips on your wiki; copy-paste the content from w:MediaWiki:Gadget-ReferenceTooltips, or create your own if you wish

O gadget irá então ser carregado por padrão na wiki.

Para a funcionalidade normal do script, as seguintes dependências são necessárias: mediawiki.cookie, jquery.client. há também de ser carregado.

Justificativa
Atualmente, os sites Wikimedia listam todas as referências no fim do artigo. Para artigos maiores, especialmente aqueles com muitas referências, isso é deficiente. Checar as referências de um artigo requer severas viagens sobre todo o tamanho do artigo, no tempo que o leitor vai frequentemente se perder.

Hipótese
Essa é uma funcionalidade de usabilidade geral. É uma hipótese que leitores serão mais prováveis a ler as referências se elas são imediatamente acessíveis sem precisar viajar o tamanho da página inteiro.



Trabalho atual
Nos artigos, uma afirmação é referenciada com uma ligação interna sobrescrita. Clicar nessa ligação levará o usuário até o rodapé da página para toda a lista de referências. A referência específica é então destacada. O usuário então clica na ligação lá e a referência da ligação externa é aberto.



Experiência do usuário
Quando um usuário pairar seu mouse sobre a ligação de citação sobrescrita num artigo, uma tooltip aparece em cima que inclui a nota de referência. O usuário pode então mover seu mouse no cartão e clicar na(s) ligação(ões) lá para abrir referências externas.

Clicar na ligação de referência sobrescrita se comporta normalmente (o usuário é levado a lista de referências).



JavaScript e considerações de tablet
Esse recurso necessita de JavaScript. Navegadores com o JavaScript desativado não terão esse recurso.

Esse recurso pode não ser utilizável com tablets e outras interfaces touch screen sem a eliminação do atual comportamento de "clicar te leva a lista de referências".

Configurações
Para editar as configurações desse gadget, paire sobre uma citação para que a tooltip apareça, então clique no ícone de engrenagem. Você pode ativar as seguintes opções:


 * Se a tooltip aparece ao pairar sobre a citação ou ao clicar
 * O atraso antes da tooltip aparecer (por padrão 200 milisegundos)
 * Se aparecerá uma tooltip para abreviações dentro das etiquetas de . (Exemplo: "abbr. ")



Ver também

 * w:User talk:Yair rand/ReferenceTooltips – discussão
 * – alternative implementation as an extension
 * – alternative implementation as an extension