Цей гаджет включає інтелектуальне підбору колірної схеми, тому він намагатиметься автоматично вписатися в колірну схему вікі, не вимагаючи користувацького CSS для виправлення. Це робиться за допомогою кольорів із Special:ThemeDesigner; якщо ви змінили кольори вікі за допомогою CSS замість ThemeDesigner, це може не працювати належним чином.

Installation

Примітки, що використовуються

Спливаючі вікна можна налаштувати за допомогою вбудованого інтерфейсу користувача. Ви можете ініціювати їх натисканням замість наведення курсора, налаштувати затримку наведення та вмикати та вимикати анімацію. Також можна повністю вимкнути їх для кожного користувача для окремих користувачів, які цього не хочуть.

Коли спливаючі вікна вимкнено, у кінці статті, трохи нижче категорій, є посилання, яке можна натиснути, щоб знову відкрити інтерфейс конфігурації, щоб увімкнути їх пізніше.

Швидка довідка щодо налаштування

У конфігурації спливаючого вікна доступні такі параметри:

• Вимкнути спливаючі вікна довідки – це деактивує спливаючі вікна, щоб вони більше не з'являлися, окрім користувацьких. Їх можна знову ввімкнути за допомогою посилання «Налаштувати спливаючі вікна довідника» внизу статей.
  • Деякі вікі можуть блокувати спливаючі вікна, що не дасть вам можливості їх вимкнути. Вам слід зв’язатися з адміністраторами цієї вікі, щоб обговорити це в такому випадку.
• Затримка наведення – кількість часу (у мілісекундах), протягом якого потрібно навести курсор миші на посилання, перш ніж відкриється спливаюче вікно. За замовчуванням це 200 мс, але ви можете налаштувати його, якщо це занадто довге або занадто коротке значення на ваш смак. Майте на увазі, що дуже короткі значення можуть дратувати під час прокручування.
• Зробити спливаючі вікна відкритими, поки їх не торкнеться мишею — спливаючі вікна залишаться відкритими, як тільки вони з'являться, як це відбувається в режимі клацання, доки ви не наведете курсор миші на спливаюче вікно, а потім не вийдете з нього. Це дозволяє вам відкривати спливаюче вікно, наводячи курсор, а потім переміщувати мишу в інше місце, не закриваючи спливаюче вікно, доки ви цього не захочете.
• Активувати за' — за замовчуванням спливаючі вікна реагують на наведення; однак ви можете перемикатися між наведенням курсора та клацанням за вашим бажанням. У режимі клацання ви повинні клацнути посилання, щоб відкрити спливаючі вікна.
  • In click mode, clicking the reference a second time whilst the popup is already open will bypass it (close it) and take you to the references section at the bottom of the article as per normal.
• Увімкнути анімацію відкриття/закриття – за замовчуванням спливаючі вікна мають ковзаючу анімацію відкриття/закриття, яка працює протягом 300 мс. Це, як правило, приємніше для ока, ніж просто відкривається, але якщо вам це байдуже, ви можете вимкнути його.

Конфігурація адміністратора

Адміністратори можуть видалити посилання на конфігурацію гаджета зі своєї вікі, перевівши довідкові спливаючі вікна в режим «блокування». Це змусить спливаючі вікна залишатися активними та вилучить посилання на конфігурацію з кінця статті, але не з самого спливаючого вікна.

Щоб увімкнути блокування, просто додайте це до MediaWiki:Common.js над вищезгаданого імпорту:

((window.dev = window.dev || {}).ReferencePopups = dev.ReferencePopups || {}).lockdown = true;

Ви також можете змінити параметри за замовчуванням для нових користувачів. Ви можете вимкнути анімацію за замовчуванням за допомогою:

((window.dev = window.dev || {}).ReferencePopups = dev.ReferencePopups || {}).defaults = { animate: false };

Спеціальні спливаючі вікна

Компонент спливаючого вікна цього скрипту повністю можна використовувати повторно, і його можна переназначити для відображення всього, що ви хочете, а також посилань. Заздалегідь набір скриптів і шаблонів надається, якщо ви просто хочете щось додати та використати. Крім того, якщо ви здатні написати свій власний JavaScript, ви можете замість цього кодувати напряму проти спливаючих вікон, щоб робити такі речі, як новий вміст AJAX, і відображати його у спливаючому вікні під час взаємодії з певними елементами.

Щоб використовувати спеціальні спливаючі вікна, вам потрібно імпортувати скрипт спеціального спливаючого вікна:

dev:ReferencePopups/custom.js

І вам потрібно буде скопіювати ці 2 шаблони у вашу вікі, щоб використовувати скрипт:

• Template:Popup
• Template:PopupContent

Шаблони описують, як їх використовувати.

Важливо зауважити, що користувацький скрипт спливаючого вікна використовуватиме конфігурацію ReferencePopup користувача, навіть якщо значок шестерінки не відображається в користувацьких скриптах. Це означає, що якщо спливаюче вікно знаходиться в режимі клацання, то приєднання спливаючих вікон до елементів сторінки, які вже мають власні скрипті, може мати дивні наслідки. На відміну від звичайних спливаючих вікон, користувацькі вікна «ніколи» не залишаються «липкими» і їх не можна вимкнути.

Ви також можете створювати власні скіни для власних спливаючих вікон. Приклад цього є на демонстраційній сторінці, ви можете побачити CSS для цього тут.