عرض مصدر قالب:صندوق مستخدم/شرح

{{صفحة توثيق فرعية}}
{{Lua|وحدة:صندوق مستخدم}}
{{استخدام واسع|{{صندوق مستخدم/شرح/عداد}}}}
<!-- فضلاً أضف التصانيف أسفل الصفحة. ووصلات الانترويكي في ويكي بيانات -->

يمكن استخدام هذا القالب لإنشاء [[أرابيكا:صناديق المستخدم|صندوق مستخدم]] بشكل سريع لعرضه على صفحة المستخدم دون الحاجة إلى معارف حول [[لغة توصيف النص الفائق]] (HTML) أو جداول ويكي.

''''' قد لا يتم عرض الصور [[أرابيكا:معايير المحتوى غير الحر|غير الحرة]] في صناديق المستخدمين، ويمكن أن تزال سريعاً من قبل أي محرر دون إشعار.'''''

== تذكير بالملعب ==
* دائمًا استخدم وجرب تعديلاتك في [[قالب:صندوق مستخدم/ملعب]] أو [[قالب:صندوق مستخدم/مختبر]]
* بمجرد أن تتأكد أن تعديلاتك سليمة: انسخ الكود الخاص بك!
* لإنشاء صندوق مستخدم جديد استعمل نطاق صفحة [[مستخدم:صندوق مستخدم]]
** أمثلة:
** '''غير''' [{{Fullurl:مستخدم:صندوق مستخدم/ملعب}} http://ar.wikipedia.org/wiki/مستخدم:صندوق مستخدم]<!--إظهار http://، ولكن اسمح بإمكانية https:// الوصول.-->
** '''إلى''' [{{Fullurl:مستخدم:صندوق مستخدم/}} https://ar.wikipedia.org/wiki/مستخدم:صندوق مستخدم/(أيا كان اسم قالب المستخدم الذي اخترته)]
** إذا كان اسم القالب الذي اخترته مستخدما بالفعل فاختر اسما مغايرا (لكن دائماً تأكد من أن القالب التي تنوي إنشاءه غير موجود بالفعل).
* سيُطلب منك بدء إنشاء قالب صندوق المستخدم الجديد!
* قم بلصق الكود الخاص بك في المساحة الفارغة.

== الاستعمال ==
<!-- الاستخدام المجرد للقالب، متغير واحد لكل صف. -->
<pre style="overflow: auto">
{{صندوق مستخدم
| bodyclass = <!--يضيف سمة فئة HTML إلى جدول HTML للقالب بأكمله، للسماح بالتصميم، وانبعاث التنسيقات الدقيقة، إلخ..-->
| لون الحدود = <!--لون الحدود (افتراضي=id-c أو #999999)-->
| سمك الحدود = <!--سمك الحدود بالبكسل (افتراضي=1)-->
| float = <!--left|right|none (افتراضي=يسار)-->
| الصورة = <!--صورة أو نص (يجب ألا يتجاوز حجم الصورة عادة 90x45px)-->
| موضع الصورة = <!--المحاذاة الأفقية للصورة left/center/right/justify (افتراضي=وسط)-->
| لون خلفية الصورة = <!--لون خلفية الصورة (افتراضي=#DDDDDD)-->
| لون الصورة = <!--لون خط الصورة في حالة استعمال نص (افتراضي=info-fc أو أسود)-->
| ارتفاع الصورة = <!--ارتفاع الصورة بالبكسل (افتراضي=45)-->
| المسافة بين أسطر الصورة = <!--المسافة بين أسطر الصورة (افتراضي=1.25em)-->
| إعدادات أخرى للصورة = <!--إعدادات CSS أخرى للصورة-->
| حشوة الصورة = <!--حشوة الصورة (افتراضي=0 1px 0 0)-->
| حجم خط الصورة = <!--حجم خط الصورة (افتراضي=14)-->
| id-w = <!--عرض الصورة بالبكسل (افتراضي=45)-->
| info-class = <!--يضيف سمة فئة HTML إلى صف جدول HTML ''المعلومات'' (النص)، للسماح بالتصميم، وانبعاث التنسيقات الدقيقة، إلخ..-->
| النص = <!--معلومات النص أو صورة-->
| موضع النص = <!--المحاذاة الأفقية للنص left/center/right/justify (افتراضي=يمين)-->
| لون خلفية النص = <!--لون خلفية النص (افتراضي=#EEEEEE)-->
| لون النص = <!--لون خط النص (افتراضي=أسود)-->
| المسافة بين أسطر النص = <!--المسافة بين أسطر النص (افتراضي=1.25em)-->
| إعدادات أخرى للنص = <!--إعدادات CSS أخرى للنص-->
| حشوة النص = <!--حشوة النص (افتراضي=0 4px 0 4px)-->
| حجم خط النص = <!--حجم خط النص (افتراضي=10)-->
| لا تصنيف = <!--يمنع إضافة صفحة المستخدم لأي تصنيف (افتراضي=معطلة)-->
| تصنيف مستخدم = <!--تصنيف مستخدمين (اختياري، دون وصلة وبدون البادئة "تصنيف:")-->
| تصنيف مستخدم 2 = <!--تصنيف مستخدمين (اختياري)-->
| تصنيف مستخدم 3 = <!--تصنيف مستخدمين (اختياري)-->
| تصنيف مستخدم 4 = <!--تصنيف مستخدمين (اختياري)-->
| تصنيف مستخدم 5 = <!--تصنيف مستخدمين (اختياري)-->
}}
</pre>
* جميع المعلمات اختيارية..
* يجب عادةً تغيير حجم الصور إلى x45px أو أقل.
<!-- اشرح ما تفعله معلمات هذا القالب -- إذا لم يكن هناك معلمات، احذف التعريف. -->

تستخدم معظم الجداول المستندة إلى HTML عددًا قليلاً فقط من هذه السمات. يمكن استخدام المجموعة الفرعية التالية لتحويل مربع مستخدم HTML بسرعة إلى التنسيق المستخدم هنا:

<pre>
{{صندوق مستخدم
| لون الحدود = 
| الصورة = 
| لون خلفية الصورة = 
| لون الصورة = 
| حجم خط الصورة = 
| النص = 
| لون خلفية النص = 
| لون النص = 
| المسافة بين الأسطر = 
| حجم خط النص = 
}}</pre>

=== مثال بسيط ===

{|
! style="width: 300px;" | الكود
! النتيجة
|-
| <pre>{{صندوق مستخدم
 |اسم القالب = مستخدم رجل
 |النص = هذا المستخدم رجل.
 |الصورة = [[ملف:Man.jpg|25px]]
}}</pre> || {{صندوق مستخدم
 |اسم القالب = مستخدم رجل
 |النص = هذا المستخدم رجل.
 |الصورة = [[ملف:Man.jpg|25px]]
}}
|-
| colspan="2"|
|}

=== مثال يستخدم بعض المتغيرات الإضافية ===

{|
! style="width: 300px;" | الكود
! النتيجة
|-
| <pre>{{صندوق مستخدم
 |اسم القالب = مستخدم رجل
 |النص = هذا المستخدم رجل.
 |حجم خط النص = 14
 |لون النص = #001100
 |لون خلفية النص = #ffffff
 |الصورة = [[ملف:Symbol mars.svg|43px]]
 |لون خلفية الصورة = #dddddd
 |حجم خط الصورة = 14
 |لون الحدود = #999999
}}</pre> || {{صندوق مستخدم
 |اسم القالب = مستخدم رجل
 |النص = هذا المستخدم رجل.
 |حجم خط النص = 14
 |لون النص = #001100
 |الصورة = [[ملف:Symbol mars.svg|43px]]
 |لون خلفية النص = #ffffff
 |لون خلفية الصورة = #dddddd
 |حجم خط الصورة = 14
 |لون الحدود = #999999
}}
|-
| colspan="2"|
|}

=== أمثلة توضيحية إضافية ===
{|
! style="width: 300px;" | الكود
! النتيجة
|-
| <pre>{{صندوق مستخدم
| لون الحدود = #aaffaa
| سمك الحدود = 2
| الصورة = foo
| لون خلفية الصورة = #ffffee
| = 20
| النص = ''مثال عن نص''
| لون خلفية النص = #ffeeff
| حجم خط النص = 12
}}</pre> || {{صندوق مستخدم|الصورة =foo|حجم خط الصورة=20|لون خلفية الصورة=#ffffee|النص=''مثال عن نص''|لون خلفية النص=#ffeeff|حجم خط النص=12|لون الحدود=#aaffaa|سمك الحدود=2}}
|-
| colspan="2"| يوضح المثال أدناه المظهر الافتراضي لصندوق المستخدم، والذي هو أعلى (بكثير) من 45 بكسل..<br>قارن حجم الصندوق أدناه بصندوق المستخدم أعلاه.
|-
| <pre>{{صندوق مستخدم
| لون الحدود = #aaffaa
| سمك الحدود = 2
| الصورة = foo logo
| لون خلفية الصورة =#ffffee
| النص = ''نحاول أن نرى المسافة الافتراضية بين خطوط النص، انظر المسافة بين محتوى الخلية وحدودها، ونرى أيضًا الارتفاع الإجمالي.''
| لون خلفية النص = #ffeeff
}}</pre> || {{صندوق مستخدم|الصورة =foo logo|لون خلفية الصورة=#ffffee|النص='''نحاول أن نرى المسافة الافتراضية بين خطوط النص، انظر المسافة بين محتوى الخلية وحدودها، ونرى أيضًا الارتفاع الإجمالي.''|لون خلفية النص=#ffeeff|لون الحدود=#aaffaa|سمك الحدود=2}}
|-
| colspan="2"| يوضح المثال أدناه كيف يمكننا تغيير صندوق المستخدم هذا وتحديد المزيد من المعلمات لتقليل الارتفاع الإجمالي لصندوق المستخدم إلى الارتفاع الموصى به وهو 45 بكسل، حتى مع وجود أربعة أسطر نصية. "''info-p''" يمكن أيضًا تعيينه في "''1pt 1pt 1pt 2pt''", أو "''1pt 2pt''" لمظهر أفضل,<br>عندما يكون هناك 4 أسطر نصية.
|-
| <pre>{{صندوق مستخدم
| لون الحدود = #aaffaa
| سمك الحدود = 1
| الصورة = foo logo
| لون خلفية الصورة = #ffffee
| المسافة بين أسطر الصورة = 1.1em
| حجم خط الصورة = 14
| النص = ''لدينا قيم محددة لتقليل المسافة بين سطور النص والمسافة المتروكة بينهما وبين محتوى الخلية وحدودها.''
| لون خلفية النص = #ffeeff
| المسافة بين أسطر النص = 1.05em
| حشوة النص = 1pt
| حجم خط النص = 10
}}</pre> || {{صندوق مستخدم|الصورة =foo logo|حجم خط الصورة=14|المسافة بين أسطر الصورة =1.1em|لون خلفية الصورة=#ffffee|النص=''لقد حددنا قيمًا لتقليل المسافة بين سطور النص ومساحة الحشو بين محتوى الخلية وحدودها.''|لون خلفية النص=#ffeeff|حجم خط النص=8|حشوة النص=1pt|المسافة بين أسطر النص=1.05em|لون الحدود=#aaffaa|سمك الحدود=1}}
|-
| colspan="2"| المثال أدناه للمستخدمين المتقدمين، يوضح كيف يمكننا تحديد خصائص [[أوراق الأنماط المتتالية|CSS]] أخرى، على سبيل المثال ، "''font-family''",<br>لتغيير الخط أو "''زخرفة النص''" لإضافة أسطر حول النص. أدناه، على الجانب الأيمن يوجد نوعان من صناديق المستخدمين:<br>يُعرض الصندوق العلوي بدون أي من المعلمات؛ وصندوق المستخدم السفلي هو المعروض باستخدام الكود أدناه ،<br>بمساعدة المدخلة "''إعدادات أخرى للنص''". 
|-
| <pre>{{صندوق مستخدم
| لون الحدود = #afa
| سمك الحدود = 2
| الصورة = foo logo
| لون خلفية الصورة = #ffe
| المسافة بين أسطر الصورة = 1.1em
| حجم خط الصورة = 14
| النص = مثال عن نص
| لون خلفية النص = #fef
| إعدادات أخرى للنص = font-family: 'Courier New', monospace; text-decoration: wavy overline green;
| حجم خط النص = 14
}}</pre> || colspan="2"| {{صندوق مستخدم|الصورة =foo logo|حجم خط الصورة=14|المسافة بين أسطر الصورة =1.1em|لون خلفية الصورة=#ffe|النص=مثال عن نص|لون خلفية النص=#fef|حجم خط النص=14|لون الحدود=#afa|سمك الحدود=2}} <br style="clear:both">&#160;<br /> {{صندوق مستخدم|الصورة =foo logo|حجم خط الصورة=14|المسافة بين أسطر الصورة =1.1em|لون خلفية الصورة=#ffe|النص=مثال عن نص|لون خلفية النص=#fef|حجم خط النص=14|إعدادات أخرى للنص=font-family: 'Courier New', monospace; text-decoration: wavy overline green;|لون الحدود=#afa|سمك الحدود=2}}
|}

== التنسيقات الدقيقة ==
; bodyclass : يتم إدراج هذه المعلمة في سمة 'class' الخاصة بصندوق المستخدم ككل.
; info-class : يتم إدراج هذه المعلمة في سمة 'class' لمكون المعلومات.

يدعم هذا القالب إضافة تنسيق [[ميكروفورمات]]. يتم ذلك عن طريق إضافة سمات 'class' إلى خلايا البيانات المختلفة، مما يشير إلى نوع المعلومات الموجودة بداخلها. لوضع علامة على صندوق مستخدم يحتوي على معلومات {{وإو|hCard|hCard}} حول شخص، على سبيل المثال، أضف المعلمة التالية:

<pre>
| bodyclass = vcard
</pre>

''أو''

<pre>
| info-class = vcard
</pre>

''بعد ذلك'' (على سبيل المثال):

<pre><nowiki>
| title = …كتب المؤلف <span class="fn">[[إيان بانكس]]</span>
</nowiki></pre>

...وهكذا دواليك.

المثال يشمل:

* <code>{{tlu|مستخدم:صندوق مستخدم/مستخدم إيان بانكس}}</code> - شخص

== بيانات القالب ==
{{رأس بيانات القالب}}

<TemplateData>{
 "description": "يمكن استخدام هذا القالب لإنشاء صندوق مستخدم بشكل سريع لعرضه على صفحة المستخدم دون الحاجة إلى معارف حول لغة توصيف النص الفائق (HTML) أو جداول ويكي.",
 "params": {
 "bodyclass": {
 "label": "Body class",
 "description": "Adds an HTML class attribute to the entire template's HTML table, to allow for styling, emission of microformats, etc.",
 "type": "string",
 "required": false
 },
 "float": {
 "label": "Float",
 "description": "left|right|none",
 "type": "string",
 "default": "left",
 "required": false,
 "suggestedvalues": [
 "left",
 "right",
 "none"
 ]
 },
 "id-c": {
 "label": "id-c",
 "description": "Two-in-one alias for border color and logo background color. Lower priority than border-c and logo-background",
 "type": "string",
 "required": false,
 "aliases": [
 "1"
 ],
 "example": "#d0d0d0"
 },
 "id-fc": {
 "label": "Logo font color",
 "description": "Logo font color; if not specified, defaults to info font color",
 "type": "string",
 "default": "black",
 "required": false,
 "aliases": [
 "logo-color"
 ]
 },
 "id-h": {
 "label": "Logo height",
 "description": "Logo box height in pixels",
 "type": "number",
 "default": "45",
 "required": false,
 "aliases": [
 "logo-height"
 ]
 },
 "id-lh": {
 "label": "Logo line height",
 "description": "Logo line height",
 "type": "string",
 "default": "1.25em",
 "required": false,
 "aliases": [
 "logo-line-height"
 ]
 },
 "id-op": {
 "label": "Extra logo styling",
 "description": "Add additional arbitrary CSS styling to the logo",
 "type": "string",
 "required": false,
 "aliases": [
 "logo-other-param"
 ],
 "example": "opacity: 0.25"
 },
 "id-p": {
 "label": "Logo padding",
 "description": "Logo cell padding",
 "type": "string",
 "default": "0 1px 0 0",
 "required": false,
 "aliases": [
 "logo-padding"
 ]
 },
 "id-s": {
 "label": "Logo font size",
 "description": "Logo text size in points",
 "type": "string",
 "default": "14",
 "required": false,
 "aliases": [
 "5",
 "logo-size"
 ]
 },
 "id-w": {
 "label": "Logo width",
 "description": "id box width in pixels",
 "type": "number",
 "default": "45",
 "required": false,
 "aliases": [
 "logo-width"
 ]
 },
 "info-class": {
 "label": "Info CSS classes",
 "description": "Adds an HTML class attribute to the \"info\" HTML table-row, to allow for styling, emission of microformats, etc.",
 "type": "string",
 "required": false
 },
 "info": {
 "label": "Info",
 "description": "info text or image",
 "type": "content",
 "required": true,
 "aliases": [
 "4"
 ]
 },
 "info-a": {
 "label": "Info content horizontal alignment",
 "description": "Horizontal alignment of info content; left/center/right/justify",
 "type": "string",
 "default": "left",
 "required": false,
 "suggestedvalues": [
 "left",
 "center",
 "right",
 "justify"
 ]
 },
 "info-c": {
 "label": "Info background color",
 "description": "Info background color",
 "type": "string",
 "default": "#e0e0e0",
 "required": false,
 "aliases": [
 "2",
 "info-background"
 ]
 },
 "info-fc": {
 "label": "Info font color",
 "description": "info font color",
 "type": "string",
 "default": "black",
 "required": false,
 "aliases": [
 "info-color"
 ]
 },
 "info-lh": {
 "label": "Info line height",
 "description": "Info line height",
 "type": "string",
 "default": "1.25em",
 "required": false,
 "aliases": [
 "info-line-height"
 ]
 },
 "info-op": {
 "label": "Extra info styling",
 "description": "Add additional arbitrary CSS styling to the info",
 "type": "string",
 "required": false,
 "aliases": [
 "info-other-param"
 ],
 "example": "opacity: 0.25"
 },
 "info-p": {
 "label": "Info padding",
 "description": "info padding",
 "type": "string",
 "default": "0 4px 0 4px",
 "required": false,
 "aliases": [
 "info-padding"
 ]
 },
 "info-s": {
 "label": "Info font size",
 "description": "info text size in points",
 "type": "number",
 "default": "8",
 "required": false,
 "aliases": [
 "info-size"
 ]
 },
 "logo-background": {
 "label": "Logo background color",
 "description": "Background color of logo",
 "type": "string",
 "default": "#ddd"
 },
 "id-class": {
 "label": "Logo CSS classes",
 "description": "CSS class or classes for the logo; optional",
 "type": "string",
 "default": "(none)"
 },
 "تصنيف مستخدم": {
 "aliases": [
 "usercategory"
 ],
 "label": "تصنيف مستخدم",
 "description": "تصنيف مستخدمين (اختياري)",
 "type": "string",
 "suggested": true
 },
 "تصنيف مستخدم 2": {
 "aliases": [
 "usercategory2"
 ],
 "label": "تصنيف مستخدم 2",
 "description": "تصنيف مستخدمين (اختياري)",
 "type": "string"
 },
 "تصنيف مستخدم 3": {
 "aliases": [
 "usercategory3"
 ],
 "label": "تصنيف مستخدم 3",
 "description": "تصنيف مستخدمين (اختياري)",
 "type": "string"
 },
 "تصنيف مستخدم 4": {
 "aliases": [
 "usercategory4"
 ],
 "label": "تصنيف مستخدم 4",
 "description": "تصنيف مستخدمين (اختياري)",
 "type": "string"
 },
 "تصنيف مستخدم 5": {
 "aliases": [
 "usercategory5"
 ],
 "label": "تصنيف مستخدم 5",
 "description": "تصنيف مستخدمين (اختياري)",
 "type": "string"
 },
 "لا تصنيف": {
 "aliases": [
 "nocat"
 ],
 "label": "لا تصنيف",
 "description": "يمنع إضافة صفحة المستخدم لأي تصنيف",
 "type": "string",
 "default": "معطل"
 },
 "لون الحدود": {
 "aliases": [
 "border-color",
 "border-c"
 ],
 "label": "لون الحدود",
 "description": "لون الحدود الخارجية للقالب",
 "type": "string",
 "default": "#999"
 },
 "سمك الحدود": {
 "aliases": [
 "border-width",
 "border-s"
 ],
 "label": "سمك الحدود",
 "description": "سمك الحدود بالبكسل",
 "type": "number",
 "default": "1"
 },
 "الصورة": {
 "aliases": [
 "3",
 "logo",
 "id"
 ],
 "label": "الصورة",
 "description": "قد تكون صورة أو النص",
 "type": "content",
 "suggested": true
 },
 "موضع الصورة": {
 "aliases": [
 "id-a"
 ],
 "label": "موضع الصورة",
 "description": "محاذاة أفقية لمحتوى الشعار؛ left/center/right/justify",
 "type": "string",
 "suggestedvalues": [
 "left",
 "center",
 "right",
 "justify"
 ],
 "default": "center"
 }
 },
 "format": "block",
 "paramOrder": [
 "bodyclass",
 "float",
 "لون الحدود",
 "سمك الحدود",
 "الصورة",
 "موضع الصورة",
 "logo-background",
 "id-c",
 "id-fc",
 "id-h",
 "id-s",
 "id-lh",
 "id-p",
 "id-w",
 "id-class",
 "id-op",
 "info",
 "info-a",
 "info-c",
 "info-fc",
 "info-lh",
 "info-p",
 "info-s",
 "info-class",
 "info-op",
 "لا تصنيف",
 "تصنيف مستخدم",
 "تصنيف مستخدم 2",
 "تصنيف مستخدم 3",
 "تصنيف مستخدم 4",
 "تصنيف مستخدم 5"
 ]
}</TemplateData>

<includeonly>{{ملعب أخر||
<!-- [[تصنيف:قوالب أرابيكا]] -->
}}</includeonly>