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

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

אפשר להוסיף וריאציות של מחרוזות טקסט ל-CarText באמצעות השיטה 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();

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