עריכת הדף "תבנית:מפת תמונה/תיעוד" (פסקה)

==שימוש==
כדי להשתמש בתבנית, יש צורך בתמונה וב-imageMap (או "מפת תמונה", כשם התבנית). מדריך ליצירת מפת תמונה מקושר ב"ראו גם": [[חב"דפדיה:מיזמי חב"דפדיה/מיזם התמונות הממופות/מדריך שימוש בעורך|מדריך לשימוש בעורך ImageMap]]. בתום העריכה, ניתן להעתיק את מפת התמונה מהעורך, ולהדביק בתבנית, בפרמטר "מיפוי".

{| align=left border=1 width="250"
|-
| <pre style="border: none; margin: 0;">
{{מפת תמונה
| תמונה = (חובה)
| הצמדה = 
| רוחב קטן = 
| סימון = 
| הגדלה = 
| desc = 
| רוחב גדול = 
| אייקונים = 
| כיתוב תמונה = 
| אתם כאן = 
| מיקום הדגשה = 
| מיפוי = (חובה)
}}
</pre>
|-
| <small>אפשר לסמן את הטקסט, ולאחר הסימון ניתן להעתיק את המידע באמצעות {{Charbuttons|Ctrl|C}}, ולהדביק בערך באמצעות {{Charbuttons|Ctrl|V}}
|}

===פרמטרים===

כל הפרמטרים פרט ל"תמונה" ו"מיפוי" אופציונליים. בדרך כלל יש צורך רק בשני אלו וב"כיתוב תמונה".

*'''תמונה''': פרמטר חובה. שם קובץ התמונה
*'''מיפוי''': פרמטר חובה. רשימת המיפוי, כפי שמופיעה ב-imagemap
*'''כיתוב תמונה''': הכיתוב מתחת לתמונה. יכול להכיל קישורים פנימיים.
*'''רוחב קטן''': מספר. הרוחב, בפיקסלים, של התמונה במצב מוקטן. ברירת מחדל: 200.
*'''רוחב גדול''': מספר. הרוחב, בפיקסלים, של התמונה במצב מוגדל. ברירת מחדל: 600.
*'''הגדלה''': אם יצוין "לא", תוצג תמונה אחת (ברוחב שהוגדר כ"רוחב קטן", או ברירת המחדל - 200), ובלי קישור "לחצו להגדלה".
*'''סימון''': אם יוגדר "כן", מופעל סקריפט הסימון, שמשנה במקצת את הממשק של מפת התמונה - מוסבר למטה.
*'''desc''': הצגת אייקון [[קובץ:desc-20.png]] לקישור לתמונה המקורית. ברירת מחדל: none, כלומר לא יוצג אייקון. ערכים אפשריים: top-left, top-right, bottom-left, bottom-right, none
*'''הצמדה''': האם להצמיד את התמונה לצדו השמאלי או הימני של הדף, או למרכז אותה. ערכים אפשריים: "left", "right","center", "שמאל", "ימין", "מרכז" (בלי המירכאות). ברירת מחדל: שמאל.
* '''אייקונים''': פרמטר למקרים מיוחדים, כמו למשל שימוש במפת תמונה בתוך תבנית ניווט. אם ניתן לפרמטר ערך "לא", לא יוצגו אייקונים לקישור לתמונה המקורית והסבר על מפת תמונה. ללא הפרמטר או עם כל ערך אחר מאשר "לא", האייקונים יוצגו.
*'''אתם כאן''': אם הפרמטר הוא '''כן''', יודגש האזור בתמונה שכותרתו שווה לתוכן הפרמטר "מיקום הדגשה" (שם הדף כשהפרמטר לא מוגדר). ללא מעבר עכבר, ברקע ירוק בהיר שקוף. הקישור במקרא יופיע עם רקע אפור ו-tooltip "אתם נמצאים כאן".
*'''מיקום הדגשה''': כותרת האזור (מופיעה גם ב-tooltip) שיודגש כשהפרמטר "אתם כאן" דלוק. באין פרמטר, ברירת מחדל היא שם הדף בו מוצבת התבנית, ללא סוגריים.

==== סקריפט הסימון ====
אם מופעל סקריפט הסימון, בעזרת פרמטר <code>סימון = כן</code>, מפת התמונה משנה במקצת את התנהגותה: נוסף לתמונה "מקרא", המפרט את כל האזורים שמוגדרים במפת התמונה, וכאשר הקוראים מציפים את העכבר מעל אחד האזורים בתמונה, בנוסף להצגת הטקסט ב"בלון" כמו במפת תמונה רגילה, האזור המוגדר "מסומן", וכאשר מסיטים את העכבר מחוץ לאזור הסימון מוסר. גם כאשר מציפים את העכבר מעל אחת הכותרות במקרא, האזור או האזורים המתאימים במפת התמונה יסומנו. 

ה"מקרא" עצמו מוסתר, ולמפת התמונה נוספת קישורית "הצגת המקרא", שלחיצה עליה מציגה את המקרא.