add list view example tests and images

Author: OwenMcDonnell

sdk/python/packages/flet/docs/controls/listview.md

@@ -1,10 +1,11 @@
 ---
 class_name: flet.ListView
 examples: ../../examples/controls/list_view
-example_images: ../examples/controls/list_view/media
+example_media: ../examples/controls/list_view/media
+example_images: ../test-images/examples/core/golden/macos/list_view
 ---
 
-{{ class_summary(class_name) }}
+{{ class_summary(class_name, example_images + "/image_for_docs.png", image_caption="Basic list view") }}
 
 ## Examples
 
@@ -16,7 +17,7 @@ example_images: ../examples/controls/list_view/media
 --8<-- "{{ examples }}/autoscroll_and_dynamic_items.py"
 ```
 
-{{ image(example_images + "/autoscroll_and_dynamic_items.gif", alt="autoscroll-and-dynamic-items", width="80%") }}
+{{ image(example_media + "/autoscroll_and_dynamic_items.gif", alt="autoscroll-and-dynamic-items", width="80%") }}
 
 
 {{ class_members(class_name) }}

sdk/python/packages/flet/integration_tests/examples/core/golden/macos/list_view/image_for_docs.png

@@ -0,0 +1,18 @@
+import pytest
+
+import flet as ft
+import flet.testing as ftt
+
+
+@pytest.mark.asyncio(loop_scope="function")
+async def test_image_for_docs(flet_app_function: ftt.FletTestApp, request):
+    flet_app_function.page.theme_mode = ft.ThemeMode.LIGHT
+    flet_app_function.resize_page(100, 300)
+    flet_app_function.page.update()
+    await flet_app_function.assert_control_screenshot(
+        request.node.name,
+        ft.ListView(
+            controls=[ft.Text(f"Item {i}") for i in range(1, 6)],
+            divider_thickness=1,
+        ),
+    )

sdk/python/packages/flet/integration_tests/examples/core/test_list_view.py

@@ -20,6 +20,13 @@ class ListView(LayoutControl, ScrollableControl, AdaptiveControl):
     ListView is the most commonly used scrolling control. It displays its children one
     after another in the scroll direction. In the cross axis, the children are required
     to fill the ListView.
+
+    ```python
+    ft.ListView(
+        controls=[ft.Text(f"Item {i}") for i in range(1, 6)],
+    )
+    ```
+
     """
 
     controls: list[Control] = field(default_factory=list)