Highlight Info

HighlightInfo is designed for high-priority, ongoing tasks that need to stand out. It is ideal for Timers, Stopwatches, Recordings, or status updates that require emphasis.

There are two distinct versions:

  1. Standard (V1): Best for timers and simple status (Icon + Title + Timer/Text).
  2. Version 3 (V3): Best for labeled data (e.g., “Price”, “Status”) with an integrated action button.

1. Highlight Info (Standard)

This is the default layout used for ongoing activities.

Usage

1
2
3
4
5
6
7
8
9
val timer = TimerInfo(type = 1, baseTime = System.currentTimeMillis())

builder.setHighlightInfo(
    title = "Recording",
    content = "Voice Note 1",
    subContent = "00:00",
    picKey = "ic_mic",
    timer = timer
)

Content Parameters

ParameterTypeDescription
titleStringRequired. The main emphasized text (e.g., “Timer”, “Recording”).
contentString?Auxiliary text 1 (often used for description).
subContentString?Auxiliary text 2 (often used for static time or status).
picFunctionString?Key of the HyperPicture to display as the icon.
typeInt?Configuration flag. Set to 1 to hide content (Aux Text 1).
timerTimerInfo?Configuration for a live ticking timer.

Color Customization

Full support for Light and Dark mode colors.

FieldLight ModeDark Mode
TitlecolorTitlecolorTitleDark
ContentcolorContentcolorContentDark
Sub ContentcolorSubContentcolorSubContentDark

Highlight Info V3

This version (Template 20) is layout-focused, featuring a “Primary” text (often large), a “Secondary” text, and a distinct Highlight Label (pill-shaped tag). It also supports an integrated round action button.

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
builder.setHighlightInfoV3(
    primaryText = "$24.00",
    secondaryText = "Total",
    label = "Paid",
    
    // Strikethrough style for secondary text?
    // showSecondaryLine = true, 
    
    // Custom Colors
    primaryColor = "#000000",
    
    // Integrated Action
    action = myAction
)

Content Parameters

ParameterTypeDescription
primaryTextStringRequired. The main text (e.g., Price, Score).
secondaryTextString?Supplement text.
highLightTextString?Text for the highlighted label (pill).
showSecondaryLineBoolean?If true, adds a strikethrough line to the secondaryText.
actionInfoHyperActionRef?An action button reference to display within the layout.

Color Customization

V3 allows specific coloring for the highlight label background and text.

FieldLight ModeDark Mode
Primary TextprimaryColorprimaryColorDark
Secondary TextsecondaryColorsecondaryColorDark
Label TexthighLightTextColorhighLightTextColorDark
Label BackgroundhighLightBgColorhighLightBgColorDark