SandboxFrame
iframe für fremdes HTML wie den Inhalt einer E-Mail: abgeschottet über das sandbox-Attribut (ohne Skripte), Quelle als URL
(Src, empfohlen mit eigener Content-Security-Policy vom Server) oder als HTML (Html). Die Höhe folgt dem Inhalt,
Links öffnen in einem neuen Tab. Das HTML vorher auf dem Server bereinigen – die Sandbox ist die zweite Verteidigungslinie.
HTML abgeschottet anzeigen
Fremdes HTML (etwa eine Mail) abgeschottet im iframe: keine Skripte, Höhe nach dem Inhalt, Links öffnen in einem neuen Tab. Bilder fremder Server sperrt die CSP.
SKILL.md – Sandboxframe
---
name: SandboxFrame
description: Onesown Blazor Komponente SandboxFrame (Viewer). Verwende diesen Skill wenn du die SandboxFrame-Komponente verwenden, konfigurieren oder debuggen moechtest.
---
# SandboxFrame
**Namespace:** `Onesown.Blazor.Components`
**Kategorie:** Viewer
**Basisklasse:** `IAsyncDisposable`
iframe für fremdes HTML, etwa den Inhalt einer E-Mail oder eine Vorschau: abgeschottet über das sandbox-Attribut (ohne Skripte), Quelle als URL (Src) oder als HTML (Html, über srcdoc). Die Höhe wächst und schrumpft mit dem Inhalt, Links im Inhalt öffnen in einem neuen Tab.
**Live-Demo:** https://components.schini.com/demo/sandboxframe
## Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Src`` | ``string`` | | Adresse des Inhalts (iframe src), etwa ein Endpunkt, der bereinigtes HTML mit eigener Content-Security-Policy liefert. Hat Html Vorrang, wird Src nicht verwendet. |
| ``Html`` | ``string`` | | HTML des Inhalts, als srcdoc in ein eigenes Dokument gesetzt (samt Csp, Css und <base target="_blank">). Hat Vorrang vor Src. |
| ``Sandbox`` | ``string`` | ``StandardSandbox`` | Wert des sandbox-Attributs (Leerzeichen-getrennte Freigaben). Leer ("") sperrt alles. Nie allow-scripts zusammen mit allow-same-origin. Standard: "allow-same-origin allow-popups allow-popups-to-escape-sandbox". |
| ``AutoHeight`` | ``bool`` | ``true`` | Höhe folgt dem Inhalt (wächst und schrumpft, auch beim Nachladen von Bildern); braucht allow-same-origin in Sandbox. Standard: true. |
| ``LinksInNewTab`` | ``bool`` | ``true`` | Links im Inhalt öffnen in einem neuen Tab (target="_blank", rel="noopener noreferrer"); Sprungmarken (#…) bleiben im Rahmen. Braucht allow-popups in Sandbox. Standard: true. |
| ``Csp`` | ``string`` | | Content-Security-Policy für Html, als meta-Tag in den Kopf gesetzt, etwa "default-src 'none'; img-src data:; style-src 'unsafe-inline'". Gilt nicht für Src (dort setzt der Server die CSP). Standard: null (keine). |
| ``Css`` | ``string`` | | Zusätzliches CSS für Html (als style-Element im Kopf), etwa Grundschrift und Abstände des Inhalts. Gilt nicht für Src. Standard: null. |
| ``Title`` | ``string`` | ``"Eingebetteter Inhalt"`` | Beschriftung des iframes für Screenreader (title). Standard: "Eingebetteter Inhalt". |
| ``ReferrerPolicy`` | ``string`` | ``"no-referrer"`` | Referrer-Policy für Anfragen aus dem iframe (Bilder, Links). Standard: "no-referrer". |
| ``LazyLoad`` | ``bool`` | | Lädt den Inhalt erst, wenn der Rahmen in die Nähe des sichtbaren Bereichs kommt (loading="lazy"). Standard: false. |
## Hinweise
- HTML direkt: <SandboxFrame Html="@mail.Html" /> – wird als srcdoc in ein eigenes Dokument gesetzt
- Von einer Adresse, die der Server mit eigener CSP ausliefert (empfohlen für Mails): Src="/mails/42/inhalt"
- Standard-Sandbox: "allow-same-origin allow-popups allow-popups-to-escape-sandbox" – keine Skripte, keine Formulare, Links dürfen neue Tabs öffnen;
- allow-same-origin braucht die Komponente, um Höhe und Links von außen anzupassen (ohne allow-scripts bleibt das sicher)
- Strenger: Sandbox="" (alles gesperrt; dann keine automatische Höhe und keine Links in neuen Tabs) – nie allow-scripts zusammen mit allow-same-origin
- Bilder fremder Server bei Html sperren: Csp="default-src 'none'; img-src data: cid:; style-src 'unsafe-inline'" (wird als meta-Tag eingesetzt)
- Grundschrift und Abstände für Html: Css="body { font-family: Segoe UI, sans-serif; margin: 12px 16px; }"
- Feste Höhe statt automatisch: AutoHeight="false" style="height: 30rem" (der Inhalt scrollt im Rahmen)
- Mindesthöhe über die CSS-Variable --oo-sandbox-frame-min-height (Standard 12rem), Hintergrund über --oo-sandbox-frame-background (Standard weiß, weil fremdes HTML meist hell gestaltet ist)
- Html mit eigenem <html>-Gerüst wird unverändert übernommen; Csp, Css und der Link-Standard <base target="_blank"> entfallen dann (Links stellt das Skript trotzdem um)
- Links mit # (Sprungmarken im Inhalt) bleiben im Rahmen; LinksInNewTab="false" lässt alle Links unverändert
- Das HTML vorher auf dem Server bereinigen (etwa OoRichText.Bereinigen) – die Sandbox ist die zweite Verteidigungslinie, nicht die einzige