الخط

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

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

بناء الجملة

<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 على العناصر الداخلية التالية: