[F/OS] ListViewImageText Extension for Kodular And App Inventor Based

ListViewImageText is a high-performance Kodular/App Inventor extension that lets you build smooth, scrollable lists without writing a single line of Java. Each list item can display:

  • An image (with a configurable “generic” fallback URL when none is provided)
  • A title and subtitle (customizable font, size, color, bold/italic, and optional HTML)
  • Left or right image alignment in three preset sizes
  • Search filtering by title or subtitle text

Under the hood, it uses an optimized adapter pattern and preloads views for smooth scrolling, while images load asynchronously on a background thread and are stored in an in-memory cache. This means once an image is fetched, it will immediately appear again without another download—perfect for responsive, data-driven apps. All configuration and event handling (Click/LongClick) are done with simple Kodular blocks.


1. Getting Started

  1. Import the AIX: In Kodular Designer, go to Extensions → Import Extension and select com.bosonshiggs.listviewimagetext.aix (32.0 KB) or GitHub.
  2. Add to Screen: Drag ListViewImageText from the Extensions palette onto your screen.
  3. Anchor: Use the AnchorTo block to place it into any layout (e.g., a VerticalArrangement).
  4. AIA File: wait…

:memo: Specifications


:package: Package: com.bosonshiggs.listviewimagetext
:floppy_disk: Size: 32,00 KB
:gear: Version: 1.0
:mobile_phone: Minimum API Level: 7
:date: Updated On: 2025-06-20T03:00:00Z
:laptop: Built & documented using: FAST v3.7.0


2. Basic Blocks

Events:

ListViewImageText has total 2 events.

1. Click

Fired when an item is clicked
A block of visual programming code triggers an action when the ListViewImageText1 component is clicked, retrieving the position, title, subtitle, and image data from the clicked item. (Captioned by AI)

Parameter Type
position number
title text
subtitle text
image text

2. LongClick

Fired when an item is long-clicked
LongClick_Event

Parameter Type
position number
title text
subtitle text
image text

Methods:

ListViewImageText has total 7 methods.

1. AnchorTo

Anchors this component into the given container
AnchorTo_Call_Method

Parameter Type
container any

2. AddItem

Adds an item with optional image URL, uses generic image if empty.

Parameter Type
image text
title text
subtitle text

3. AddItemFromList

Adds multiple items from a YailList of [title, subtitle, url], uses generic image if empty.
AddItemFromList_Call_Method

Parameter Type
list list

4. ClearList

Clears all items and cache
ClearList_Call_Method

5. RemoveItem

Removes item at the specified position
RemoveItem_Call_Method

Parameter Type
position number

6. UpdateItem

Updates existing item, uses generic image if URL empty.

Parameter Type
position number
image text
title text
subtitle text

7. Search

Filters list by query (case-insensitive)
Search_Call_Method

Parameter Type
query text

Designer:

ListViewImageText has total 14 designer properties.

1. GenericImageUrl

GenericImageUrl_Get_Property

  • Input type: string

2. TitleHTML

TitleHTML_Designer

  • Input type: boolean
  • Default value: false

3. SubtitleHTML

SubtitleHTML_Designer

  • Input type: boolean
  • Default value: false

4. BackgroundColor

BackgroundColor_Designer

  • Input type: color
  • Default value: &H00FFFFFF

5. TitleFontBold

TitleFontBold_Designer

  • Input type: boolean
  • Default value: False

6. SubtitleFontBold

SubtitleFontBold_Designer

  • Input type: boolean
  • Default value: False

7. TitleFontItalic

TitleFontItalic_Designer

  • Input type: boolean
  • Default value: False

8. SubtitleFontItalic

SubtitleFontItalic_Designer

  • Input type: boolean
  • Default value: False

9. TitleFontSize

TitleFontSize_Designer

  • Input type: float
  • Default value: 16.0

10. SubtitleFontSize

SubtitleFontSize_Designer

  • Input type: float
  • Default value: 14.0

11. SubtitleFontTypeface

SubtitleFontTypeface_Designer

  • Input type: typeface
  • Default value: 0

12. TitleFontTypeface

TitleFontTypeface_Designer

  • Input type: typeface
  • Default value: 0

13. TitleTextColor

TitleTextColor_Designer

  • Input type: color
  • Default value: &HFF000000

14. SubTitleTextColor

SubTitleTextColor_Designer

  • Input type: color
  • Default value: &HFF000000

Setters:

ListViewImageText has total 15 setter properties.

1. GenericImageUrl

Sets the default generic image URL for empty image entries.
GenericImageUrl_Designer

  • Input type: text

2. DividerColor

Divider color of the list
DividerColor_Set_Property

  • Input type: number

3. DividerHeight

Divider height in pixels
DividerHeight_Set_Property

  • Input type: number

4. ImageSide

Sets image side: 1=Left,2=Right
ImageSide_Set_Property

  • Input type: number

5. ItemSize

Item size: 1=Normal,2=Small,3=Large
ItemSize_Set_Property

  • Input type: number

6. TitleColor

Title text color
TitleColor_Set_Property

  • Input type: number

7. SubtitleColor

Subtitle text color
SubtitleColor_Set_Property

  • Input type: number

8. TitleFontBold

Define se o título (Title) ficará em negrito.
TitleFontBold_Designer

  • Input type: boolean

9. SubtitleFontBold

Define se o subtítulo (SubTitle) ficará em negrito.
SubtitleFontBold_Designer

  • Input type: boolean

10. TitleFontItalic

Define se o título (Title) ficará em itálico.
TitleFontItalic_Designer

  • Input type: boolean

11. SubtitleFontItalic

Define se o subtítulo (SubTitle) ficará em itálico.
SubtitleFontItalic_Designer

  • Input type: boolean

12. TitleFontSize

Define o tamanho da fonte do título (Title) em sp.
TitleFontSize_Designer

  • Input type: number

13. SubtitleFontSize

Define o tamanho da fonte do subtítulo (SubTitle) em sp.
SubtitleFontSize_Designer

  • Input type: number

14. SubtitleFontTypeface

Define a fonte (typeface) do subtítulo (SubTitle).
SubtitleFontTypeface_Designer

  • Input type: text

15. TitleFontTypeface

Define a fonte (typeface) do título (Title).
TitleFontTypeface_Designer

  • Input type: text

Getters:

ListViewImageText has total 9 getter properties.

All blocks

Examples



6 Likes

Awesome work :clap: :clap::clap:
You might want to upload missing PNGs for designers & properties.

2 Likes

Welldone for this extension!!

Is there any difference between existing listviewimage component and this extension?

1 Like

The main difference is that the native component does not have native filtering functionality. The other differences are more technical.

I don’t see anything new from already existing one

1 Like

I was referring to the native Kodular component. Another difference is that it is open source, so any Dev can add their own modifications. My focus is always on solving my problems and sharing them so that others can adapt as well.

5 Likes

Thanks a lot for your contributions

1 Like