عرض مصدر CSS/text-emphasis

<noinclude>{{DISPLAYTITLE:الخاصية <code>text-emphasis</code>}}</noinclude>
الخاصية <code>text-decoration</code> في CSS تُحدِّد علامة التوكيد (emphasis mark) المستخدمة على كل محرف نصي في العنصر باستثناء الفراغات ومحارف التحكم (control chars، مثل محرف السطر الجديد، ومحرف العودة إلى بداية السطر)؛ وهي خاصيةٌ مختصرة لضبط قيمة أكثر من خاصية عن ضبط علامات التوكيد معًا، وهي تتضمن <code>[[CSS/text-emphasis-style|text-emphasis-style]]</code> و <code>[[CSS/text-emphasis-color|text-emphasis-color]]</code>.

== بطاقة الخاصية ==
{| class="wikitable" style="width: 100%;"
|-
! scope="row" style="width: 20%;" |[[CSS/initial value|القيمة الابتدائية]]
|لكل قيمة مختصرة:
* <code>[[CSS/text-emphasis-style|text-emphasis-style]]</code>: <code>none</code>
* <code>[[CSS/text-emphasis-color|text-emphasis-color]]</code>: <code>currentcolor</code>
|-
! scope="row" |تُطبَّق على
|جميع العناصر.
|-
! scope="row" |قابلة للوراثة
|لا
|-
!قابلة للتحريك
|لا، باستثناء قيمة الخاصية <code>[[CSS/text-emphasis-color|text-emphasis-color]]</code>.
|-
! scope="row" |الوسائط
|مرئية
|-
! scope="row" |القيمة المحسوبة
|لكل قيمة مختصرة:
* <code>[[CSS/text-emphasis-style|text-emphasis-style]]</code>: كما حُدِّدَت.
* <code>[[CSS/text-emphasis-color|text-emphasis-color]]</code>: قيمة لونية <code>[[CSS/color value|<color>]]</code>.
|}

<syntaxhighlight lang="css">
/* القيمة الابتدائية */
text-emphasis: none; /* No emphasis marks */

/* <string> سلاسل نصية */
text-emphasis: 'x';
text-emphasis: '点';
text-emphasis: '\25B2';
text-emphasis: '*' #555;
text-emphasis: 'foo'; /* لا تستخدم هذه القيمة، فقد يُعرَض أوّل محرف منها فقط */

/* الكلمات المحجوزة */
text-emphasis: filled;
text-emphasis: open;
text-emphasis: filled sesame;
text-emphasis: open sesame;

/* استخدام كلمة محجوزة مع تحديد لون */
text-emphasis: filled sesame #555;

/* القيم العامة */
text-emphasis: inherit;
text-emphasis: initial;
text-emphasis: unset;
</syntaxhighlight>الخاصية <code>text-emphasis</code> تختلف اختلافًا كبيرًا عن الخاصية <code>text-decoration</code>، إذ إنَّ الخاصية <code>text-decoration</code> لا تورَّث، وإنما ستُطبَّق على العنصر وجميع العناصر الأبناء؛ لكن الخاصية <code>text-emphasis</code> ستورَّث، مما يعني أنَّ بالإمكان تغيير علامات التوكيد في العناصر الأبناء.

تكون أبعاد علامة التوكيد حوالي 50% من قياس الخط، وقد تؤثر الخاصية <code>text-emphasis</code> على ارتفاع السطر إن لم تتسع العلامات فيه.

ملاحظة: لن تؤدي الخاصية <code>text-emphasis</code> إلى إعادة ضبط قيمة الخاصية <code>[[CSS/text-emphasis-position|text-emphasis-position]]</code> لأنَّ من المحتمل أن يتغير شكل ولون علامات التوكيد في النص، لكن من غير الشائع أن يتغيّر مكانها.

== أمثلة ==
مثال عن استخدام الخاصية <code>text-emphasis</code> على العنصر <code>[[HTML/strong|<nowiki><strong></nowiki>]]</code> لضبط قيمة الخاصية <code>[[CSS/text-emphasis-style|text-emphasis-style]]</code> إلى <code>triangle</code>، والخاصية <code>[[CSS/text-emphasis-color|text-emphasis-color]]</code>  إلى <code>salmon</code>:<syntaxhighlight lang="html">
<strong>هذا نصٌ مهمٌ جدًا!</strong>
</syntaxhighlight>شيفرة CSS:<syntaxhighlight lang="css">
strong {
  text-emphasis: triangle salmon;
}
</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|25.0 مع السابقة <code>-webkit-</code>
|46.0
|غير مدعومة
|15.0 مع السابقة <code>-webkit-</code>
|7.1
|}
== البنية العامة ==
تقبل الخاصية <code>text-emphasis</code> القيم الآتية.
===  <code><text-emphasis-style></code> ===
شكل علامة التوكيد، راجع صفحة الخاصية <code>[[CSS/text-emphasis-style|text-emphasis-style]]</code> لمزيدٍ من المعلومات. 

===  <code><text-emphasis-color></code> ===
لون علامات التوكيد، انظر صفحة الخاصية <code>[[CSS/text-emphasis-color|text-emphasis-color]]</code> لمزيدٍ من المعلومات.

=== البنية الرسمية ===
<syntaxhighlight lang="css">
text-emphasis: <text-emphasis-style>||<text-emphasis-color>|initial|inherit;

</syntaxhighlight>
== مصادر ومواصفات ==
* مواصفة [https://drafts.csswg.org/css-text-decor-3/#text-emphasis-property CSS Text Decoration Module Level 3]. 
[[تصنيف:CSS|{{SUBPAGENAME}}]]
[[تصنيف:CSS Property|{{SUBPAGENAME}}]]
[[تصنيف:CSS Text Decoration|{{SUBPAGENAME}}]]