עריכת הדף "תבנית:ריבוע צבע/תיעוד"

התבנית מיועדת להדגמת צבעים, על ידי הצגת ריבוע קטן בצבע נתון.
== שימוש ==
===צבע הריבוע===
הפרמטר הראשון שהתבנית מקבלת הוא צבע הריבוע. ניתן להעביר את הצבע בקוד RGB הקסדצימלי (ראו גם [[עזרה:צבעים]], ו[[ויקיפדיה:ערכת צבעים#ערכת צבעים]]):

{{קוד|{{תב|ריבוע צבע|{{משמאל לימין|#8000FF}}}}|מימין לשמאל=כן}} ← {{ריבוע צבע|#8000FF}}

ניתן להיעזר לשם כך גם בתבנית {{תב|איכ}} (אדום\ירוק\כחול):

{{קוד|{{תב|ריבוע צבע|<nowiki>{{איכ|128|0|255}}</nowiki>}}|מימין לשמאל=כן}} ← {{ריבוע צבע|{{איכ|128|0|255}}}}

ניתן גם להעביר את שם הצבע, בעברית (על פי רשימת השמות הנתמכת ב{{תב|תרגום צבע}}):

{{קוד|{{תב|ריבוע צבע|אדום}}|מימין לשמאל=כן}} ← {{ריבוע צבע|אדום}}

או באנגלית:

{{קוד|{{תב|ריבוע צבע|red}}|מימין לשמאל=כן}} ← {{ריבוע צבע|red}}

אם משאירים את הפרמטר הזה ריק, הריבוע יהיה "שקוף", כלומר יקבל את צבע הרקע של הסביבה:

{{קוד|{{תב|ריבוע צבע}}|מימין לשמאל=כן}} ← {{ריבוע צבע}}

במידה ומעוניינים להשאיר את הריבוע שקוף ולהזין פרמטרים נוספים (ראו להלן), יש להשתמש בשני תווים של קו עומד {{קוד|{{!!}}}} כדי להשאיר את פרמטר הצבע ריק:

{{קוד|{{תב|ריבוע צבע|{{!}}גודל{{=}}2אמ}}|מימין לשמאל=כן}} ← {{ריבוע צבע||גודל=2אמ}}

=== גודל, צורה ומיקום ===

ניתן לשנות את גודלו של הריבוע, וכן את [[יחס גובה-רוחב (גאומטריה)|יחס הגובה-רוחב שלו]] (ובכך להפוך אותו ל[[מלבן]]). כמו כן, ניתן לקבוע שפינות הריבוע תהיינה עגולות. בנוסף, ניתן לקבוע כיצד ליישר אותו ביחס לשורות הטקסט שמכיל אותו.

==== גודל ====

את גודל הריבוע ניתן לשנות על ידי הפרמטר {{פר|גודל}}, אליו מזינים מספר ומיד אחריו יחידת אורך, מתוך יחידות האורך שמתוארות ב{{תב|תרגום אורך}}. ברירת המחדל היא {{קוד|1אמ|מימין לשמאל=כן}}, או {{קוד|1em}}, כלומר גודל הגופן הפעיל כרגע. ניתן לשנות זאת:

{{קוד|1={{תב|ריבוע צבע|כתום{{!}}גודל{{=}}1אמ}}|מימין לשמאל=כן}} ← {{ריבוע צבע|כתום|גודל=1אמ}}

{{קוד|1={{תב|ריבוע צבע|כתום{{!}}גודל{{=}}2אמ}}|מימין לשמאל=כן}} ← {{ריבוע צבע|כתום|גודל=2אמ}}

{{קוד|1={{תב|ריבוע צבע|כתום{{!}}גודל{{=}}0.5אמ}}|מימין לשמאל=כן}} ← {{ריבוע צבע|כתום|גודל=0.5אמ}}

נכון לזמן כתיבת שורות אלה, ברירת המחדל עבור גודל הגופן בוויקיפדיה היא 12 נקודות ({{קוד|12נק|מימין לשמאל=כן}}, שהם 16 פיקסלים {{קוד|16פק|מימין לשמאל=כן}}). להלן ריבוע שגודלו {{קוד|1אמ|מימין לשמאל=כן}}, ולידו ריבוע שגודלו {{קוד|16פק|מימין לשמאל=כן}}: {{ריבוע צבע|כתום|גודל=1אמ}} {{ריבוע צבע|כתום|גודל=16פק}}

כאשר קובעים את גודל הריבוע באמצעות יחידות של גודל הגופן, אז ריבוע (למשל בגודל 1אמ) שמוצב בתוך טקסט רגיל יהיה {{ריבוע צבע|כתום|גודל=1אמ}} בגודל מסוים על המסך, {{גודל|4|ו"אותו ריבוע" שנמצא בתוך טקסט גדול יותר יהיה גם הוא {{ריבוע צבע|כתום|גודל=1אמ}} גדול יותר על המסך.}} אם מעוניינים שריבוע ישמור על גודלו ללא תלות בגודל הטקסט, ניתן להשתמש ביחידת המידה {{קוד|שר}}, ששווה לגודל הגופן הבסיסי של דף האינטרנט הנוכחי (של "אלמנט השורש" שלו), וכך {{ריבוע צבע|כתום|גודל=1שר}} גודל הריבוע {{גודל|1|לא {{ריבוע צבע|כתום|גודל=1שר}} ישתנה}} {{גודל|4|כאשר גודל הטקסט {{ריבוע צבע|כתום|גודל=1שר}} משתנה}}. לחלופין, ניתן להשתמש ביחידות מידה מוחלטות כגון {{קוד|ממ}} (מילימטר) או {{קוד|פק}} (פיקסל), אך אז אובד הקשר לגודל הטקסט בסביבה.

==== צורה ====

ניתן להפוך את הריבוע למלבן על ידי קביעת היחס בין רוחבו לגובהו, בעזרת הפרמטר {{פר|יחס}}. הפרמטר הזה לא משפיע על גובה המלבן (שנקבע ישירות על ידי הפרמטר {{פר|גודל}}); הוא משנה את הרוחב, שיהיה שווה למכפלה {{קוד|גודל×יחס}}. לדוגמה:

{{קוד|1={{תב|ריבוע צבע|חום{{!}}יחס{{=}}1}}|מימין לשמאל=כן}} ← {{ריבוע צבע|חום|יחס=1}}

{{קוד|1={{תב|ריבוע צבע|חום{{!}}יחס{{=}}4}}|מימין לשמאל=כן}} ← {{ריבוע צבע|חום|יחס=4}}

{{קוד|1={{תב|ריבוע צבע|חום{{!}}יחס{{=}}0.5}}|מימין לשמאל=כן}} ← {{ריבוע צבע|חום|יחס=0.5}}

{{קוד|1={{תב|ריבוע צבע|{{!}}גודל{{=}}0.5אמ{{!}}יחס{{=}}2}}|מימין לשמאל=כן}} ← {{ריבוע צבע|חום|גודל=0.5אמ|יחס=2}}

ניתן לעגל את פינותיו של ריבוע הצבע על ידי שימוש בפרמטר {{פר|עיגול פינות}}, אליו מזינים את רדיוס רבעי המעגל שיחליפו את הפינות (כמספר ויחידת אורך):

{{קוד|1={{תב|ריבוע צבע|זהב{{!}}גודל{{=}}2אמ{{!}}עיגול פינות{{=}}0פק}}|מימין לשמאל=כן}} ← {{ריבוע צבע|זהב|גודל=2אמ|עיגול פינות=0פק}}

{{קוד|1={{תב|ריבוע צבע|זהב{{!}}גודל{{=}}2אמ{{!}}עיגול פינות{{=}}3פק}}|מימין לשמאל=כן}} ← {{ריבוע צבע|זהב|גודל=2אמ|עיגול פינות=3פק}}

{{קוד|1={{תב|ריבוע צבע|זהב{{!}}גודל{{=}}2אמ{{!}}עיגול פינות{{=}}10פק}}|מימין לשמאל=כן}} ← {{ריבוע צבע|זהב|גודל=2אמ|עיגול פינות=10פק}}

הגודל שמזינים הוא הרדיוס ''החיצוני''; כלומר, יש לקחת בחשבון את עובי המסגרת (ראו להלן). למשל, אם מעוניינים להפוך ריבוע שאורך צלעו {{קוד|32פק|מימין לשמאל=כן}} למעגל (באמצעות עיגול פינות), אז רדיוס של {{קוד|16פק|מימין לשמאל=כן}} לא יספיק, שכן יש למסגרת עובי של פיקסל נוסף: 

{{קוד|1={{תב|ריבוע צבע|זהב{{!}}גודל{{=}}32פק{{!}}עיגול פינות{{=}}16פק}}|מימין לשמאל=כן}} ← {{ריבוע צבע|זהב|גודל=32פק|עיגול פינות=16פק}}

כדי לקבל מעגל מושלם, יש להוסיף את עובי המסגרת (או יותר); במקרה שלנו, {{קוד|16פק|מימין לשמאל=כן}}+{{קוד|1פק|מימין לשמאל=כן}}={{קוד|17פק|מימין לשמאל=כן}}:

{{קוד|1={{תב|ריבוע צבע|זהב{{!}}גודל{{=}}32פק{{!}}עיגול פינות{{=}}17פק}}|מימין לשמאל=כן}} ← {{ריבוע צבע|זהב|גודל=32פק|עיגול פינות=17פק}}

==== מיקום ====

ניתן לקבוע את מיקומו האנכי של הריבוע יחסית לשורת הטקסט שמכילה אותו בעזרת הפרמטר {{פר|ישור}}. ברירת המחדל: {{קוד|טקסט עליון}}.

הערכים {{קוד|על}}, {{קוד|למעלה}}, {{קוד|קו בסיס}}, {{קוד|תת}}, ו{{קוד|טקסט תחתון}}, מיישרים כולם את הצלע ''העליונה'' של הריבוע לקו כלשהו בסביבת הצד העליון של שורת הטקסט, כאשר הקו שמתאים ל{{קוד|על}} נמצא בגובה הגבוה ביותר, וזה שמתאים ל{{קוד|טקסט תחתון}} נמצא בגובה הנמוך ביותר מבין החמישה האלה; הערך {{קוד|מרכז}} מיישר את ''מרכז'' הריבוע לקו שנמצא סביב מרכז שורת הטקסט; והערכים {{קוד|טקסט עליון}} ו{{קוד|למטה}} מיישרים את הצלע ''התחתונה'' של הריבוע לקו שנמצא סביב תחתית שורת הטקסט, כאשר הקו של {{קוד|טקסט עליון}} גבוה מזה של {{קוד|למטה}}.

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

{{קוד|1=אבג{{תב|ריבוע צבע|ורוד{{!}}גודל{{=}}0.5אמ{{!}}ישור{{=}}'''[ישור]'''}}דהו{{תב|ריבוע צבע|ורוד{{!}}גודל{{=}}1אמ{{!}}ישור{{=}}'''[ישור]'''}}זחט{{תב|ריבוע צבע|ורוד{{!}}גודל{{=}}1.5אמ{{!}}ישור{{=}}'''[ישור]'''}}יכל|מימין לשמאל=כן}}

כאשר בכל דוגמה, הטקסט {{קוד|'''[ישור]'''}} מוחלף (בכל הופעותיו) באחת מאפשרויות היישור, והיא זו שתצוין בכל שורה להלן.

{{קוד|'''[ישור]''' {{=}} על|מימין לשמאל=כן}} ← אבג{{ריבוע צבע|ורוד|גודל=0.5אמ|ישור=על}}דהו{{ריבוע צבע|ורוד|גודל=1אמ|ישור=על}}זחט{{ריבוע צבע|ורוד|גודל=1.5אמ|ישור=על}}יכל

{{קוד|'''[ישור]''' {{=}} למעלה|מימין לשמאל=כן}} ← אבג{{ריבוע צבע|ורוד|גודל=0.5אמ|ישור=למעלה}}דהו{{ריבוע צבע|ורוד|גודל=1אמ|ישור=למעלה}}זחט{{ריבוע צבע|ורוד|גודל=1.5אמ|ישור=למעלה}}יכל

{{קוד|'''[ישור]''' {{=}} קו בסיס|מימין לשמאל=כן}} ← אבג{{ריבוע צבע|ורוד|גודל=0.5אמ|ישור=קו בסיס}}דהו{{ריבוע צבע|ורוד|גודל=1אמ|ישור=קו בסיס}}זחט{{ריבוע צבע|ורוד|גודל=1.5אמ|ישור=קו בסיס}}יכל

{{קוד|'''[ישור]''' {{=}} תת|מימין לשמאל=כן}} ← אבג{{ריבוע צבע|ורוד|גודל=0.5אמ|ישור=תת}}דהו{{ריבוע צבע|ורוד|גודל=1אמ|ישור=תת}}זחט{{ריבוע צבע|ורוד|גודל=1.5אמ|ישור=תת}}יכל

{{קוד|'''[ישור]''' {{=}} טקסט תחתון|מימין לשמאל=כן}} ← אבג{{ריבוע צבע|ורוד|גודל=0.5אמ|ישור=טקסט תחתון}}דהו{{ריבוע צבע|ורוד|גודל=1אמ|ישור=טקסט תחתון}}זחט{{ריבוע צבע|ורוד|גודל=1.5אמ|ישור=טקסט תחתון}}יכל

{{קוד|'''[ישור]''' {{=}} מרכז|מימין לשמאל=כן}} ← אבג{{ריבוע צבע|ורוד|גודל=0.5אמ|ישור=מרכז}}דהו{{ריבוע צבע|ורוד|גודל=1אמ|ישור=מרכז}}זחט{{ריבוע צבע|ורוד|גודל=1.5אמ|ישור=מרכז}}יכל

{{קוד|'''[ישור]''' {{=}} טקסט עליון|מימין לשמאל=כן}} ← אבג{{ריבוע צבע|ורוד|גודל=0.5אמ|ישור=טקסט עליון}}דהו{{ריבוע צבע|ורוד|גודל=1אמ|ישור=טקסט עליון}}זחט{{ריבוע צבע|ורוד|גודל=1.5אמ|ישור=טקסט עליון}}יכל

{{קוד|'''[ישור]''' {{=}} למטה|מימין לשמאל=כן}} ← אבג{{ריבוע צבע|ורוד|גודל=0.5אמ|ישור=למטה}}דהו{{ריבוע צבע|ורוד|גודל=1אמ|ישור=למטה}}זחט{{ריבוע צבע|ורוד|גודל=1.5אמ|ישור=למטה}}יכל

=== מסגרת ===

בעזרת הפרמטרים {{פר|צבע מסגרת}}, {{פר|עובי מסגרת}} ו-{{פר|סגנון מסגרת}}, ניתן לעצב את המסגרת של הריבוע.

==== צבע מסגרת ====

ניתן להזין צבע עבור המסגרת באותו אופן שתואר לעיל עבור צבע הריבוע: RGB, שם בעברית, או שם באנגלית. ברירת מחדל: שחור.

{{קוד|1={{תב|ריבוע צבע|לבן{{!}}צבע מסגרת{{=}}אדום}}|מימין לשמאל=כן}} ← {{ריבוע צבע|לבן|צבע מסגרת=אדום}}

{{קוד|1={{תב|ריבוע צבע|לבן{{!}}צבע מסגרת{{=}}כחול}}|מימין לשמאל=כן}} ← {{ריבוע צבע|לבן|צבע מסגרת=כחול}}

==== עובי מסגרת ====

ניתן להזין עובי עבור המסגרת באמצעות מספר ומיד אחריו יחידת אורך, מתוך יחידות האורך שמתוארות ב{{תב|תרגום אורך}}. למשל, כדי לקבוע עובי מסגרת של שני פיקסלים, ניתן להזין {{קוד|2פק|מימין לשמאל=כן}} או {{קוד|2px}}. ברירת מחדל: פיקסל אחד.

{{קוד|1={{תב|ריבוע צבע|לבן{{!}}עובי מסגרת{{=}}2פק}}|מימין לשמאל=כן}} ← {{ריבוע צבע|לבן|עובי מסגרת=2פק}}

{{קוד|1={{תב|ריבוע צבע|לבן{{!}}עובי מסגרת{{=}}4פק}}|מימין לשמאל=כן}} ← {{ריבוע צבע|לבן|עובי מסגרת=4פק}}

==== סגנון מסגרת ====

קיימים מספר סגנונות בהם ניתן להשתמש עבור המסגרת. ברירת מחדל: רגיל.

{{קוד|1={{תב|ריבוע צבע|אדום{{!}}עובי מסגרת{{=}}3פק{{!}}סגנון מסגרת{{=}}רגיל}}|מימין לשמאל=כן}} ← {{ריבוע צבע|אדום|עובי מסגרת=3פק|סגנון מסגרת=רגיל}}

{{קוד|1={{תב|ריבוע צבע|אדום{{!}}עובי מסגרת{{=}}3פק{{!}}סגנון מסגרת{{=}}מנוקד}}|מימין לשמאל=כן}} ← {{ריבוע צבע|אדום|עובי מסגרת=3פק|סגנון מסגרת=מנוקד}}

{{קוד|1={{תב|ריבוע צבע|אדום{{!}}עובי מסגרת{{=}}3פק{{!}}סגנון מסגרת{{=}}מקוטע}}|מימין לשמאל=כן}} ← {{ריבוע צבע|אדום|עובי מסגרת=3פק|סגנון מסגרת=מקוטע}}

{{קוד|1={{תב|ריבוע צבע|אדום{{!}}עובי מסגרת{{=}}3פק{{!}}סגנון מסגרת{{=}}כפול}}|מימין לשמאל=כן}} ← {{ריבוע צבע|אדום|עובי מסגרת=3פק|סגנון מסגרת=כפול}}

{{קוד|1={{תב|ריבוע צבע|אדום{{!}}עובי מסגרת{{=}}3פק{{!}}סגנון מסגרת{{=}}חריץ}}|מימין לשמאל=כן}} ← {{ריבוע צבע|אדום|עובי מסגרת=3פק|סגנון מסגרת=חריץ}}

{{קוד|1={{תב|ריבוע צבע|אדום{{!}}עובי מסגרת{{=}}3פק{{!}}סגנון מסגרת{{=}}רכס}}|מימין לשמאל=כן}} ← {{ריבוע צבע|אדום|עובי מסגרת=3פק|סגנון מסגרת=רכס}}

{{קוד|1={{תב|ריבוע צבע|אדום{{!}}עובי מסגרת{{=}}3פק{{!}}סגנון מסגרת{{=}}שקוע}}|מימין לשמאל=כן}} ← {{ריבוע צבע|אדום|עובי מסגרת=3פק|סגנון מסגרת=שקוע}}

{{קוד|1={{תב|ריבוע צבע|אדום{{!}}עובי מסגרת{{=}}3פק{{!}}סגנון מסגרת{{=}}בולט}}|מימין לשמאל=כן}} ← {{ריבוע צבע|אדום|עובי מסגרת=3פק|סגנון מסגרת=בולט}}

{{קוד|1={{תב|ריבוע צבע|אדום{{!}}עובי מסגרת{{=}}3פק{{!}}סגנון מסגרת{{=}}נסתר}}|מימין לשמאל=כן}} ← {{ריבוע צבע|אדום|עובי מסגרת=3פק|סגנון מסגרת=נסתר}}

{{קוד|1={{תב|ריבוע צבע|אדום{{!}}עובי מסגרת{{=}}3פק{{!}}סגנון מסגרת{{=}}ללא}}|מימין לשמאל=כן}} ← {{ריבוע צבע|אדום|עובי מסגרת=3פק|סגנון מסגרת=ללא}}

== דוגמאות ==

* צבע [[דגל ישראל]]: {{קוד|{{תב|ריבוע צבע|<nowiki>#0038b8</nowiki>}}|מימין לשמאל=כן}}{{קוד|{{תב|ריבוע צבע|<nowiki>לבן</nowiki>}}|מימין לשמאל=כן}} ← {{ריבוע צבע|#0038b8}}{{ריבוע צבע|לבן}}
* בערך [[לפיס לזולי]]: {{קוד|{{תב|ריבוע צבע|<nowiki>{{איכ|37|127|239}}</nowiki>}}|מימין לשמאל=כן}} ← {{ריבוע צבע|{{איכ|37|127|239}}}}
* צבע [[ירוק]]:  {{קוד|{{תב|ריבוע צבע|<nowiki>green</nowiki>}}|מימין לשמאל=כן}} ← {{ריבוע צבע|green}}

==דפי משנה==
*[[תבנית:ריבוע צבע/בדיקות]]
*[[תבנית:ריבוע צבע/ברירת מחדל]]
==ראו גם==
{{תבנויות דוגמית צבע}}