עריכת הדף "תבנית:תוכן נטען"

<noinclude>{{ניהול פרמטרים/תוכן}}</noinclude><includeonly>{{#invoke:ParamValidator|validateparams|module_options=יחידה:PV-options}}<!--
-->{{טען סקריפט|gadgetname=LoadingContent}} <!-- טעינת הגאדג'ט שמבצע את העבודה
--><div class="loadingContent" id="{{{מיקום התוכן}}}" title="{{{קישור ברירת מחדל}}}***{{#שווה:{{{קישור אקראי|}}}|כן|yes|no}}" style="{{{עיצוב|}}}">{{ {{{קישור ברירת מחדל}}} }}</div></includeonly><noinclude>
תבנית זו, יחד עם התבנית {{תב|קישור לתוכן נטען}}, משמשים ליצירת קישורים אשר לחיצה עליהם טוענת את קישור היעד בתוך תיבת תוכן. במילים אחרות, ניתן להיעזר בתבניות אלו כדי להציג תוכן דינמי מבלי לעזוב את הדף עצמו. התבנית מתבססת על סקריפט ([[מדיה ויקי:LoadingContent.js]]), ובעזרתו היא טוענת את התוכן ברקע ומציגה את התוכן בתיבה המתאימה.

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

__NOTOC__
{| class="toc"
|-
!תוכן עניינים:
|-
|
[[#הוראות שימוש|1 הוראות שימוש]]{{ש}}
{{רווח קשיח|4}}[[#יצירת טבלה|1.1 יצירת טבלה]]{{ש}}
{{רווח קשיח|4}}[[#הוספת תיבת תוכן|1.2 הוספת תיבת תוכן]]{{ש}}
{{רווח קשיח|4}}[[#הוספת קישורים|1.3 הוספת קישורים]]{{ש}}
{{רווח קשיח|4}}[[#תוצאה|1.4 תוצאה]]{{ש}}
[[#דוגמאות נוספות|2 דוגמאות נוספות]]{{ש}}
[[#טיפים|3 טיפים]]{{ש}}
|}

==הוראות שימוש==
ניעזר בדוגמה.

===יצירת טבלה===
מומלץ להיעזר בטבלה עם עמודות ברוחב קבוע או אחוז קבוע, ולכן ניצור תחילה טבלה פשוטה, המחולקת לשתיים והמתפרסת על פני כל העמוד:
<pre>
{| class="wikitable" width="100%"
|-valign="top"
| width="20%" | תא ראשון
| width="80%" | תא שני
|}
</pre>

שתוצאתו:
{| class="wikitable" width="100%"
|-valign="top"
| width="20%" | תא ראשון
| width="80%" | תא שני
|}

===הוספת תיבת תוכן===
את תיבת התוכן (שבו נטען היעד לאחר לחיצה על קישור) נוסיף בתא השני, ולכן נשנה את:

<pre>
| width="80%" | תא שני
</pre>
ל-
<pre>
| width="80%" | {{תוכן נטען|מיקום התוכן=moshiachnow|קישור ברירת מחדל=:הרבי}}
</pre>

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

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

===הוספת קישורים===
בתא הראשון נוסיף שלושה קישורים, בתוך רשימה, ולכן נשנה את:

<pre>
| width="20%" | תא ראשון
</pre>
ל-
<pre> 
| width="20%" |
* {{קישור לתוכן נטען|מיקום התוכן=moshiachnow|קישור=הרבי|כותרת=משיח}}
* {{קישור לתוכן נטען|מיקום התוכן=moshiachnow|בית המקדש|כותרת=המקדש|ברירת מחדל=כן}}
* {{קישור לתוכן נטען|מיקום התוכן=moshiachnow|קישור=מח}}
</pre>

לתבנית '''קישור לתוכן נטען''' 4 פרמטרים, מתוכם שניים חובה:
* בפרמטר החובה '''מיקום התוכן''' יש לציין את השם הייחודי של תיבת התוכן.
* בפרמטר החובה '''קישור''' יש לציין את קישור היעד (אין צורך בנקודתיים). אם הקישור כולל גרשיים, יש להחליפו בקוד ‏‏<code>‏<nowiki>& quot;</nowiki>‏</code> (בלי הרווח).
* בפרמטר '''כותרת''' ניתן לתת לַ‏קישור כותרת השונה משם הקישור. אם הכותרת כוללת גרשיים, יש להחליפה בקוד ‏‏<code>‏<nowiki>& quot;</nowiki>‏</code> (בלי הרווח).
* הפרמטר '''ברירת מחדל=כן''' משמש להגדרת הקישור כברירת מחדל - זהה לבחירה שנעשתה בתיבת התוכן. במקרה הנ"ל, הקישור לערך [[בית המקדש]] מקבל גם פרמטר זה. אם נעשה שימוש בפרמטר '''קישור אקראי=כן''' בתבנית "תוכן נטען", אין להשתמש בפרמטר זה באף אחד מהקישורים.

===תוצאה===
הקוד הסופי הוא זה:
<pre>
{| class="wikitable" width="100%"
|-valign="top"
| width="20%" |
* {{קישור לתוכן נטען|מיקום התוכן=moshiachnow|קישור=הרבי|כותרת=משיח}}
* {{קישור לתוכן נטען|מיקום התוכן=moshiachnow|קישור=בית המקדש|כותרת=המקדש|ברירת מחדל=כן}}
* {{קישור לתוכן נטען|מיקום התוכן=moshiachnow|קישור=מח}}

| width="80%" | * {{קישור לתוכן נטען|מיקום התוכן=moshiachnow|קישור=בית המקדש|כותרת=המקדש|ברירת מחדל=כן}}
</pre>

והתוצאה:
{| class="wikitable" width="100%"
|-valign="top"
| width="20%" |
* {{קישור לתוכן נטען|מיקום התוכן=moshiachnow|קישור=הרבי|כותרת=משיח}}
* {{קישור לתוכן נטען|מיקום התוכן=moshiachnow|קישור=בית המקדש|כותרת=המקדש|ברירת מחדל=כן}}
* {{קישור לתוכן נטען|מיקום התוכן=moshiachnow|קישור=מח}}


| width="80%" | {{תוכן נטען|מיקום התוכן=moshiachnow|קישור ברירת מחדל=:המקדש}}
|}

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

[[קטגוריה:תבניות]]
</noinclude>

<noinclude>
<templatedata>
{
	"params": {
		"מיקום התוכן": {},
		"קישור ברירת מחדל": {},
		"קישור אקראי": {},
		"עיצוב": {}
	},
	"description": "טוענת מראש דף מסוים דרך תבנית קישור ייעודית.",
	"format": "inline"
}
</templatedata>
</noinclude>