Буквица:Гаджеты/Ajax-предпросмотр

Шаблон:Википедия:Гаджеты/ Ajax-предпросмотр — гаджет, в режиме редактирования добавляющий Ajax кнопки «просмотр» и «изменения».

Благодаря отсутствию перезагрузки всей страницы достигается:

• более быстрое обновление,
• экономия трафика,
• сохранение положения курсора и возможности отмен изменений (по Ctrl-Z) в редактируемом тексте.

Особенности кнопки «просмотр»

Кнопка «предпросмотр» обновляет только область основного текста и описания правки и затем запускает на выполнение скрипты для сворачивающихся блоков и для сортируемых таблиц.

Shift-клик по кнопке также обновит отображение интервик, категорий и шаблонов.

В некоторых случаях по-прежнему нужен обычный предпросмотр, перезагружающий всю страницу:

• когда в вики-код в первый раз был вставлен <syntaxhighlight lang="xxx"> или <categorytree>,
• для выполнения на результате предпросмотра любых других скриптов.

Дополнительные возможности

• При редактировании раздела в предпросмотре будут показаны сноски без добавления <references /> вручную.
• При редактировании старой версии страницы shift-клик по кнопке «изменения» покажет изменения по сравнению с редактируемой версией, а не с самой последней.
• При редактировании .js или .css страницы гаджет покажет предпросмотр с подсветкой синтаксиса.

Настройка

Некоторые параметры для гаджета можно добавить в свой .js файл.

Положение кнопок

По умолчанию кнопки показываются справа от верхней панели кнопок вставки:

""→«» ж к Аб ... ... ... ... ... ...      просмотр  изменения 

Можно переместить их налево, указав

ajaxPreviewPos = 'left' //кнопки слева

Также можно переместить их на место соответствующих обычных кнопок под окном редактирования, «вытесняя» тех вправо:

ajaxPreviewPos = 'bottom' //кнопки внизу

 Записать страницу   Предварительный просмотр  >   Внесённые изменения  > 

Клавиши быстрого вызова

По умолчанию новые кнопки забирают сочетания клавиш браузера (p для просмотра и v для изменений) у соответствующих обычных кнопок. Это можно изменить с помощью следующих параметров:

ajaxPreviewKey = 'o'
ajaxDiffKey = 'b'

Пустая строка ('') означает, что новая кнопка не будет иметь быстрого сочетания клавиш.

Названия кнопок

По умолчанию кнопки имеют названия «просмотр» и «изменения». Это можно изменить с помощью следующих параметров:

ajaxPreviewButton = 'Ω'
ajaxDiffButton = 'Δ'

Более полный предпросмотр

Следующий параметр заставить скрипт всегда обновлять предпросмотр интервик, категорий и шаблонов (shift-клик тогда имеет обратное действие).

ajaxPreviewFull = true

Замечания

• Код гаджета: MediaWiki:Gadget-preview.js.
• Опция «Использовать быстрый предварительный просмотр (JavaScript, экспериментально)» в настройках в принципе делает то же самое, но при этом меняет поведение стандартных кнопок предпросмотра и изменения, и запрашивает с сервера полный код страницы (без экономии трафика).