Wikilivros:Gadgets/ajaxPrev

O script do Gadget "ajaxPrev" adiciona novos botões AJAX Previsão e Alterações para a edição de páginas. Algumas de suas características:

• Eles são mais rápidos que os botões usuais,
• Eles preservam a posição do cursor e o histórico de uso do (Ctrl-Z) para desfazer ações na janela de edição,
• O botão para previsão usa menos tráfego.

Note que o botão padrão «Antever resultado» ainda é exigido:

• Para atualizar a previsão de categorias, interwikis, sumário de edição e a lista de predefinições usadas;
• Depois de inserir <source lang="xxx"> ou <categorytree> pela primeira vez.

Configuração

Por padrão os novos botões:

• São colocados à direita da barra de ferramentas:

BIAb........................   previewchanges

• Capturam as teclas de atalho p e v dos botões padrão.
• Recebem um nome baseado nos botões padrão (usando apenas a última palavra).

Isto pode ser alterado com os seguintes parâmetros em seu monobook.js.

Posição:

ajaxPreviewPos = 'left' //botões a esquerda

ajaxPreviewPos = 'bottom' //botões abaixo da janela de edição, substituindo os usuais

Assim os botões usuais são movidos para a direita e marcados com ">": Gravar página Previsão> Alterações>

Teclas de atalho:

ajaxPreviewKey = 'o' //tecla de atalho do botão "Previsão"
ajaxDiffKey = 'b' //tecla de atalho do botão "Alterações"

Use uma sequência vazia de caracteres '' para desabilitar uma tecla de atalho.

Texto dos botões:

ajaxPreviewButton = 'Ω' //texto do botão "Previsão"
ajaxDiffButton = 'Δ' //texto do botão "Alterações"

Rolar a página:

ajaxPreviewScrollTop = true //rola a página para o topo da área de previsão/alterações depois de cada atualização.

Compatibilidade com outros scripts

O script chama automaticamente os scripts para tabelas ordenáveis e expansíveis depois de cada atualização de exibição.

Você pode fazer ele chamar scripts personalizados definindo a função ajaxPreviewExec(). Por exemplo, se você usa NavPopups e quer que elas apareçam ao atualizar a pré-visualização usando Ajax, use o seguinte código:

ajaxPreviewExec = function(previewArea){ //código que será executado ao prever uma edição usando Ajax
  if (window.setupTooltips) setupTooltips(previewArea)
}

Notas

• O script deve funcionar em todos os navegadores modernos, exceto betas antigos do Firefox 3.
• O script foi testado no Firefox 1.5, 2 e 3, Opera 9.27 e 9.52, IE 6 e 7.
• O botão «Previsão» usa o parâmetro &live de index.php, exatamente da mesma forma que o Live preview que está desabilitado aqui.
• O botão «Alterações» tem que enviar e receber toda a página, uma vez que o MediaWiki não pode retornar alterações "raw".

Ver também

• User:Js/ajaxPreview - Documentação original na Wikipédia inglesa, por w:en:User:Alex Smotrov.