الخط

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

تم طرحها في الإصدار 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/font/ باستخدام إحدى ملفّات الخط المقبولة التالية: 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 الصيغة "normal".
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 على العناصر الداخلية التالية: