Pendokumenan templat[lihat] [sunting] [sejarah] [nyahcache]

Templat {{Galeri}} menyediakan kefungsiaan binaan galeri maju (kawalan pemformatan diperhalusi). Untuk menghasilkan galeri asas, gunakan Bantuan:Tag Galeri.

Templat ini memaparkan suatu galeri gambar atau imej dalam satu tatasusunan, dari kiri ke kanan mengikut baris. Parameter sejagat |width = (Lebar) dan |height = (Tinggi) mengawal saiz kesemua gambar dalam galeri melainkan jika diatasi oleh parameter |widthn =. Bilangan gambar per baris adalah berdasarkan pada parameter lebar gambar dan lebar skrin/layar. Bilangan ini boleh berubah apabila pengguna mensaizkan semula tetingkap.

Untuk garis panduan mengenai penggunaan imej, lihat Wikipedia:Dasar penggunaan imej.

Parameter sunting

Bagi setiap imej sunting

Tentukan barisan borang berikut untuk setiap imej.

|Fail:Nama fail |altn=Teks alternatif |Kapsyen

di mana:

  • |Fail:Nama fail — Nama fail imej. Awalan seperti Fail: atau Imej: boleh digunakan.
  • |Altn= — Atribut alt: |alt1= untuk imej pertama, |alt2= untuk imej kedua dan lain-lain
  • Teks alternatif — Teks alternatif untuk imej, digunakan oleh mereka yang mengalami cacat penglihatan atau pembaca lain yang tidak dapat melihat imej dengan jelas. Jika dikecualikan, teks alternatif imej ini akan menjadi kosong. Lihat WP:ALT untuk maklumat lanjut.

Parameter pilihan sunting

Parameter-parameter berikut boleh digunakan pada galeri:

  • |title= (tajuk) — Tajuk galeri
  • |align= (jajar) — Penjajaran galei pada suatu laman. Pilih sama ada tetapan lalai iaitu left (kiri), center (tengah) atau right (kanan). Abaikan jika state (keadaan) ditetapkan
  • |footer= (pengaki) — Teks bersaiz kecil, dijajarkan ke kanan berada di bawah imej
  • |style= (gaya) — Arahan gaya CSS untuk keseluruhan galeri (lihat Bantuan:Lembaran Gaya Lata)
  • |state= (keadaan) — Menetapkan keadaan lalai galeri yang boleh disorokkan/diruntuhkan; gunakan |state=expanded (kembangkan) atau |state=collapsed (disorokkan); galeri yang boleh disorokkan memenuhi lebar laman sepenuhnya

Parameter-parameter berikut boleh diguna pakai pada kesemua imej dalam galeri:

  • |height= (tinggi) — Tinggi maksimum bagi setiap imej. Jika parameter ini tidak disertakan, nilai |height= (tinggi) lalai adalah 180 piksel.
  • |width= (lebar) — Lebar maksimum bagi setiap imej. Jika parameter ini tidak disertakan, nilai |width= (lebar) lalai adalah 180 piksel.
  • |cellwidth= (lebar sel) — Lebar bagi setiap sel atau kotak imej, nilai lalainya mengikut |width= (lebar). Jika dinyatakan, |cellwidth= akan menggantikan sebarang nilai yang dinyatakan dengan |width= (lebar).
  • |captionstyle= (gaya kapsyen) — Arahan gaya CSS untuk kapsyen (lihat Bantuan:Lembaran Gaya Lata)

Nisbah lebar ke tinggi asal bagi suatu imej tidak boleh diubah dengan |width= atau |height= — contoh: imej yang berbentuk segi empat tepat tidak boleh diubah kepada bentuk segi empat sama walaupun parameter tersebut ditetapkan pada nilai yang sama.

Parameter-parameter berikut boleh diguna pakai pada setiap imej secara berasingan:

  • |widthn= (lebar n) — Nilai n adalah nombor; digunakan bagi menentukan lebar bagi imej yang menggunakan n apabila ia perlu mempunyai saiz berbeza daripada nilai yang ditetapkan oleh |width= (lebar)

Sila ambil perhatian bahawa menjadikan suatu imej itu lebih lebar dengan menggunakan parameter |widthn= (lebar n) tidak akan menghasilkan kapsyen yang lebih lebar, di mana ia masih dikekang oleh parameter |width= (lebar).

Contoh sunting

{{Galeri
|title=Penggambaran budaya [[George Washington]]
|width=160 | height=170
|align=center
|footer=Contoh 1
|Fail:Federal Hall NYC 27.JPG 
 |alt1=Patung yang menghadap depan bangunan bandar raya dengan tiang Yunani
 |Patung Washington di luar Federal Hall di [[Bandaraya New York]] melihat pada [[Wall Street]]
|Fail:Mount Rushmore2.jpg 
 |alt2=Profil wajah batu di sisi gunung dengan 3 pekerja
 |Pembinaan potret Washington di [[Gunung Rushmore]], c. 1932
|Fail:2006 Quarter Proof.png 
 |alt3=Duit syiling dengan profil paras dada Washington 
 |Washington diabadikan pada duit syiling 25 sen
|Fail:George Washington Presidential $1 Coin obverse.png 
 |alt4=Duit syiling emas paras dada Washington yang menghadap sedikit ke kiri
 |Washington pada duit syiling sedolar
}}