Довідка:Тег Gallery

Тег <gallery> використовується для створення галерей зображень, або інших медіафайлів (аудіо і відео). Підтримується починаючи з версії MediaWiki 1.4. Певним недоліком тегу є неможливість підтримки альтернативного тексту, необхідного для осіб з порушеним зором. Для створення галереї з альтернативним текстом слід використовувати шаблон {{Gallery}}.

Тег дозволяє розміщувати ілюстративний ряд матеріалів (медіафайлів) в один, або більше рядків, настільки багато, наскільки це буде можливо. Зображення в одному рядку будуть групуватись автоматично, в залежності від розмірів екрану, на який вони виводяться.

Синтаксис

Кожний файл галереї повинен бути записаний з окремого рядка. Підписи до файлів і назви файлів розділяються вертикальною рискою |. Спочатку йде назва файлу, потім підпис до нього.

<gallery>
Rotkehlchen gr.jpg|Вільшанка
Gaense2004.jpg|Гуска
</gallery>

У розширеному синтаксисі коду тега <gallery> використовуються наступні параметри:

mode= типовий вигляд галереї
caption="" заголовок галереї, що подається в подвійних лапках
widths= вказує ширину малюнків (за замовчуванням 120px)
heights= вказує висоту малюнків
perrow= вказує максимальну кількість зображень у рядку (якщо опущено — підбирається автоматично в залежності від розміру зображень)
showfilename=yes показує під малюнками оригінальні назви файлів
class="" один, або більше класів, розділених проміжком і в подвійних лапках
style="" один, або більше стилів CSS розділених крапкою з комою і в подвійних лапках

Префікс Файл: не є обов'язковим. Проте він може бути корисним для автоматичної обробки статті ботами, скриптами.

Режим

mode=traditional за замовчуванням
mode=nolines менша рамка, без ліній
mode=packed усі зображення мають однакову висоту і підігнані поруч
mode=packed-overlay як попереднє, але підпис накладається на нижню частину зображення
mode=packed-hover як попереднє, але підпис видимий лише при наведенні курсору (при використанні тач-скріну поводиться як packed-overlay)
mode=slideshow слайд-шоу

Traditional

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

<gallery mode=traditional>
Rotkehlchen gr.jpg|Вільшанка
Gaense2004.jpg|Гуска
Waran.jpg|Комодський варан
Cat outside.jpg|Кіт
Baby turtle.jpg|Черепаха
</gallery>

Вільшанка
Гуска
Комодський варан
Кіт
Черепаха

Nolines

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

<gallery mode=nolines>
Rotkehlchen gr.jpg|Вільшанка
Gaense2004.jpg|Гуска
Waran.jpg|Комодський варан
Cat outside.jpg|Кіт
Baby turtle.jpg|Черепаха
</gallery>

Вільшанка
Гуска
Комодський варан
Кіт
Черепаха

Packed

Усі зображення мають однакову висоту (зображення вирівнюються за висотою найвищого файлу) і підігнані поруч. Файли галереї і підписи до них динамічно центруються й максимально можливо заповнюють рядок в статті (залежить від розмірів екрану). Може дати несподівані результати при певних зазначеннях параметрів heights= і perrow=.

<gallery mode=packed>
Rotkehlchen gr.jpg|Вільшанка
Gaense2004.jpg|Гуска
Waran.jpg|Комодський варан
Cat outside.jpg|Кіт
Baby turtle.jpg|Черепаха
</gallery>

Вільшанка
Гуска
Комодський варан
Кіт
Черепаха

Packed-overlay

Теж саме що й mode=packed, усі зображення мають однакову висоту і підігнані поруч, але підпис накладається на нижню частину зображення. Може дати несподівані результати при певних зазначеннях параметрів heights= і perrow=.

<gallery mode=packed-overlay>
Rotkehlchen gr.jpg|Вільшанка
Gaense2004.jpg|Гуска
Waran.jpg|Комодський варан
Cat outside.jpg|Кіт
Baby turtle.jpg|Черепаха
</gallery>

Вільшанка
Гуска
Комодський варан
Кіт
Черепаха

Packed-hover

Теж саме що й mode=packed, усі зображення мають однакову висоту і підігнані поруч, але підпис видимий лише при наведенні курсору (при використанні тач-скріну поводиться як mode=packed-overlay). Підписи можуть не відображатись якщо JavaScript вимкнено. Може дати несподівані результати при певних зазначеннях параметрів heights= і perrow=.

<gallery mode=packed-hover>
Rotkehlchen gr.jpg|Вільшанка
Gaense2004.jpg|Гуска
Waran.jpg|Комодський варан
Cat outside.jpg|Кіт
Baby turtle.jpg|Черепаха
</gallery>

Вільшанка
Гуска
Комодський варан
Кіт
Черепаха

Slideshow

Формат прокрутки файлів в єдиному умовному віконці. У цьому режимі не підтримуються параметри widths= і heights=, файли займають максимально можливий вільний простір, тому важливо задати параметри максимального розміру через параметр стилю власноруч. За натискання на значок галереї усі файли з неї розгорнуться нижче.

<div style="max-heights:100px">
<gallery mode=slideshow>
Rotkehlchen gr.jpg|Вільшанка
Gaense2004.jpg|Гуска
Waran.jpg|Комодський варан
Cat outside.jpg|Кіт
Baby turtle.jpg|Черепаха
</gallery></div>

Вільшанка
Гуска
Комодський варан
Кіт
Черепаха

Заголовок

Заголовок галереї здається параметром caption="", записується в подвійних лапках.

<gallery caption="Тварини з нашого подвір'я" mode=packed style="text-align:right">
Rotkehlchen gr.jpg|Вільшанка
Gaense2004.jpg|Гуска
Waran.jpg|Комодський варан
Cat outside.jpg|Кіт
Baby turtle.jpg|Черепаха
</gallery>

Тварини з нашого подвір'я
Вільшанка
Гуска
Комодський варан
Кіт
Черепаха

Розмір файлів

Розмір комірок файлів в галереї можна задати параметрами heights= та widths=. Перший задає однакову висоту, другий — однакову ширину. Розмір задається у пікселях px, або пкс. Не потрібно без зайвої на то потреби задавати параметр heights= в режимах автоматичного вирівнювання: mode=packed, mode=packed-overlay і mode=packed-hover. Параметр widths= у цих режимах не працює.

<gallery widths=250px>
Rotkehlchen gr.jpg|Вільшанка
Gaense2004.jpg|Гуска
Waran.jpg|Комодський варан
Cat outside.jpg|Кіт
Baby turtle.jpg|Черепаха
</gallery>

Вільшанка
Гуска
Комодський варан
Кіт
Черепаха

<gallery widths="120" heights="300" caption="Найвищі будівлі міст">
Eureka Tower 0944a.jpg|Мельбурн
Shun Hing Square.jpg|Шенчжень
JinMaoBuilding.jpg|Шанхай
Post Tower Bonn.jpg|Бонн
</gallery>

Найвищі будівлі міст
Мельбурн
Шенчжень
Шанхай
Бонн

<gallery mode=packed heights="150px">
Rotkehlchen gr.jpg|Вільшанка
Gaense2004.jpg|Гуска
Waran.jpg|Комодський варан
Cat outside.jpg|Кіт
Baby turtle.jpg|Черепаха
</gallery>

Вільшанка
Гуска
Комодський варан
Кіт
Черепаха

Кількість файлів на рядок

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

<gallery perrow=3>
Rotkehlchen gr.jpg|Вільшанка
Gaense2004.jpg|Гуска
Waran.jpg|Комодський варан
Cat outside.jpg|Кіт
Baby turtle.jpg|Черепаха
</gallery>

Вільшанка
Гуска
Комодський варан
Кіт
Черепаха

Класи

class="center" — вирівнювання галереї по центру (для традиційного режиму).

<gallery class="center">
Rotkehlchen gr.jpg|Вільшанка
Gaense2004.jpg|Гуска
Waran.jpg|Комодський варан
Cat outside.jpg|Кіт
</gallery>

Вільшанка
Гуска
Комодський варан
Кіт

Стилі

Для обтікання галерей текстом використовуйте відповідні стилі, наприклад <div style="float:right">. Зауважте, що нестандартно відформатований текст буде накладатись на зображення, що розміщені праворуч від нього. Також не забувайте про закривний тег </div>.

<div style="float:right">
<gallery perrow="2">
Rotkehlchen gr.jpg|Вільшанка
Gaense2004.jpg|Гуска
Waran.jpg|Комодський варан
Cat outside.jpg|Кіт
</gallery></div>

Вільшанка
Гуска
Комодський варан
Кіт

«Але щоб ви зрозуміли, звідки виникає це хибне уявлення людей, цуратись насолоди і вихваляти страждання, я розкрию перед вами всю картину і роз'ясню, що саме говорив цей чоловік, який відкрив істину, якого я б назвав зодчим щасливого життя.

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

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

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

І хто міг би по справедливості дорікнути прагнення до насолоди, яке не несло б з собою ніяких неприємностей, або того, хто уникав би такого страждання, яке не приносило б з собою ніякої насолоди?»

<div style="float:left">
<div style="max-height:150px">
<gallery mode=slideshow>
Rotkehlchen gr.jpg|Вільшанка
Gaense2004.jpg|Гуска
Waran.jpg|Комодський варан
Cat outside.jpg|Кіт
</gallery></div></div>

Вільшанка
Гуска
Комодський варан
Кіт

«Але щоб ви зрозуміли, звідки виникає це хибне уявлення людей, цуратись насолоди і вихваляти страждання, я розкрию перед вами всю картину і роз'ясню, що саме говорив цей чоловік, який відкрив істину, якого я б назвав зодчим щасливого життя.

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

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

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

І хто міг би по справедливості дорікнути прагнення до насолоди, яке не несло б з собою ніяких неприємностей, або того, хто уникав би такого страждання, яке не приносило б з собою ніякої насолоди?»

Див. також