תבנית:מפת תמונה/תיעוד

תבנית מפת תמונה מיועדת לעטוף תגית "ImageMap", באופן שהמפה תוצג בגודל קטן, עם קישור "לחצו להגדלה".

שימוש

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

{{מפת תמונה
| תמונה = (חובה)
| הצמדה = 
| רוחב קטן = 
| סימון = 
| הגדלה = 
| desc = 
| רוחב גדול = 
| אייקונים = 
| כיתוב תמונה = 
| אתם כאן = 
| מיקום הדגשה = 
| מיפוי = (חובה)
}}

אפשר לסמן את הטקסט, ולאחר הסימון ניתן להעתיק את המידע באמצעות תבנית:Charbuttons, ולהדביק בערך באמצעות תבנית:Charbuttons

פרמטרים

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

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

סקריפט הסימון

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

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

דוגמה

{{מפת תמונה
|תמונה=Eye_iris.jpg
|כיתוב תמונה=צילום של [[עין]] אנושית. ניתן להקיש על חלקים שונים כדי להגיע לערכים מורחבים המפרטים עליהם.
|מיפוי=
circle 1133 924 237 [[אישון|אישון העין]]
circle 1185 955 805 [[קשתית|קשתית (איריס)]]
poly 14 652 195 505 429 390 599 296 735 247 809 230 840 230 1181 195 1540 233 1878 331 2143 432 2321 530 2485 610 2593 680 2690 774 2774 899 2781 993 2774 1370 2119 1634 1600 1687 979 1645 477 1471 289 1425 10 1408 [[גלגל העין]]

}}

תוצאה

תבנית:מפת תמונה תבנית:מפת תמונה

לחיצה על "לחצו להגדלה" תביא להגדלת התמונה בדף עצמו, כך שהקוראים יוכלו לעיין בפרטים הקטנים, ולהישאר בדף הערך המסביר עליהם. זאת לעומת תמונות רגילות באקו-ויקי, בהן קוראים הרוצים לראות את התמונה המוגדלת מועברים מן הערך לדף במרחב הקבצים. במצב המוגדל משתנה הקישור ל"לחצו כדי להקטין חזרה" שמחזיר את התמונה לגודלה המקורי בדף.

הפונקציונליות של הגדלה תלויה ב-JavaScript. קוראים שביטלו אפשרות הרצת JavaScipt בדפדפן עדיין יראו תמונה אינטראקטיבית, אך ללא יכולת להגדילה בדף, וללא הקישור "לחצו להגדלה".

ניתן להקיש על הפרטים השונים בתמונה המוקטנת, וכן גם בתמונה המוגדלת. האייקון בפינה שמאלית תחתונה מקשר לקובץ התמונה במרחב הקבצים.

האייקון מקשר לדף הסבר על תמונות אינטראקטיביות - אקו-ויקי:תמונה אינטראקטיבית.

ראו גם