Skip to content

SVG

Render SVG markup with optional sanitization.

Quick Start

Live Preview
from faststrap import Svg

Svg(
    "<svg viewBox='0 0 120 32' width='120' height='32'>...</svg>",
)

Sanitization

Sanitization is enabled by default and uses bleach. Install the optional extras:

pip install "faststrap[markdown]"

To allow raw SVG as-is, disable sanitization:

Svg(svg_text, sanitize=False)

You can also pre-sanitize SVG strings with render_svg if you want to reuse output.

Theming

Use currentColor inside your SVG to inherit text color and automatically adapt to light and dark themes.

Security Notes

Only disable sanitization for trusted SVG markup. Treat user-provided SVG as untrusted input.

API Reference

faststrap.components.display.svg.Svg(svg, *, sanitize=True, allowed_tags=None, allowed_attributes=None, allowed_protocols=None, **kwargs)

Render raw SVG into a styled container.

Source code in src/faststrap/components/display/svg.py 
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
@register(category="display")
@beta
def Svg(
    svg: str,
    *,
    sanitize: bool = True,
    allowed_tags: list[str] | None = None,
    allowed_attributes: dict[str, list[str]] | None = None,
    allowed_protocols: list[str] | None = None,
    **kwargs: Any,
) -> Div:
    """Render raw SVG into a styled container."""
    content = render_svg(
        svg,
        sanitize=sanitize,
        allowed_tags=allowed_tags,
        allowed_attributes=allowed_attributes,
        allowed_protocols=allowed_protocols,
    )

    user_cls = kwargs.pop("cls", "")
    attrs: dict[str, Any] = {
        "cls": merge_classes("faststrap-svg", user_cls),
    }
    attrs.update(convert_attrs(kwargs))
    return Div(NotStr(content), **attrs)