Add iframe rendering functionality and update checkbox height

Author: ndonkoHenri

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

@@ -16,7 +16,7 @@ example_images: ../test-images/examples/material/golden/macos/checkbox
 
 {{ image(example_images + "/basic.png", alt="basic", width="50%", caption="After clicking Submit") }}
 
-{{ iframe(route="checkbox/basic", height="520") }}
+{{ iframe(route="checkbox/basic", height="400") }}
 
 ### Handling events
 

sdk/python/packages/flet/docs/extras/macros/__init__.py

@@ -3,6 +3,7 @@
 
 from .cli_to_md import render_flet_cli_as_markdown
 from .controls_overview import render_controls_overview
+from .iframe import render_iframe
 
 
 def define_env(env):
@@ -139,30 +140,16 @@ def iframe(
         allow=None,
         loading="lazy",
     ):
-        """
-        Renders an iframe block.
-
-        Args:
-            src: Full iframe source URL. If omitted, `route` and `base` are combined.
-            route: Path on the PoC site (e.g., `"checkbox/basic"`).
-            base: Base URL for the PoC site.
-            width, height, title, allow, loading: Standard iframe attributes.
-        """
-        if route:
-            src = base.rstrip("/") + "/" + route.lstrip("/")
-        if not src:
-            raise ValueError("Either src or route must be provided")
-        attrs = [
-            f'src="{src}"',
-            f'width="{width}"',
-            f'height="{height}"',
-            'style="border:0;"',
-            f'title="{title or "iframe"}"',
-            f'loading="{loading}"',
-        ]
-        if allow:
-            attrs.append(f'allow="{allow}"')
-        return f"<iframe {' '.join(attrs)}></iframe>"
+        return render_iframe(
+            src=src,
+            route=route,
+            base=base,
+            width=width,
+            height=height,
+            title=title,
+            allow=allow,
+            loading=loading,
+        )
 
     @env.macro
     def controls_overview():

sdk/python/packages/flet/docs/extras/macros/iframe.py

@@ -0,0 +1,59 @@
+from typing import Optional
+from urllib.parse import urlparse
+
+
+def _prettify_token(token: str) -> str:
+    return " ".join(
+        word.title() for word in token.replace("-", " ").replace("_", " ").split()
+    )
+
+
+def _pretty_from_route(route: str) -> str:
+    parts = [p for p in route.split("/") if p]
+    if not parts:
+        return "iframe"
+    if len(parts) == 1:
+        return _prettify_token(parts[0])
+    # Use the last two segments for nested routes, e.g. charts/line_chart/example_1 -> Line Chart / Example 1
+    tail = parts[-2:]
+    return " / ".join(_prettify_token(p) for p in tail)
+
+
+def render_iframe(
+    src=None,
+    *,
+    route=None,
+    base: str = "http://127.0.0.1:60222/",
+    width: str = "100%",
+    height: str = "480",
+    title: Optional[str] = None,
+    allow: Optional[str] = None,
+    loading: str = "lazy",
+) -> str:
+    """
+    Build an iframe HTML snippet.
+    """
+    if route:
+        src = base.rstrip("/") + "/" + route.lstrip("/")
+    if not src:
+        raise ValueError("Either src or route must be provided")
+
+    if title is None:
+        parsed = urlparse(src)
+        candidate = parsed.path or src
+        if "." not in candidate:
+            title = _pretty_from_route(route or candidate)
+        else:
+            title = "iframe"
+
+    attrs = [
+        f'src="{src}"',
+        f'width="{width}"',
+        f'height="{height}"',
+        'style="border:0;"',
+        f'title="{title}"',
+        f'loading="{loading}"',
+    ]
+    if allow:
+        attrs.append(f'allow="{allow}"')
+    return f"<iframe {' '.join(attrs)}></iframe>"