Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

feat(examples): ui-list — a virtualized list & grid demo (createListView)

yhh77f8aacafeef
diff --git a/examples/README.md b/examples/README.md
index a567e8e45..9d1f32c50 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -31,6 +31,7 @@ for your own game.
| **ui-controls** | UI | Buttons, sliders, toggles and progress bars. |
| **ui-interaction** | UI | Dragging, focus and pointer interaction. |
| **ui-layout** | UI | Flexbox-style responsive UI layout. |
+| **ui-list** | UI | A virtualized list and grid — `createListView`, live data, `scrollToIndex`. |
| **platformer** | Game | A tiny platformer — run, jump and collect coins. |
| **space-shooter** | Game | A vertical shmup with prefabs, a HUD and a difficulty ramp. |
diff --git a/examples/ui-list/.gitignore b/examples/ui-list/.gitignore
new file mode 100644
index 000000000..359472ac2
--- /dev/null
+++ b/examples/ui-list/.gitignore
@@ -0,0 +1,7 @@
+node_modules/
+dist/
+.vscode/
+.idea/
+.DS_Store
+Thumbs.db
+.esengine/cache/
diff --git a/examples/ui-list/README.md b/examples/ui-list/README.md
new file mode 100644
index 000000000..bd01aadf8
--- /dev/null
+++ b/examples/ui-list/README.md
@@ -0,0 +1,41 @@
+# UI List
+
+A data-driven, **virtualized** list and grid built with `createListView` — the
+one-call widget over the collection primitives (`DataSource` + `LayoutProvider`
++ view pool + scroll container + `UIMask` clipping).
+
+Two collections run side by side:
+
+- **Contacts** (left) — a 500-row vertical list. Only a screenful of row
+ entities ever exists; they're recycled and re-bound as you scroll. Each row
+ is a zebra-striped container with a hue stripe and a label, all rebound in
+ the item template's idempotent `bind`.
+- **Tiles** (right) — the same widget in grid mode (`columns: 4`), 120 tiles
+ colored by index.
+
+The stats line at the bottom is the proof of virtualization: the *mounted*
+entity counts stay flat (~10 for the list) no matter how many rows the data
+source holds.
+
+## Controls
+
+| Input | Action |
+| --------------- | ------------------------------------------------------- |
+| Mouse wheel | Scroll whichever list is under the cursor |
+| **+ Append row** | `data.append(…)` — the list grows live, then jumps to it |
+| **− Remove first** | `data.remove(0)` — rows above re-bind in place |
+| **Top / End** | `scrollToIndex()` — programmatic jumps |
+
+## What it shows
+
+- `createListView` with both layout sugars: `{ itemHeight }` (column list) and
+ `{ columns, itemSize }` (grid).
+- A raw `ArrayDataSource` as the backing store — mutate it (`append` /
+ `remove` / `update`) and the widget re-syncs; there is no manual refresh.
+- `ListItemTemplate` — `create` builds a pooled row once, `bind` re-applies
+ data on every recycle, so it must be idempotent.
+- `scrollToIndex` and the `mountedCount()` escape hatch.
+
+The scene authors the static frame (panel, headers, empty slots); the startup
+system finds the named slots and instantiates the widgets — the same
+scene-plus-factories split as the `ui-controls` example.
diff --git a/examples/ui-list/assets/scenes/main.esscene b/examples/ui-list/assets/scenes/main.esscene
new file mode 100644
index 000000000..10f0a99d1
--- /dev/null
+++ b/examples/ui-list/assets/scenes/main.esscene
@@ -0,0 +1,315 @@
+{
+ "version": "1.0",
+ "name": "Main",
+ "entities": [
+ {
+ "id": 0,
+ "name": "Camera",
+ "parent": null,
+ "children": [],
+ "components": [
+ {
+ "type": "Transform",
+ "data": {
+ "position": { "x": 0, "y": 0, "z": 10 }
+ }
+ },
+ {
+ "type": "Camera",
+ "data": {
+ "projectionType": 1,
+ "orthoSize": 300,
+ "isActive": true,
+ "priority": 0
+ }
+ }
+ ],
+ "visible": true
+ },
+ {
+ "id": 1,
+ "name": "Canvas",
+ "parent": null,
+ "children": [2],
+ "components": [
+ { "type": "Transform", "data": {} },
+ {
+ "type": "Canvas",
+ "data": {
+ "designResolution": { "x": 800, "y": 600 },
+ "scaleMode": 2
+ }
+ },
+ { "type": "UINode", "data": {} }
+ ],
+ "visible": true
+ },
+ {
+ "id": 2,
+ "name": "Panel",
+ "parent": 1,
+ "children": [3, 4, 11, 12],
+ "components": [
+ { "type": "Transform", "data": {} },
+ {
+ "type": "UINode",
+ "data": {
+ "position": 1,
+ "insetLeft": { "value": 20, "unit": 0 },
+ "insetTop": { "value": 20, "unit": 0 },
+ "insetRight": { "value": 20, "unit": 0 },
+ "insetBottom": { "value": 20, "unit": 0 }
+ }
+ },
+ {
+ "type": "FlexContainer",
+ "data": {
+ "direction": 1,
+ "justifyContent": 0,
+ "alignItems": 0,
+ "gap": { "x": 0, "y": 10 },
+ "padding": { "left": 20, "top": 20, "right": 20, "bottom": 20 }
+ }
+ },
+ {
+ "type": "UIVisual",
+ "data": {
+ "visualType": 1,
+ "color": { "r": 0.16, "g": 0.16, "b": 0.18, "a": 1 },
+ "enabled": true
+ }
+ }
+ ],
+ "visible": true
+ },
+ {
+ "id": 3,
+ "name": "Title",
+ "parent": 2,
+ "children": [],
+ "components": [
+ { "type": "Transform", "data": {} },
+ {
+ "type": "UINode",
+ "data": { "height": { "value": 28, "unit": 0 } }
+ },
+ {
+ "type": "Text",
+ "data": {
+ "content": "UI List — virtualized list & grid",
+ "fontSize": 20,
+ "bold": true,
+ "color": { "r": 1, "g": 1, "b": 1, "a": 1 },
+ "align": 0,
+ "verticalAlign": 1
+ }
+ }
+ ],
+ "visible": true
+ },
+ {
+ "id": 4,
+ "name": "ContentRow",
+ "parent": 2,
+ "children": [5, 8],
+ "components": [
+ { "type": "Transform", "data": {} },
+ {
+ "type": "UINode",
+ "data": { "height": { "value": 404, "unit": 0 } }
+ },
+ {
+ "type": "FlexContainer",
+ "data": {
+ "direction": 0,
+ "justifyContent": 0,
+ "alignItems": 0,
+ "gap": { "x": 24, "y": 0 }
+ }
+ }
+ ],
+ "visible": true
+ },
+ {
+ "id": 5,
+ "name": "ListPane",
+ "parent": 4,
+ "children": [6, 7],
+ "components": [
+ { "type": "Transform", "data": {} },
+ {
+ "type": "UINode",
+ "data": {
+ "width": { "value": 340, "unit": 0 },
+ "height": { "value": 404, "unit": 0 }
+ }
+ },
+ {
+ "type": "FlexContainer",
+ "data": {
+ "direction": 1,
+ "justifyContent": 0,
+ "alignItems": 0,
+ "gap": { "x": 0, "y": 6 }
+ }
+ }
+ ],
+ "visible": true
+ },
+ {
+ "id": 6,
+ "name": "ListHeader",
+ "parent": 5,
+ "children": [],
+ "components": [
+ { "type": "Transform", "data": {} },
+ {
+ "type": "UINode",
+ "data": { "height": { "value": 20, "unit": 0 } }
+ },
+ {
+ "type": "Text",
+ "data": {
+ "content": "Contacts — vertical list",
+ "fontSize": 13,
+ "color": { "r": 0.72, "g": 0.72, "b": 0.78, "a": 1 },
+ "align": 0,
+ "verticalAlign": 1
+ }
+ }
+ ],
+ "visible": true
+ },
+ {
+ "id": 7,
+ "name": "ListSlot",
+ "parent": 5,
+ "children": [],
+ "components": [
+ { "type": "Transform", "data": {} },
+ {
+ "type": "UINode",
+ "data": {
+ "width": { "value": 340, "unit": 0 },
+ "height": { "value": 378, "unit": 0 }
+ }
+ }
+ ],
+ "visible": true
+ },
+ {
+ "id": 8,
+ "name": "GridPane",
+ "parent": 4,
+ "children": [9, 10],
+ "components": [
+ { "type": "Transform", "data": {} },
+ {
+ "type": "UINode",
+ "data": {
+ "width": { "value": 336, "unit": 0 },
+ "height": { "value": 404, "unit": 0 }
+ }
+ },
+ {
+ "type": "FlexContainer",
+ "data": {
+ "direction": 1,
+ "justifyContent": 0,
+ "alignItems": 0,
+ "gap": { "x": 0, "y": 6 }
+ }
+ }
+ ],
+ "visible": true
+ },
+ {
+ "id": 9,
+ "name": "GridHeader",
+ "parent": 8,
+ "children": [],
+ "components": [
+ { "type": "Transform", "data": {} },
+ {
+ "type": "UINode",
+ "data": { "height": { "value": 20, "unit": 0 } }
+ },
+ {
+ "type": "Text",
+ "data": {
+ "content": "Tiles — 4-column grid",
+ "fontSize": 13,
+ "color": { "r": 0.72, "g": 0.72, "b": 0.78, "a": 1 },
+ "align": 0,
+ "verticalAlign": 1
+ }
+ }
+ ],
+ "visible": true
+ },
+ {
+ "id": 10,
+ "name": "GridSlot",
+ "parent": 8,
+ "children": [],
+ "components": [
+ { "type": "Transform", "data": {} },
+ {
+ "type": "UINode",
+ "data": {
+ "width": { "value": 336, "unit": 0 },
+ "height": { "value": 378, "unit": 0 }
+ }
+ }
+ ],
+ "visible": true
+ },
+ {
+ "id": 11,
+ "name": "StatsLabel",
+ "parent": 2,
+ "children": [],
+ "components": [
+ { "type": "Transform", "data": {} },
+ {
+ "type": "UINode",
+ "data": { "height": { "value": 18, "unit": 0 } }
+ },
+ {
+ "type": "Text",
+ "data": {
+ "content": "…",
+ "fontSize": 12,
+ "color": { "r": 0.55, "g": 0.58, "b": 0.65, "a": 1 },
+ "align": 0,
+ "verticalAlign": 1
+ }
+ }
+ ],
+ "visible": true
+ },
+ {
+ "id": 12,
+ "name": "ButtonsRow",
+ "parent": 2,
+ "children": [],
+ "components": [
+ { "type": "Transform", "data": {} },
+ {
+ "type": "UINode",
+ "data": { "height": { "value": 40, "unit": 0 } }
+ },
+ {
+ "type": "FlexContainer",
+ "data": {
+ "direction": 0,
+ "justifyContent": 0,
+ "alignItems": 1,
+ "gap": { "x": 10, "y": 0 }
+ }
+ }
+ ],
+ "visible": true
+ }
+ ]
+}
diff --git a/examples/ui-list/assets/scenes/main.esscene.meta b/examples/ui-list/assets/scenes/main.esscene.meta
new file mode 100644
index 000000000..cffaa4e55
--- /dev/null
+++ b/examples/ui-list/assets/scenes/main.esscene.meta
@@ -0,0 +1,8 @@
+{
+ "uuid": "c57ff143-dc93-4fa4-90d6-2c1fd9a99c13",
+ "version": "2.0",
+ "type": "scene",
+ "importer": {
+ "autoMigrate": true
+ }
+}
diff --git a/examples/ui-list/project.esproject b/examples/ui-list/project.esproject
new file mode 100644
index 000000000..e2e5f6f99
--- /dev/null
+++ b/examples/ui-list/project.esproject
@@ -0,0 +1,13 @@
+{
+ "formatVersion": "1",
+ "name": "UI List",
+ "description": "A virtualized list and grid — createListView with live data.",
+ "tag": "UI",
+ "version": "0.1.0",
+ "defaultScene": "assets/scenes/main.esscene",
+ "designResolution": {
+ "width": 800,
+ "height": 600
+ },
+ "spineVersion": "none"
+}
diff --git a/examples/ui-list/src/config.ts b/examples/ui-list/src/config.ts
new file mode 100644
index 000000000..0ba36da17
--- /dev/null
+++ b/examples/ui-list/src/config.ts
@@ -0,0 +1,51 @@
+import type { Color } from 'esengine';
+
+// Viewport sizes must be known up front (createListView needs them for the
+// scroll math); the slot boxes in the scene use the same numbers.
+export const LIST_W = 340;
+export const LIST_H = 378;
+export const GRID_W = 336;
+export const GRID_H = 378;
+
+// List rows: 44px rows with a 6px gap → ~7.5 visible of the 500 backing rows.
+export const ROW_H = 44;
+export const ROW_SPACING = 6;
+export const CONTACTS = 500;
+
+// Grid tiles: 4 columns of 78px tiles + 8px spacing = 336px = GRID_W exactly.
+export const GRID_COLUMNS = 4;
+export const TILE = 78;
+export const TILE_SPACING = 8;
+export const TILES = 120;
+
+export const CONTROL_H = 32;
+
+// Deterministic "contact" names — no randomness, so reloads look identical.
+const FIRST = ['Ada', 'Grace', 'Alan', 'Edsger', 'Barbara', 'Donald', 'Margaret', 'Dennis', 'Radia', 'Ken'];
+const LAST = ['Lovelace', 'Hopper', 'Turing', 'Dijkstra', 'Liskov', 'Knuth', 'Hamilton', 'Ritchie', 'Perlman', 'Thompson'];
+
+export interface Contact {
+ id: number;
+ name: string;
+}
+
+export function makeContact(id: number): Contact {
+ // 7 is coprime with the table size and the decade shift breaks the fixed
+ // first↔last pairing, so neighbours differ in both names.
+ return { id, name: `${FIRST[id % FIRST.length]} ${LAST[(id * 7 + Math.floor(id / LAST.length)) % LAST.length]}` };
+}
+
+// Hue wheel for row stripes and grid tiles (s/l fixed, dark-theme friendly).
+export function hueColor(i: number, lightness = 0.55): Color {
+ const h = ((i * 47) % 360) / 60;
+ const c = (1 - Math.abs(2 * lightness - 1)) * 0.62;
+ const x = c * (1 - Math.abs((h % 2) - 1));
+ const m = lightness - c / 2;
+ const [r, g, b] =
+ h < 1 ? [c, x, 0] :
+ h < 2 ? [x, c, 0] :
+ h < 3 ? [0, c, x] :
+ h < 4 ? [0, x, c] :
+ h < 5 ? [x, 0, c] : [c, 0, x];
+ return { r: r + m, g: g + m, b: b + m, a: 1 };
+}
diff --git a/examples/ui-list/src/main.ts b/examples/ui-list/src/main.ts
new file mode 100644
index 000000000..c1a43218c
--- /dev/null
+++ b/examples/ui-list/src/main.ts
@@ -0,0 +1,10 @@
+// UI List — a data-driven, virtualized list and grid built with createListView:
+// 500 rows / 120 tiles backed by a handful of recycled entities, mouse-wheel
+// scrolling, live append/remove, and scrollToIndex jumps.
+import { addStartupSystem, addSystemToSchedule, Schedule } from 'esengine';
+
+import { buildSystem } from './systems/build';
+import { statsSystem } from './systems/stats';
+
+addStartupSystem(buildSystem);
+addSystemToSchedule(Schedule.Update, statsSystem);
diff --git a/examples/ui-list/src/state.ts b/examples/ui-list/src/state.ts
new file mode 100644
index 000000000..005b3699e
--- /dev/null
+++ b/examples/ui-list/src/state.ts
@@ -0,0 +1,14 @@
+import type { Entity, ListViewHandle, ArrayDataSource } from 'esengine';
+
+import type { Contact } from './config';
+
+export const state = {
+ list: null as ListViewHandle<Contact> | null,
+ grid: null as ListViewHandle<number> | null,
+ // Typed handle to the list's backing store (list.data is the readonly
+ // DataSource view; mutations — append/remove — live on ArrayDataSource).
+ contacts: null as ArrayDataSource<Contact> | null,
+ statsLabel: null as Entity | null,
+ nextId: 0,
+ lastStats: '',
+};
diff --git a/examples/ui-list/src/systems/build.ts b/examples/ui-list/src/systems/build.ts
new file mode 100644
index 000000000..15fed3855
--- /dev/null
+++ b/examples/ui-list/src/systems/build.ts
@@ -0,0 +1,157 @@
+import {
+ defineSystem, Res, GetWorld,
+ UIEvents,
+ Text, UIVisual,
+ createListView, createButton,
+ ArrayDataSource,
+ spawnUIEntity,
+ themeColors, px,
+ UIPositionType, TextVerticalAlign,
+} from 'esengine';
+import type {
+ Entity, World, Color, ThemeColors, UIEventQueue, TextData, UIVisualData,
+ ListItemTemplate,
+} from 'esengine';
+
+import {
+ LIST_W, LIST_H, GRID_W, GRID_H,
+ ROW_H, ROW_SPACING, CONTACTS,
+ GRID_COLUMNS, TILE, TILE_SPACING, TILES,
+ CONTROL_H,
+ makeContact, hueColor,
+ type Contact,
+} from '../config';
+import { state } from '../state';
+
+// Recycled item entities → their bind targets. Populated once per pooled
+// entity in create(); bind() only mutates components, so it stays idempotent.
+const rowParts = new Map<Entity, { stripe: Entity; label: Entity }>();
+const tileParts = new Map<Entity, { label: Entity }>();
+
+const ZEBRA_EVEN: Color = { r: 0.20, g: 0.20, b: 0.23, a: 1 };
+const ZEBRA_ODD: Color = { r: 0.23, g: 0.23, b: 0.27, a: 1 };
+
+export const buildSystem = defineSystem(
+ [Res(UIEvents), GetWorld()],
+ (events: UIEventQueue, world: World) => {
+ if (state.list) return;
+
+ const listSlot = world.findEntityByName('ListSlot');
+ const gridSlot = world.findEntityByName('GridSlot');
+ const buttonsRow = world.findEntityByName('ButtonsRow');
+ if (listSlot === null || gridSlot === null || buttonsRow === null) return;
+
+ state.statsLabel = world.findEntityByName('StatsLabel');
+ const c = themeColors();
+
+ // ── Contacts: a 500-row vertical list over ~10 recycled entities ──
+ const contacts = new ArrayDataSource<Contact>(
+ Array.from({ length: CONTACTS }, (_, i) => makeContact(i)),
+ );
+ state.nextId = CONTACTS;
+ state.contacts = contacts;
+
+ const rowTemplate: ListItemTemplate<Contact> = {
+ create: (w, parent) => {
+ const row = spawnUIEntity({ world: w, parent, visual: { color: ZEBRA_EVEN } });
+ const stripe = spawnUIEntity({
+ world: w, parent: row,
+ node: { position: UIPositionType.Absolute, insetLeft: px(0), insetTop: px(0), insetBottom: px(0), width: px(4) },
+ visual: { color: c.primary },
+ });
+ const label = spawnUIEntity({
+ world: w, parent: row,
+ node: { position: UIPositionType.Absolute, insetLeft: px(14), insetRight: px(8), insetTop: px(0), insetBottom: px(0) },
+ text: { content: '', fontSize: 13, color: c.onPrimary, align: 0, verticalAlign: TextVerticalAlign.Middle },
+ });
+ rowParts.set(row, { stripe, label });
+ return row;
+ },
+ bind: (row, contact, index) => {
+ const parts = rowParts.get(row);
+ if (!parts) return;
+ setColor(world, row, index % 2 === 0 ? ZEBRA_EVEN : ZEBRA_ODD);
+ setColor(world, parts.stripe, hueColor(contact.id));
+ setText(world, parts.label, `#${String(contact.id).padStart(3, '0')} ${contact.name}`);
+ },
+ };
+
+ state.list = createListView<Contact>({
+ world, parent: listSlot,
+ viewportSize: { x: LIST_W, y: LIST_H },
+ background: { color: { r: 0.11, g: 0.11, b: 0.13, a: 1 } },
+ data: contacts,
+ layout: { itemHeight: ROW_H, spacing: ROW_SPACING },
+ item: rowTemplate,
+ });
+
+ // ── Tiles: a 120-item, 4-column grid over one screen of entities ──
+ const tileTemplate: ListItemTemplate<number> = {
+ create: (w, parent) => {
+ const tile = spawnUIEntity({ world: w, parent, visual: { color: ZEBRA_EVEN } });
+ const label = spawnUIEntity({
+ world: w, parent: tile,
+ node: { fill: true },
+ text: { content: '', fontSize: 14, bold: true, color: { r: 1, g: 1, b: 1, a: 0.9 } },
+ });
+ tileParts.set(tile, { label });
+ return tile;
+ },
+ bind: (tile, value) => {
+ const parts = tileParts.get(tile);
+ if (!parts) return;
+ setColor(world, tile, hueColor(value, 0.36));
+ setText(world, parts.label, String(value));
+ },
+ };
+
+ state.grid = createListView<number>({
+ world, parent: gridSlot,
+ viewportSize: { x: GRID_W, y: GRID_H },
+ background: { color: { r: 0.11, g: 0.11, b: 0.13, a: 1 } },
+ data: Array.from({ length: TILES }, (_, i) => i),
+ layout: { columns: GRID_COLUMNS, itemSize: { x: TILE, y: TILE }, spacing: { x: TILE_SPACING, y: TILE_SPACING } },
+ item: tileTemplate,
+ });
+
+ // ── Controls: live data mutation + programmatic scrolling ──
+ const button = (label: string, width: number, onClick: () => void) =>
+ createButton({
+ world, events, parent: buttonsRow,
+ node: { width: px(width), height: px(CONTROL_H) },
+ states: controlStates(c),
+ text: { content: label, color: c.onPrimary, fontSize: 13 },
+ onClick,
+ });
+
+ button('+ Append row', 110, () => {
+ contacts.append([makeContact(state.nextId++)]);
+ state.list?.scrollToIndex(contacts.getCount() - 1);
+ });
+ button('− Remove first', 110, () => {
+ if (contacts.getCount() > 0) contacts.remove(0);
+ });
+ button('Top', 70, () => state.list?.scrollToIndex(0));
+ button('End', 70, () => state.list?.scrollToIndex(contacts.getCount() - 1));
+ },
+ { name: 'BuildSystem' },
+);
+
+function controlStates(c: ThemeColors): Record<string, { color: Color }> {
+ return { normal: { color: c.control }, hover: { color: c.controlHover }, pressed: { color: c.controlActive } };
+}
+
+function setText(world: World, entity: Entity, content: string): void {
+ if (!world.valid(entity) || !world.has(entity, Text)) return;
+ const t = world.get(entity, Text) as TextData;
+ if (t.content === content) return;
+ t.content = content;
+ world.insert(entity, Text, t);
+}
+
+function setColor(world: World, entity: Entity, color: Color): void {
+ if (!world.valid(entity) || !world.has(entity, UIVisual)) return;
+ const v = world.get(entity, UIVisual) as UIVisualData;
+ v.color = { ...color };
+ world.insert(entity, UIVisual, v);
+}
diff --git a/examples/ui-list/src/systems/stats.ts b/examples/ui-list/src/systems/stats.ts
new file mode 100644
index 000000000..871e21c6f
--- /dev/null
+++ b/examples/ui-list/src/systems/stats.ts
@@ -0,0 +1,26 @@
+import { defineSystem, GetWorld, Text } from 'esengine';
+import type { World, TextData } from 'esengine';
+
+import { state } from '../state';
+
+// The proof-of-virtualization readout: mounted entity counts stay flat (~a
+// screenful each) no matter how many rows/tiles back the lists.
+export const statsSystem = defineSystem(
+ [GetWorld()],
+ (world: World) => {
+ const { list, grid, statsLabel } = state;
+ if (!list || !grid || statsLabel === null) return;
+
+ const text =
+ `list: ${list.mountedCount()} entities mounted for ${list.data.getCount()} rows · ` +
+ `grid: ${grid.mountedCount()} for ${grid.data.getCount()} tiles · scroll with the mouse wheel`;
+ if (text === state.lastStats) return;
+ state.lastStats = text;
+
+ if (!world.valid(statsLabel) || !world.has(statsLabel, Text)) return;
+ const t = world.get(statsLabel, Text) as TextData;
+ t.content = text;
+ world.insert(statsLabel, Text, t);
+ },
+ { name: 'StatsSystem' },
+);
diff --git a/examples/ui-list/thumbnail.png b/examples/ui-list/thumbnail.png
new file mode 100644
index 000000000..9a9d26e6c
Binary files /dev/null and b/examples/ui-list/thumbnail.png differ
diff --git a/examples/ui-list/thumbnail.png.meta b/examples/ui-list/thumbnail.png.meta
new file mode 100644
index 000000000..e2408c69c
--- /dev/null
+++ b/examples/ui-list/thumbnail.png.meta
@@ -0,0 +1,17 @@
+{
+ "uuid": "fdcd5c87-30e1-4d57-a21f-6754844920bd",
+ "version": "2.0",
+ "type": "texture",
+ "importer": {
+ "maxSize": 2048,
+ "filterMode": "linear",
+ "wrapMode": "repeat",
+ "premultiplyAlpha": false,
+ "sliceBorder": {
+ "left": 0,
+ "right": 0,
+ "top": 0,
+ "bottom": 0
+ }
+ }
+}
diff --git a/examples/ui-list/tsconfig.json b/examples/ui-list/tsconfig.json
new file mode 100644
index 000000000..0a8528b29
--- /dev/null
+++ b/examples/ui-list/tsconfig.json
@@ -0,0 +1,22 @@
+{
+ "compilerOptions": {
+ "target": "ES2020",
+ "module": "ESNext",
+ "moduleResolution": "bundler",
+ "strict": true,
+ "esModuleInterop": true,
+ "skipLibCheck": true,
+ "forceConsistentCasingInFileNames": true,
+ "declaration": false,
+ "outDir": "./dist",
+ "rootDir": ".",
+ "baseUrl": ".",
+ "paths": {
+ "esengine": ["./.esengine/sdk/index.d.ts"],
+ "esengine/wasm": ["./.esengine/sdk/wasm.d.ts"],
+ "@esengine/editor": ["./.esengine/editor/index.d.ts"]
+ }
+ },
+ "include": ["src/**/*"],
+ "exclude": ["node_modules"]
+}