با متن کار کنید

برای ساعت‌های دیجیتال، در صورت امکان باید از DigitalClock استفاده کنید. برای سایر متن‌ها یا ساعت‌هایی که نمی‌توان با استفاده از DigitalClock نمایش داد، PartText ظرفی برای رندر مبتنی بر متن است.

بسته به اینکه می‌خواهید متن دایره‌ای یا معمولی را نشان دهید، PartText باید حاوی یک عنصر Text یا TextCircular باشد .

کار با فونت‌ها و فونت‌های بیت‌مپ

استفاده از فونت‌های سفارشی به صفحه ساعت شما اجازه می‌دهد تا با سبک خاص خود متمایز شود.

دو روش برای استفاده از فونت‌های سفارشی وجود دارد، هم در کانتینرهای TimeText و هم در کانتینرهای PartText .

  1. یک family فونت سفارشی را در عنصر Font مشخص کنید. طیف وسیعی از فرمت‌های رایج پشتیبانی می‌شوند که باید در res/font قرار گیرند.

    برای مثال، استفاده از فونت Pacifico از فونت‌های گوگل، و قرار دادن فایل به صورت res/font/pacifico.ttf: 

    <PartText x="0" y="50" width="450" height="250">
    <Text align="CENTER">
        <Font family="pacifico" size="96">Hello!</Font>
    </Text>
</PartText>
    watchface_text.xml

  2. روش دیگر، تعریف یک BitmapFont است که تصاویر بیت‌مپ را در res/drawable ارائه می‌دهد: 

    <BitmapFonts>
    <BitmapFont name="myhandwriting">
        <Character name="1" resource="digit1" width="50" height="100" />
        <Character name="2" resource="digit2" width="50" height="100" />
        <Character name="3" resource="digit3" width="50" height="100" />
        <Character name="4" resource="digit4" width="50" height="100" />
        <!-- ... -->
        <!-- Treat "12" specially, instead of a 1 followed by a 2-->
        <Word name="12" resource="digit12" width="80" height="100" />
    </BitmapFont>
</BitmapFonts>
    watchface_text.xml

توجه کنید که چگونه می‌توان به توالی کاراکترها یک رفتار خاص داد. برای مثال، اگر قرار باشد "12" با اعداد 1 و 2 متصل نمایش داده شود، این کار می‌تواند با استفاده از یک عنصر Word انجام شود.

برای استفاده از فونت تعریف شده: 

<DigitalClock x="125" y="120" width="200" height="50">
    <TimeText x="0" y="0" width="200" height="50" format="hh:mm">
        <BitmapFont family="myhandwriting" size="48" color="#FF00FF"/>
    </TimeText>
</DigitalClock>
watchface_text.xml

جلوه‌های متنی

قالب واچ فیس چندین جلوه متنی مانند OutGlow و Shadow را ارائه می‌دهد که می‌توان از آنها استفاده کرد. برای استفاده از این جلوه‌ها، آنها را به عنوان زیرعنصرهای عنصر Font اعمال کنید: 

<Font family="pacifico" size="96" color="#e2a0ff">
    <OutGlow color="#e8ffb7" radius="30">Hello!</OutGlow>
</Font>
watchface_text.xml

با قالب‌ها کار کنید

به جای متن ثابت، ممکن است لازم باشد متن خود را از منابع داده یا عبارات بسازید.

عنصر Template به شما امکان می‌دهد این کار را انجام دهید: 

<Font family="pacifico" size="60" weight="BOLD" color="#ffffff">
    <Template>Day: %s<Parameter expression="[DAY_OF_WEEK_S]" /></Template>
</Font>
watchface_text.xml

با منابع کار کنید

اگر متن استاتیک شما در یک منبع، مثلاً در res/values/strings.xml تعریف شده باشد، می‌توان به صورت زیر به آن ارجاع داد: 

<!-- greeting defined in res/values/strings.xml -->
<Font family="pacifico" size="60" weight="BOLD" color="#ffffff">greeting</Font>
watchface_text.xml

این همچنین به شما امکان می‌دهد تا صفحه ساعت خود را با استفاده از توصیف‌کننده‌های منابع مختلف، بومی‌سازی کنید.

فاصله دسته‌ها

کار با فاصله‌گذاری متن در XML می‌تواند چالش‌برانگیز باشد. فاصله‌گذاری اضافی در اطراف متن می‌تواند باعث مشکلات قالب‌بندی، مانند مرکزبندی نادرست، یا جلوگیری از یافتن منابع رشته‌ای اندروید توسط برنامه شما شود.

برای جلوگیری از این موقعیت‌ها، محتوای Font خود را در یک عنصر CDATA قرار دهید: 

<Font family="pacifico" size="60" weight="BOLD" color="#ffffff">
    <![CDATA[Hello]]>
</Font>
watchface_text.xml

متن چند خطی

برای ایجاد متن چندخطی، از ویژگی maxLines در Text استفاده کنید: 

<Text align="CENTER" maxLines="2">
    <Font family="pacifico" size="60" weight="BOLD" color="#ffffff">
        <![CDATA[Hello Wear OS world]]>
    </Font>
</Text>
watchface_text.xml