SidebarLayout

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


Die Verbindung zum Server ist unterbrochen. Verbinde neu …

Neu verbinden hat nicht geklappt. Nächster Versuch in Sekunden.

Keine Verbindung zum Server. Bitte erneut versuchen oder die Seite neu laden.

Der Server hat die Sitzung angehalten.

Die Sitzung ließ sich nicht fortsetzen. Bitte erneut versuchen oder die Seite neu laden.