הוספת וריאנטים של מחרוזת טקסט

כמות הטקסט המוצגת עשויה להשתנות בהתאם לגודל מסך הרכב. ב-Car App API ברמה 2 ומעלה, אפשר לציין כמה וריאציות של מחרוזת טקסט כדי להתאים אותה בצורה הטובה ביותר למסך. כדי לראות איפה אפשר להשתמש בווריאציות של טקסט, צריך לחפש תבניות ורכיבים שמקבלים CarText.

אפשר להוסיף וריאציות של מחרוזות טקסט ל-CarText באמצעות ה-method CarText.Builder.addVariant():

Kotlin

val itemTitle = CarText.Builder("This is a very long string")
    .addVariant("Shorter string")
    ...
    .build()

Java

CarText itemTitle = new CarText.Builder("This is a very long string")
 .addVariant("Shorter string")
 ...
 .build();

אחר כך אפשר להשתמש ב-CarText, למשל כטקסט הראשי של GridItem.

Kotlin

GridItem.Builder()
    .addTitle(itemTitle)
    ...
    .build()

Java

new GridItem.Builder()
    .addTitle(itemTitle)
    ...
    build();

מוסיפים את המחרוזות לפי סדר העדיפות, מהמועדפת ביותר להכי פחות מועדפת. לדוגמה, מהארוכה ביותר לקצרה ביותר. המערכת המארחת בוחרת את המחרוזת באורך המתאים, בהתאם לשטח התצוגה שזמין במסך הרכב.