Function parse_wildcard_id

dash/_layout_utils.py:147–170

Parse a component ID and return it as a dict if it contains a wildcard. Accepts string (JSON-encoded) or dict IDs. Returns ``None`` if the ID is not a wildcard pattern. Example:: >>> parse_wildcard_id('{"type":"input","index":["ALL"]}') {"type": "input", "index": ["ALL

(pid: Any)

def parse_wildcard_id(pid: Any) -> dict | None:
    """Parse a component ID and return it as a dict if it contains a wildcard.

    Accepts string (JSON-encoded) or dict IDs. Returns ``None``
    if the ID is not a wildcard pattern.

    Example::

        >>> parse_wildcard_id('{"type":"input","index":["ALL"]}')
        {"type": "input", "index": ["ALL"]}
        >>> parse_wildcard_id("my-dropdown")
        None
    """
    if isinstance(pid, str) and pid.startswith("{"):
        try:
            pid = json.loads(pid)
        except (json.JSONDecodeError, ValueError):
            return None
    if not isinstance(pid, dict):
        return None
    for v in pid.values():
        if isinstance(v, list) and len(v) == 1 and v[0] in _WILDCARD_VALUES:
            return pid
    return None


def find_matching_components(pattern: dict) -> list[Component]: