الگو:تصویر چندگانه/پایه

توضیحات الگو[نمایش] [ویرایش] [تاریخچه] [پاکسازی]

لطفاً پیش از ساختن نگارخانه سیاست استفاده از تصاویر در نگارخانه را بخوانید. به‌طور کلی، نگارخانه‌ها را نباید به مقاله افزود، مگر آن که فضای کافی برای تصاویر جهت ارائه در جوار متن به‌طور مؤثر موجود باشد.

این الگو از لوآ استفاده می‌کند:

پودمان:Multiple image

این الگو از الگوسبک استفاده می‌کند:

الگو:Multiple image/styles.css

این الگو جعبه‌ای را ایجاد می‌کند که می‌تواند شامل دو تا ده تصویر باشد که به‌صورت عمودی یا افقی ردیف شده‌اند و قابلیت قرار دادن توضیح برای هر تصویر به‌طور جداگانه یا یک توضیح برای کل جعبه را دارد.

در صورت انتخاب درست پارامترها، این الگو می‌تواند به‌طور خودکا اندازهٔ تصاویر را به پهنای مشخص‌شده تغییر دهد و ارتفاع تصاویر را با یکدیگر یکسان کند.

آگاه باشید که این الگو از ترجیحات پیش‌فرض کاربر برای اندازهٔ تصویر پیروی نمی‌کند. (ویکی‌پدیا:سیاست استفاده از تصاویر می‌گوید: «اندازهٔ یک نگاره را تغییر ندهید مگر اینکه دلیل خوبی برای این کار داشته باشید.» en:MOS:IMGSIZE نیز اشاره کرده‌است که پهنای ثابت به پیکسل تنها باید در صورتی تنظیم شود که «کاملاً ضروری باشد.»)^[الف]

اگر از پارامترهای اندازهٔ تصویر صرف نظر شود، این الگو بدون توجه به این که مخاطب ترجیخات خود را برای پهنای پیش‌فرض دیگری برای تصاویر تنظیم کرده‌باشد، عرض تمام تصاویر را روی ۲۰۰ پیکسل تنظیم می‌کند. این موضوع باعث می‌شود تا تصاویر چندگانه نسبت به سایر تصاویر موجود در مقاله خارج از مقیاس به‌نظر برسد.

نحو و پارامترها ویرایش

برای دستیابی به تغییر اندازهٔ خودکار، پارامترهای height[n] و total_width را پر کنید. به معنی متفاوت پارامترهای width[n] با یا بدون تغییر اندازهٔ خودکار توجه داشته‌باشید. همچنین به گزینهٔ تنظیم پارامتر total_width (پهنای کلی) در ابتدای الگوی تصویر چندگانه دقت کنید.

یکسان‌سازی ارتفاع تمام تصاویر به‌طور خودکار تنظیم نمی‌شود

{{تصویر چندگانه|perrow = 1|total_width = 600
<!-- پارامترهای طرح‌بندی -->
| align             = <!-- right (پیش‌فرض)، left، center، none --> 
| direction         = <!-- horizontal (پیش‌فرض)، vertical -->
| background color  = <!-- پس‌زمینهٔ جعبه در قالب رنگ وب'هگز تریپلت' (شامل نویسهٔ # در ابتدای شناسه رنگ) -->
| width             = <!-- پهنای نمایش‌یافتهٔ هر تصویر به پیکسل (عدد صحیح، بدون پسوند «px»)؛ پارامترهای "width[n]" در زیر را نادیده می‌گیرد -->
| caption_align     = <!-- left (پیش‌فرض)، center، right --> 
| image_style       = <!-- border:1; (پیش‌فرض) -->
| image_gap         = <!-- 5 (پیش‌فرض)-->

<!-- سرآیند -->
| header_background = <!-- پس‌زمینهٔ سرآیند در قالب رنگ وب'هگز تریپلت' (شامل نویسهٔ # در ابتدای شناسه رنگ) -->
| header_align      = <!-- center (پیش‌فرض)، left، right -->
| header            = <!-- متن سرآیند -->

<!--تصویر ۱ -->
| image1            = <!-- فقط نام پرونده، بدون پیشوند «File:» یا «Image:» -->
| width1            = <!-- پهنای نمایش‌یافتهٔ تصویر؛ از سوی پارامتر «width» در بالا نادیده گرفته می‌شود -->
| alt1              = 
| link1             = 
| thumbtime1        =
| caption1          = 
<!--image 2-->
| image2            = <!-- فقط نام پرونده، بدون پیشوند «File:» یا «Image:»  -->
| width2            = <!-- پهنای نمایش‌یافتهٔ تصویر؛ از سوی پارامتر «width» در بالا نادیده گرفته می‌شود -->
| alt2              = 
| link2             = 
| thumbtime2        =
| caption2          = 
<!-- و به همین ترتیب تا حداکثر ۱۰ تصویر (image10) -->

<!-- پسایند -->
| footer_background = <!-- پس‌زمینهٔ پسایند در قالب رنگ وب'هگز تریپلت' (شامل نویسهٔ # در ابتدای شناسه رنگ) -->
| footer_align      = <!-- left (پیش‌فرض)، center، right -->
| footer            = <!-- متن پسایند -->
}}

تغییر اندازهٔ خودکار تمام تصاویر به ارتفاع یکسان و به مجموع پهنای مشخص‌شده

{{تصویر چندگانه
<!-- پارامترهای طرح‌بندی -->
 | align             = <!-- right (پیش‌فرض)، left، center، none --> 
 | direction         = <!-- horizontal (پیش‌فرض)، vertical -->
 | background color  = <!-- پس‌زمینهٔ جعبه -->
 | total_width       = <!-- مجموع پهنای تمام تصاویر نمایش‌یافته به پیکسل (عدد صحیح، بدون پسوند «px») -->
 | caption_align     = <!-- left (پیش‌فرض)، center، right --> 

<!-- سرآیند -->
 | header_background = 
 | header_align      = <!-- center (پیش فرض)، left، right -->
 | header            = 

<!--تصویر ۱ -->
 | image1            = <!-- فقط نام پرونده، بدون پیشوند «File:» یا «Image:» -->
 | alt1              = 
 | link1             = 
 | thumbtime1        =
 | caption1          = 
<!--image 2-->
 | image2            = <!-- فقط نام پرونده، بدون پیشوند «File:» یا «Image:» -->
 | alt2              = 
 | link2             = 
 | thumbtime2        =
 | caption2          = 
<!-- و به همین ترتیب تا حداکثر ۱۰ تصویر (image10) -->

<!-- پسایند -->
 | footer_background = 
 | footer_align      = <!-- left (پیش‌فرض)، center، right -->
 | footer            = 
}}

پارامتر	توضیح
align	right (پیش‌فرض)، left، center
direction	horizontal (پیش‌فرض)، vertical
background color	برای تنظیم رنگ پس‌زمینهٔ جعبه‌ای که تصاویر در آن نمایش می‌یابند.
header_background
header_align	center (پیش‌فرض)، left، right
header
width	این پارامتر را جهت تنظیم پهنای یکسان برای تمام تصاویر (هرگونه پارامتر width[n] در پایین را نادیده می‌گیرد). اگر قصد تنظیم پهننای متفاوت برای هر تصویر را دارید، از این پارامتر استفاده نکنید. اگر قصد تغییر اندازهٔ تصاویر به یک مجموع پهنای ثابت را دارید، از این پارامتر استفاده کنید.
total_width	برای مقیاس‌بندی تصاویر به ارتفاع یکسان با یکدیگر و مجموع مشخص‌شدهٔ پهنا، از این پارامتر استفاده کنید. از هر دو پارامتر total_width و width به‌طور همزمان استفاده نکنید.
image[n]	([n] = ۱ تا ۱۰) نام پروندهٔ تصویر شمارهٔ [n].
width[n]	(مانند بالا) به دو معنی: (۱) پهنای (به پیکسل، عدد صحیح، بدون «px») تصویر شمارهٔ [n]. نادیده گرفته‌شده از سوی پارامتر width (در صورت پر شدن). (۲) کل پهنای تصویر اولیهٔ شمارهٔ [n] در صورت مشخص کردن پارامتر total_width جهت تغییر اندازهٔ تمام تصاویر به ارتفاع یکسان با یکدیگر و مجموع پهنای مشخص‌شده.
height[n]	(مانند بالا) کل ارتفاع تصویر اولیهٔ شمارهٔ [n] در صورتی که total_width جهت تغییر اندازهٔ تمام تصاویر به ارتفاع یکسان با یکدیگر و مجموع پهنای مشخص‌شده، پر شده‌باشد. در غیر این صورت، نادیده گرفته می‌شود.
alt[n]	(مانند بالا) توضیح جایگزین برای تصویر شمارهٔ [n].
link[n]	(مانند بالا) صفحهٔ پیوند شده به تصویر شمارهٔ [n] (مثلاً صفحه‌ای که باید در صورت کلیک بر روی تصویر باز شود). اگر این پارامتر کلاً حذف شود، تصویر به‌طور عادی به صفحهٔ توضیحات تصویر پیوند می‌شود (مرسوم‌ترین حالت استفاده تاکنون همین روش بوده‌است). اگر این پارامتر درج شود اما خالی بماند (مثلاً ...\|link1= \|...)، تصویر به جایی پیوند نخواهد داشت – طبق وپ:جایگزین، این حالت تنها باید در موارد کاربرد کاملاً تزئینی استفاده شود. مهم: اگر تصویر تحت یک پروانه آزاد قرار دارد (نظیر پروانه مستندات آزاد گنو یا اجازه‌نامه کرییتیو کامنز)، شرایط چنین اجازه‌نامه‌ای شما را به تکثیر اجازه‌نامه، یا پیوندی به آن به‌همراه تصویر ملزم می‌کند. بنابراین تصویر باید, به صفحهٔ توضیحات تصویر پیوند داشته‌باشد که می‌تواند به‌سادگی با حذف پارامتر link[n] از الگو به شکلی که گفته‌شد، انجام شود. تصاویر در دامنهٔ عمومی و (قعدتاً) تحت استفادهٔ منصفانه موضوع این محدودیت نیستند.
thumbtime[n]	(مانند بالا) در زمان استفاده از ویدئو، زمانی از ویدئو که باید به‌عنوان تصویر اولیه نمایش یابد را تنظیم می‌کند. مقدار آن می‌تواند به شکل عدد نشانگر مجموع ثانیه‌ها یا به‌شکل ساعت:دقیقه:ثانیه باشد؛ commons:Commons:Video#Setting a video thumbnail image را ببینید.
caption[n]	(مانند بالا) توضیح برای تصویر شمارهٔ [n].
caption_align	left (پیش‌فرض)، center، right
footer_background
footer_align	left (پیش‌فرض)، center، right
footer	توضیحی که به‌جای درج در زیر تصاویر به‌طور جداگانه، کل جعبه را پوشش می‌دهد. در صورت امکان از درج «left» و «right» پرهیز کنید، چرا که ممکن است دستگاه‌های موبایل تصاویر را به‌صورت عمودی نمایش دهند.

نمونه‌ها ویرایش

بازیکنان با کارت زرد اخطار می‌گیرند و با کارت قرمز از بازی اخراج می‌شوند.

{{تصویر چندگانه
 | width = 60
 | image1 = Yellow card.svg
 | alt1 = کارتی به‌رنگ زرد
 | image2 = Red card.svg
 | alt2 = کارتی به‌رنگ قرمز
 | footer = بازیکنان با کارت زرد اخطار می‌گیرند و با کارت قرمز از بازی اخراج می‌شوند.
}}

نمایش شفافیت در پی‌ان‌جی

یک تصویر پی‌ان‌جی با یک لایهٔ ۸-بیت شفافیت...

...در اینجا یک پس‌زمینهٔ شطرنجی را همپوشانی می‌کند.

{{تصویر چندگانه
 | align = right
 | direction = vertical
 | width = 200
 | header = نمایش شفافیت در [[گرافیک قابل حمل در شبکه‌ها|پی‌ان‌جی]]
 | image1 = PNG transparency demonstration 1.png
 | alt1 = تاس‌های رنگی با پس‌زمینهٔ سفید
 | caption1 = یک تصویر پی‌ان‌جی با یک لایهٔ ۸-بیت شفافیت...
 | image2 = PNG transparency demonstration 2.png
 | alt2 = Colored dice with checkered backgroundتاس‌های رنگی با پس‌زمینهٔ شطرنجی
 | caption2 = ...در اینجا یک پس‌زمینهٔ شطرنجی را همپوشانی می‌کند.
}}

وقتی یک کاربر تعداد زیادی از یک نوع از نشان‌های قدردانی را دارد، می‌تواند آن‌ها را با ربان و این ارقام برای اشاره به تعداد مشخص کند.

{{تصویر چندگانه
 | width = 60
 | image1=Ribbon numeral 2.png | alt1=۲
 | image2=Ribbon numeral 3.png | alt2=۳
 | image3=Ribbon numeral 4.png | alt3=۴
 | footer = وقتی یک کاربر تعداد زیادی از یک نوع از [[ویکی‌پدیا:نشان‌های قدردانی|نشان‌های قدردانی]] را دارد، می‌تواند آن‌ها را با [[:en:WP:RIBBON|ربان]] و این ارقام برای اشاره به تعداد مشخص کند.
}}

با background color ویرایش

ادوکسا (Adoxa moschatellina)

{{تصویر چندگانه
 | align = right
 | background color = #BBDD99
 | width = 160
 | image1 = Adoxa_moschatellina_210406.jpg
 | alt1 = گیاه سبز با تعدادی گل‌های ریز زرد و سفید
 | image2 = Adoxa_moschatellina_210406a.jpg
 | alt2 = سه گل کوچک سفید و زرد با برگ‌های سبز در پس‌زمینهٔ
 | image3 = adoxa_moschatellina_blatt.jpeg
 | alt3 = برگ‌های یک گیاه، در گروه‌های سه‌تایی با سه‌گوشه
 | footer_background = #BBDD99
 | footer_align = center
 | footer = [[Adoxa|ادوکسا]] (''Adoxa moschatellina'')
}}

با پیوند (link[n]) ویرایش

یک قاطر
(骡子 luózi)

یک الاغ
(驴子 lǘzi)

یک ماهی
(鱼 yú)

تصویر قاطر به مقالهٔ قاطر پیوند دارد؛ تصویر الاغ به هیچ‌کجا پیوند ندارد؛ تصویر ماهی قزل‌آلا به یک صفحهٔ استاندارد توضیحات تصویر پیوند دارد.

{{تصویر چندگانه
 | align = right

 | image1 = Mule (PSF).png
 | width1 = 143
 | alt1 = یک قاطر
 | link1 = قاطر
 | caption1 = یک قاطر<br />(骡子 ''luózi'')

 | image2 = Donkey 1 arp 750px.jpg
 | width2 = 150
 | alt2 = یک الاغ
 | link2 = 
 | caption2  = یک الاغ<br />(驴子 ''lǘzi'')

 | image3 = Rainbow_trout.png
 | width3 = 91
 | alt3 = یک ماهی قزل‌آلا
 | caption3  = یک ماهی<br />({{lang|zh|2=鱼}} ''yú'')

 | footer = تصویر قاطر به مقالهٔ [[قاطر]] پیوند دارد؛ تصویر الاغ به هیچ‌کجا پیوند ندارد؛ تصویر ماهی قزل‌آلا به یک [[:en:Image description page|صفحهٔ استاندارد توضیحات تصویر]] پیوند دارد.
}}

با استفاده از direction ویرایش

تصاویری ارائه‌شده توسط این الگو، به‌طور پیش‌فرض به‌شکل افقی و در قالب یک ردیف نمایش می‌یابند (سمت راست را ببینید که معادل تنظیم تراز به‌صورت |direction=horizontal است). برای نمایش تصاویر به‌صورت عمودی، مثلاً در قالب یک ستون، تنظیم تراز باید به‌صورت |direction=vertical باشد (چپ را ببینید).

(افقی)

(عمودی)

در دستگاه‌های موبایل، اگر مجموع پهنا بیشتر از حدود ۳۲۰ باشد، برخی تصاویر ممکن است همیشه به‌صورت عمودی نمایش یابند.

برای یکسان‌سازی ارتفاع تصاویر ویرایش

یک پهنای کلی برای تمام تصاویر انتخاب کنید، مثلاً ۳۲۰ پیکسل
با استفاده از پارامتر |total_width=، پهنای کلی را تنظیم کنید

تصویر مستطیل‌شکل از یک الاغ، با ارتفاع اصلی ۵۳۶ پیکسل.

تصویر مربعی از یک ماهی قزل‌آلا، با ارتفاع اصلی ۳۰۰ پیکسل.

هر دو تصویر با ارتفاع یکسان و پهنای کلی ۳۲۰ پیکسل رندر شده‌اند

{{تصویر چندگانه
 | align = left
 | total_width = 320

 | image1 = Donkey 1 arp 750px.jpg
 | alt1 = یک الاغ
 | caption1 = تصویر مستطیل‌شکل از یک الاغ، با ارتفاع اصلی ۵۳۶ پیکسل.

 | image2 = Rainbow_trout.png
 | alt2 = یک ماهی قزل‌آلا
 | caption2 = تصویر مربعی از یک ماهی قزل‌آلا، با ارتفاع اصلی ۳۰۰ پیکسل.

 | footer = هر دو تصویر با ارتفاع یکسان و پهنای کلی ۳۲۰ پیکسل رندر شده‌اند
}}

نسبت تصویر برای هر عکس به‌طور خودکار از فرادادهٔ آن استخراج می‌شود. می‌توانید با یکی از موارد زیر، مقدارهای پهنا و ارتفاع بومی را نادیده بگیرید:

بررسی صفحه‌های تصاویر جداگانه را برای دستیابی به وضوح کامل. به‌عنوان مثال:
- پرونده:Donkey 1 arp 750px.jpg نشان می‌دهد: «Donkey_1_arp_750px.jpg (۷۵۰ × ۵۳۶ پیکسل، اندازه پرونده: ۱۲۵ کیلوبایت، نوع رسانه: تصویر/jpeg)»
- پرونده:Rainbow trout.png نشان می‌دهد: «Rainbow_trout.png (۳۰۰ × ۳۰۰ پیکسل، اندازه پرونده: ۱۵۸ کیلوبایت، نوع رسانه: تصویر/png)»
پهنا و ارتفاع کامل برای هر تصویر را با استفاده از این پارامترها مشخص کنید:
- |width1= |height1= |width2= |height2=

ردیف‌های چندگانه ویرایش

برای ایجاد یک آرایشی از تصاویر با چندین ردیف از پارامتر |perrow= استفاده کنید. مقدار داده‌شده به |perrow= باید یک عدد تک‌رقمی یا فهرستی از عددهای مرزبندی‌شده با / باشد. این قابلیت برای ایجاد چندین ردیف از تصاویر با پهنای کل یکسان، می‌تواند با پارامتر |total_width= ترکیب شود.

تجهیزات نقشه‌برداری. از بالا سمت راست به‌صورت ساعت‌گرد: دوربین مهندسی، دوربین مساحی رباتیک، ترازیاب نوری، ایستگاه مقر جی‌پی‌اس آرتی‌کی..

{{تصویر چندگانه|perrow = 2|total_width=300
| image1 = Kern_Theodolit_DKM2-A.jpg
| image2 = Total-Robotic-Station.jpg
| image3 = DumpyLevel.jpg
| image4 = GPS_Survey_Equipment_at_Weir_Dyke_Bridge_-_geograph.org.uk_-_336908.jpg
| footer = تجهیزات نقشه‌برداری. از بالا سمت راست به‌صورت ساعت‌گرد: [[تئودولیت|دوربین مهندسی]]، [[دوربین مساحی|دوربین مساحی رباتیک]]، ترازیاب نوری، ایستگاه مقر جی‌پی‌اس [[Real-time kinematic | آرتی‌کی]].
}}

حذف حاشیه تصویر ویرایش

حاشیهٔ اطراف تصاویر را می‌توان با استفاده از |image_style=border:none حذف کرد.

تصویر یک الاغ

تصویر یک ماهی قزل‌آلا

{{تصویر چندگانه
 | align = left
 | total_width = 320
 | image_style = border:none;

 | image1 = Donkey 1 arp 750px.jpg
 | alt1 = یک الاغ
 | caption1 = تصویر یک الاغ

 | image2 = Rainbow_trout.png
 | alt2 = یک ماهی قزل‌آلا
 | caption2 = تصویر یک ماهی قزل‌آلا
}}

افزایش فاصله بین تصاویر ویرایش

فاصلهٔ بین تصاویر را می‌توان با استفاده از پارامتر |image_gap=Nافزایش داد. N همان تعداد پیکسل‌ها است (نباید عددی منفی باشد).