Википедия:Гаджеты/Быстрый предпросмотр
Быстрый предпросмотр — гаджет, в режиме редактирования добавляющий кнопки «Просмотр» и «Изменения», при нажатии на которые не происходит перезагрузки страницы.
Благодаря отсутствию перезагрузки всей страницы достигается:
- более быстрое обновление,
- экономия трафика,
- сохранение положения курсора и возможности отмен изменений (по Ctrl Z) в редактируемом тексте.
Опция «Показывать предпросмотр без перезагрузки страницы» в настройках, в принципе, делает то же самое, но при этом меняет поведение стандартных кнопок предпросмотра и изменения и запрашивает с сервера полный код страницы (без экономии трафика)[обновить данные].
Особенности кнопки «Просмотр»
[править код]Кнопка «Просмотр» обновляет только область основного текста и описания правки. Нажатие кнопки с зажатым ⇧ Shift также обновит отображение категорий и шаблонов (до перевода интервик на Викиданные также обновляло их).
В некоторых случаях по-прежнему нужен обычный предпросмотр, перезагружающий всю страницу:
- когда в вики-код в первый раз был вставлен <categorytree>,
- для выполнения на результате предпросмотра скриптов, не приспособленных к этой возможности.
Дополнительные возможности
[править код]- При редактировании раздела в предпросмотре будут показаны сноски без добавления {{примечания}} вручную.
- При редактировании старой версии страницы нажатие кнопки «Изменения» с зажатым ⇧ Shift покажет изменения по сравнению с редактируемой версией, а не с самой последней.
- При редактировании .js- или .css-страницы гаджет покажет предпросмотр с подсветкой синтаксиса.
Настройка
[править код]Некоторые параметры для гаджета можно добавить в свой .js-файл.
Положение кнопок
[править код]По умолчанию кнопки показываются справа от верхней панели кнопок вставки.
Можно переместить их налево, указав
ajaxPreviewPos = 'left'; // кнопки слева
Также можно переместить их на место соответствующих обычных кнопок под окном редактирования, «вытесняя» тех вправо:
ajaxPreviewPos = 'bottom'; // кнопки внизу
Клавиши быстрого вызова
[править код]По умолчанию новые кнопки забирают сочетания клавиш браузера (p для просмотра и v для изменений) у соответствующих обычных кнопок (в разных браузерах к ним нужно добавлять разные модификаторы, например в Хроме — Alt). Это можно изменить с помощью следующих параметров:
ajaxPreviewKey = 'o';
ajaxDiffKey = 'b';
Пустая строка (''
) означает, что новая кнопка не будет иметь быстрого сочетания клавиш.
Названия кнопок
[править код]По умолчанию кнопки имеют названия «Просмотр» и «Изменения». Это можно изменить с помощью следующих параметров:
ajaxPreviewButton = 'Ω';
ajaxDiffButton = 'Δ';
Более полный предпросмотр
[править код]Следующий параметр заставит скрипт всегда обновлять предпросмотр интервик, категорий и шаблонов (shift-клик тогда имеет обратное действие).
ajaxPreviewFull = true;
Технические детали
[править код]Код гаджета: MediaWiki:Gadget-preview.js.