Function get_children

dash/_layout_utils.py:66–96

Resolve a ``_children_props`` path expression to child Components. Mirrors the dash-renderer's path parsing in ``DashWrapper.tsx``. Supports: - ``"children"`` — simple prop - ``"control_groups[].children"`` — array, then sub-prop per element - ``"insights.title"`` — nested objec

(component: Any, prop_path: str)

def get_children(component: Any, prop_path: str) -> list[Component]:
    """Resolve a ``_children_props`` path expression to child Components.

    Mirrors the dash-renderer's path parsing in ``DashWrapper.tsx``.
    Supports:
    - ``"children"`` — simple prop
    - ``"control_groups[].children"`` — array, then sub-prop per element
    - ``"insights.title"`` — nested object prop
    """
    clean_path = prop_path.replace("[]", "").replace("{}", "")

    if "." not in prop_path:
        return _collect_components(getattr(component, clean_path, None))

    parts = prop_path.split(".")
    array_idx = next((i for i, p in enumerate(parts) if "[]" in p), len(parts))
    front = [p.replace("[]", "").replace("{}", "") for p in parts[: array_idx + 1]]
    back = [p.replace("{}", "") for p in parts[array_idx + 1 :]]

    node = _resolve_path(component, front)
    if node is None:
        return []

    if back and isinstance(node, (list, tuple)):
        results: list[Component] = []
        for element in node:
            child = _resolve_path(element, back)
            results.extend(_collect_components(child))
        return results

    return _collect_components(node)


def _resolve_path(node: Any, keys: list[str]) -> Any: