Template:Gallery/docのソースを表示

<noinclude>{{Documentation subpage}}</noinclude>
<includeonly>{{使用箇所の多いテンプレート|3,000以上}}</includeonly>
{{lua|Module:Gallery}}
{{Uses TemplateStyles|Template:Gallery/styles.css}}
このテンプレートは、高度なギャラリー作成機能（表示形式の微細な調整）を提供します。一般的なギャラリーの作成には[[Help:画像の表示#ギャラリー|&lt;gallery&gt;タグ]]を使用してください。

このテンプレートでは、複数の画像を左から右に並べて表示します。{{para|width}}および{{para|height}}パラメーターは、ギャラリー内の全ての画像のサイズを規定します。1列あたりの画像の枚数は、各画像の幅と画面全体の幅に応じて変化します。読者がウィンドウの幅を変更すると、1列あたりの画像の枚数が変わる場合があります。

ギャラリーの適切な配置に関するガイドラインについては、[[Wikipedia:画像利用の方針#配置]]を参照してください。

== 使い方 ==
{| style="background: transparent;"
|<syntaxhighlight lang="wikitext">{{Gallery
| title        = 
| align        =
| footer       =
| style        =
| state        =
| height       =
| width        =
| perrow       =
| mode         = 
| whitebg      = 
| noborder     =
| captionstyle =
| ファイル:
 | {キャプション}
 | alt1=
| ファイル:
 | {キャプション}
 | alt2=
| ファイル:
 | {キャプション}
 | alt3=
| ファイル:
 | {キャプション}
 | alt4=
| ファイル:
 | {キャプション}
 | alt5=
}}</syntaxhighlight>
|}

== パラメーター ==
=== 書式 ===
画像を指定するための書式は以下のようになります。

: {{para||ファイル:&lcub;ファイル名&rcub;}} {{para||&lcub;キャプション&rcub;}} {{para|alt''n''|&lcub;代替文&rcub;}}

ファイル名およびキャプションについてはパラメーター名は不要ですが、代替文を使用する場合には、文の直前に{{para|alt''n''}}を付ける必要があります。

: {{para||ファイル:&lcub;ファイル名&rcub;}} - 画像ファイル名。プレフィックスとして<code>ファイル:</code>（<code>File:</code>も可）を使用します。
: {{para||&lcub;キャプション&rcub;}} - 画像の下部に表示する説明文。キャプション自体は省略可能ですが、この場合には画像ファイル名の直後に<code>|</code>（[[バーティカルバー|縦線]]）のみ記入してください。
: {{para|alt''n''}} - [[alt属性]]。1枚目の画像には{{para|alt1}}が、2枚目の画像には{{para|alt2}}が使用されます。
:: <code>{代替文}</code> - [[Wikipedia:画像の代替テキスト|画像の代替テキスト]]。[[視覚障害者]]や、画像をはっきりと見ることができない読者の理解を補助するために使用します。省略した場合には、代替文は空白になります。

=== 任意のパラメーター ===
; ギャラリー全体
: {{para|title}} - ギャラリーの題名。
: {{para|align}} - ギャラリーをページ内の左右または中央に寄せて配置したい場合に指定します。{{para|state}}を指定した場合には無視されます。
:: {{para|align|left}}（左、既定）
:: {{para|align|center}}（中央）
:: {{para|align|right}}（右）
: {{para|footer}} - ギャラリーの右下に小さく表示される文。
: {{para|style}} - ギャラリー全体の表示を[[Cascading Style Sheets|CSS]]の構文により調整します。
: {{para|state}} - 折り畳み機能を有効にし、初期状態を指定します。有効にすると、ギャラリーは画面全体の幅に広がります。
:: {{para|state|expanded}}（開く）
:: {{para|state|collapsed}}（折り畳む）
: {{para|mode}} - 表示モードを変更します。代表的なものを以下に挙げます。詳細は[[:mw:Help:Images/ja#mode_パラメーター|MediaWikiのヘルプ]]を参照してください。
:: {{para|mode|packed}}（画像の高さのみ統一し幅は元のサイズに比例）
:: {{para|mode|nolines}}（フレームを消去すること以外は既定モードと同様）
; 各画像
: {{para|noborder}} - {{para|noborder|yes}}を指定すると、画像を囲む境界線を消去します。
: {{para|whitebg}} - {{para|whitebg|no}}を指定すると、白色の背景を消去します。
: {{para|height}} - 各画像の高さの上限値を変更します（既定値は180ピクセル）。「px」等の単位は付けずに数値のみ記入してください。
: {{para|width}} - 各画像の幅の上限値を変更します（既定値は180ピクセル）。「px」等の単位は付けずに数値のみ記入してください。
: {{para|perrow}} - 1列あたりの画像枚数を指定します。
: {{para|captionstyle}} - キャプションの表示を[[Cascading Style Sheets|CSS]]の構文により調整します。

画像の元の縦横比は{{para|width}}および{{para|height}}を指定した場合でも維持されます。{{para|width}}と{{para|height}}に同じ数値を指定した場合でも、縦横比の異なる画像が正方形に変形することはありません。

== 使用例 ==
{| style="background: transparent;"
|<syntaxhighlight lang="wikitext">{{Gallery
|title=ポルシェ356
|footer=使用例1
|whitebg= no
|ファイル:Porsche 356 No. 1 Roadster IMG 0814.jpg|[[:en:Porsche 356/1|356/1]]・ミッドエンジン・プロトタイプ（1948年）
|ファイル:1949 Porsche 356-2 Coupe (30795116158).jpg|[[:en:Porsche 356/2|356/2]]クーペ（1949年）
|ファイル:1954 Porsche 356 convertible (9596133395).jpg|356カブリオレ（1954年）
|ファイル:1957 Red Porsche 356A Speedster.jpg|356Aスピードスター（1957年）
|ファイル:1960 Porsche 356B Super 90 Roadster.jpg|356Bロードスター（1960年）
|ファイル:Bonhams - The Paris Sale 2012 - Porsche 356C Coupé - 1963 - 016.jpg|356Cクーペ（1963年）
}}</syntaxhighlight>
|}

{{Gallery
|title=ポルシェ356
|footer=使用例1
|whitebg= no
|ファイル:Porsche 356 No. 1 Roadster IMG 0814.jpg|[[:en:Porsche 356/1|356/1]]・ミッドエンジン・プロトタイプ（1948年）
|ファイル:1949 Porsche 356-2 Coupe (30795116158).jpg|[[:en:Porsche 356/2|356/2]]クーペ（1949年）
|ファイル:1954 Porsche 356 convertible (9596133395).jpg|356カブリオレ（1954年）
|ファイル:1957 Red Porsche 356A Speedster.jpg|356Aスピードスター（1957年）
|ファイル:1960 Porsche 356B Super 90 Roadster.jpg|356Bロードスター（1960年）
|ファイル:Bonhams - The Paris Sale 2012 - Porsche 356C Coupé - 1963 - 016.jpg|356Cクーペ（1963年）
}}


{| style="background: transparent;"
|<syntaxhighlight lang="wikitext">{{Gallery
|title=ポルシェ356
|align=center
|footer=使用例2
|style=background-color:lavender
|width=120 |height=100
|mode=nolines
|captionstyle=font-size:smaller
|ファイル:Porsche 356 No. 1 Roadster IMG 0814.jpg|[[:en:Porsche 356/1|356/1]]・ミッドエンジン・プロトタイプ（1948年）
|ファイル:1949 Porsche 356-2 Coupe (30795116158).jpg|[[:en:Porsche 356/2|356/2]]クーペ（1949年）
|ファイル:1954 Porsche 356 convertible (9596133395).jpg|356カブリオレ（1954年）
|ファイル:1957 Red Porsche 356A Speedster.jpg|356Aスピードスター（1957年）
|ファイル:1960 Porsche 356B Super 90 Roadster.jpg|356Bロードスター（1960年）
|ファイル:Bonhams - The Paris Sale 2012 - Porsche 356C Coupé - 1963 - 016.jpg|356Cクーペ（1963年）
}}</syntaxhighlight>
|}

{{Gallery
|title=ポルシェ356
|align=center
|footer=使用例2
|style=background-color:lavender
|width=120 |height=100
|mode=nolines
|captionstyle=font-size:smaller
|ファイル:Porsche 356 No. 1 Roadster IMG 0814.jpg|[[:en:Porsche 356/1|356/1]]・ミッドエンジン・プロトタイプ（1948年）
|ファイル:1949 Porsche 356-2 Coupe (30795116158).jpg|[[:en:Porsche 356/2|356/2]]クーペ（1949年）
|ファイル:1954 Porsche 356 convertible (9596133395).jpg|356カブリオレ（1954年）
|ファイル:1957 Red Porsche 356A Speedster.jpg|356Aスピードスター（1957年）
|ファイル:1960 Porsche 356B Super 90 Roadster.jpg|356Bロードスター（1960年）
|ファイル:Bonhams - The Paris Sale 2012 - Porsche 356C Coupé - 1963 - 016.jpg|356Cクーペ（1963年）
}}

== TemplateData ==
{{TemplateDataHeader}}
<templatedata>
{
	"params": {
		"title": {
			"label": "題名",
			"description": "ギャラリーの題名",
			"example": "ニワトリの画像",
			"type": "string",
			"suggested": true
		},
		"align": {
			"label": "配置",
			"description": "画面内のギャラリーの配置",
			"example": "center",
			"type": "string",
			"default": "left",
			"suggestedvalues": [
				"left",
				"center",
				"right"
			]
		},
		"footer": {
			"label": "フッター",
			"description": "ギャラリーの右下に小さく表示される文",
			"example": "初期の作品",
			"type": "string"
		},
		"style": {
			"label": "スタイル",
			"description": "CSSの構文でギャラリー全体の表示を調整",
			"example": "border: 1px solid black;",
			"type": "string"
		},
		"captionstyle": {
			"label": "キャプションのスタイル",
			"description": "CSSの構文でキャプションの表示を調整",
			"example": "text-align: center;",
			"type": "string"
		},
		"state": {
			"label": "状態",
			"description": "折り畳み機能および初期状態",
			"example": "collapsed",
			"type": "string",
			"default": "expanded",
			"suggestedvalues": [
				"expanded",
				"collapsed"
			]
		},
		"height": {
			"label": "画像の高さ",
			"description": "各画像の高さの上限値",
			"example": "100",
			"type": "number",
			"default": "180"
		},
		"width": {
			"label": "画像の幅",
			"description": "各画像の幅の上限値",
			"example": "120",
			"type": "number",
			"default": "180"
		},
		"mode": {
			"label": "表示モード",
			"description": "表示モード",
			"type": "string",
			"default": "traditional",
			"suggestedvalues": [
				"traditional",
				"nolines",
				"packed",
				"packed-overlay",
				"packed-hover",
				"slideshow"
			]
		},
		"noborder": {
			"label": "境界線を消去",
			"description": "画像を囲む境界線を消去",
			"example": "yes",
			"type": "boolean",
			"default": "no"
		},
		"whitebg": {
			"label": "白色の背景",
			"description": "白色の背景を表示",
			"example": "no",
			"type": "boolean",
			"default": "yes"
		}
	},
	"description": "ギャラリー形式でキャプション付きの画像を表示するためのテンプレート。"
}
</templatedata>

== 関連項目 ==
* {{tl|画像過剰}}
* {{tl|Image array}}
* {{tl|Imageframe}}
* {{tl|Multiple image}}
* {{tl|Photomontage}}
* {{tl|Stack}}

<includeonly>{{Sandbox other||
[[Category:画像レイアウト用テンプレート]]
}}</includeonly>