Буквица:Гаджеты/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, экспериментально)» в настройках в принципе делает то же самое, но при этом меняет поведение стандартных кнопок предпросмотра и изменения, и запрашивает с сервера полный код страницы (без экономии трафика).