الخط

توفر تعليمات العرض لعنصر نصي معين.

تم طرح هذه الميزة في الإصدار 4 من نظام التشغيل Wear OS.

بناء الجملة

<Font family="string | SYNC_TO_DEVICE" size="float"
      color="argb-color | rgb-color" slant="NORMAL | ITALIC"
      letterSpacing="em-value"
      width="ULTRA_CONDENSED | EXTRA_CONDENSED | CONDENSED | SEMI_CONDENSED |
             NORMAL | SEMI_EXPANDED | EXPANDED | EXTRA_EXPANDED |
             ULTRA_EXPANDED"
      weight="THIN | ULTRA_LIGHT | EXTRA_LIGHT | LIGHT | NORMAL | MEDIUM |
              BOLD | SEMI_BOLD | ULTRA_BOLD | EXTRA_BOLD | BLACK | EXTRA_BLACK">
    <!-- Inner elements consist of text decoration and text formatting
         options. Here, "Lower" is used as an example. -->
    <Lower ... />
</Font>

السمات

يحتوي العنصر Font على السمات التالية. بعض السمات مطلوبة والبعض الآخر اختيارية.

السمات المطلوبة

السمات التالية مطلوبة:

family

اسم الخط المستخدَم لعرض النص. لاستخدام مجموعة الخطوط نفسها المستخدَمة في النظام، اضبط هذه القيمة على SYNC_TO_DEVICE

لاستخدام خط مخصص، ضَع ملف الخط في res/fonts/ باستخدام إحدى امتدادات ملفات الخطوط المقبولة التالية: TTF أو OTF أو TTC أو XML. بعد ذلك، اضبط هذه القيمة على اسم ملف الخط، باستثناء الامتداد في النهاية.

إذا تعذر حل ملف الخط، فسيتم استخدام خط النظام.

size

قيمة نقطة عائمة تحدِّد حجم النص.

السمات الاختيارية

السمات التالية اختيارية:

color
لون النص وفي حال توفّره، عليك تحديد اللون باستخدام تنسيق ARGB (#ff000000 = أسود معتم) أو تنسيق RGB (#000000 = أسود).
letterSpacing
المسافة بين الأحرف، محدّدة بوحدات EM القيمة التلقائية هي 0. مثال على التوسيع البسيط يمكن أن يكون 0.05. تعمل القيم السلبية على تضييق النص.
slant
ما إذا كنت تريد استخدام الخط NORMAL المائل (الخيار التلقائي) أو ITALIC المائل.
width

قائمة بعدة تلميحات لاستخدامها في صيغة مجموعة خطوط القيمة التلقائية هي NORMAL، ويتم تطبيق الصيغة "العادية" للخط.

تحتوي القائمة التالية على قيم التعداد الأخرى ومتغيرات مجموعة الخطوط ذات الصلة التي تستخدمها، إذا كان هذا الخيار متاحًا للخط:

  • يستخدم كل من ULTRA_CONDENSED وEXTRA_CONDENSED صيغة "الإضاءة المكثفة".
  • تستخدِم CONDENSED الصيغة "مكثفة".
  • يستخدم SEMI_CONDENSED الصيغة "متوسطة مكثّفة".
  • تستخدم كل من SEMI_EXPANDED وEXPANDED وEXTRA_EXPANDED وULTRA_EXPANDED صيغة "عادية".
weight

تعداد لعدة خطوط محتملة. القيمة التلقائية هي NORMAL، وتطبّق قيمة ترجيح 400.

تحتوي القائمة التالية على قيم التعداد الأخرى وأوزان الخط الخاصة بها:

  • يستخدم الحقل "THIN" سماكة خط 100.
  • يستخدم الحقل "ULTRA_LIGHT" سماكة خط 150.
  • يستخدم الحقل "EXTRA_LIGHT" سماكة خط 200.
  • يستخدم الحقل "LIGHT" سماكة خط 300.
  • يستخدم الحقل "MEDIUM" سماكة خط 500.
  • يستخدم الحقل "SEMI_BOLD" سماكة خط 600.
  • يستخدم الحقل "ULTRA_BOLD" سماكة خط 750.
  • يستخدم الحقل "EXTRA_BOLD" سماكة خط 800.
  • يستخدم الحقل "BLACK" سماكة خط 900.
  • يستخدم الحقل "EXTRA_BLACK" سماكة خط 1000.

العناصر الداخلية

يمكن أن يحتوي العنصر Font على العناصر الداخلية التالية: