styling

Functions for style overrides of diagram elements.

BLUE_ACTOR_FNCS: dict[str, Styler] = {'node': parent_is_actor_fills_blue} module-attribute

CSSStyle for coloring Actor Functions (Functions of Components with the attribute is_actor set to True) with a blue gradient like in Capella.

CSSStyles = t.Union[diagram.StyleOverrides, None] module-attribute

A dictionary with CSS styles. The keys are the attribute names and the values can be of the types str, aird.RGB and even t.Sequence[aird.RGB] for coloring a common.GenericElement with a gradient.

See also

parent_is_actor_fills_blue

SYSTEM_CAP_STYLING: dict[str, Styler] = {'node': style_center_symbol} module-attribute

CSSStyle for custom styling of SystemAnalysis diagrams. The center box is drawn with a white background and a grey dashed line.

Styler = t.Callable[[common.GenericElement, 'serializers.DiagramSerializer'], t.Union[diagram.StyleOverrides, None]] module-attribute

Function that produces CSSStyles for given obj.

parent_is_actor_fills_blue(obj, serializer)

Return CSSStyles for given obj rendering it blue.

Source code in capellambse_context_diagrams/styling.py

def parent_is_actor_fills_blue(
    obj: common.GenericElement, serializer: serializers.DiagramSerializer
) -> CSSStyles:
    """Return ``CSSStyles`` for given ``obj`` rendering it blue."""
    del serializer
    try:
        if obj.owner.is_actor:
            return {
                "fill": [
                    capstyle.COLORS["_CAP_Actor_Blue_min"],
                    capstyle.COLORS["_CAP_Actor_Blue"],
                ],
                "stroke": capstyle.COLORS["_CAP_Actor_Border_Blue"],
            }
    except AttributeError:
        pass

    return None

style_center_symbol(obj, serializer)

Return CSSStyles for given obj.

Source code in capellambse_context_diagrams/styling.py

def style_center_symbol(
    obj: common.GenericElement, serializer: serializers.DiagramSerializer
) -> CSSStyles:
    """Return ``CSSStyles`` for given ``obj``."""
    if obj != serializer._diagram.target:  # type: ignore[has-type]
        return None
    return {
        "fill": capstyle.COLORS["white"],
        "stroke": capstyle.COLORS["gray"],
        "stroke-dasharray": 3,
    }