Files

T

Hermes 88d618b58a htmlviewer-directediting: HTML rendering in Nextcloud iOS app

- htmlviewer: IEditor + Bridge + srcdoc iframe template + content controller
- text app: open() bridges text/html to htmlviewer template
- idempotent install.sh for re-deployment after app updates
- iPhone-tested 2026-09-11

2026-09-11 12:19:44 +00:00

2.6 KiB

Raw Blame History

htmlviewer-directediting

Rendert HTML-Dateien in der Nextcloud iOS/Android App statt Quelltext (QuickLook) anzuzeigen.

Warum das existiert

Die Mobile-Apps wählen den Editor für eine Datei über die Server-Capabilities (/ocs/v2.php/apps/files/api/v1/directEditing) und haben eine hartcodierte Editor-Registry (NCDirectEditorAdapter in nextcloud/ios): nur text, eurooffice, onlyoffice, richdocuments, whiteboard sind bekannt. Ein neuer Server-Editor mit eigener ID (z.B. htmlviewer) wird von der App nicht aufgelöst → Fallback auf QuickLook → HTML-Quelltext.

Lösung (2 Patches)

htmlviewer (custom_apps): registriert einen IEditor (HtmlDirectEditor) mit Mimetype text/html + Bridge-Klasse, Template mit sandboxed iframe (srcdoc — Inhalt direkt eingebettet, kein Cookie-Problem in mobilen WebViews) und Content-Controller.
text (Core-App, gepatcht):
- open() leitet text/html an die htmlviewer-Bridge um (HtmlDirectEditorBridge::openHtml) — die iOS-App wählt Editor text (registry-bekannt), der Server liefert aber das HTML-Template.
- text/html bleibt in der Mimetypeliste der Text-App (wichtig!).

Bei Nextcloud-Core selbst (lib/, config) wurde nichts geändert.

Installation

./install.sh nextcloud1-app-1

Idempotent, kann nach jedem htmlviewer-/Nextcloud-Update neu laufen. Backup des Original-TextDirectEditor landet unter /tmp/TextDirectEditor.php.bak-htmlproject im Container.

Nach App-Updates neu nötig

htmlviewer-App-Update überschreibt lib/DirectEditing/, templates/, Application.php-Registrierung → install.sh erneut
Nextcloud-Update überschreibt apps/text/.../TextDirectEditor.php → install.sh erneut

Dateien

patches/htmlviewer/HtmlDirectEditor.php — IEditor-Implementierung (DirectEditing-Registrierung, für Web-Client/Wiederverwendung)
patches/htmlviewer/HtmlDirectEditorBridge.php — statische Bridge, von TextDirectEditor aufgerufen
patches/htmlviewer/DirectController.php — /apps/htmlviewer/direct/{fileId} Content-Endpoint (NoAdminRequired, Session)
patches/htmlviewer/RegisterDirectEditorListener.php — RegisterDirectEditorEvent-Listener
patches/htmlviewer/directEditing-template.php — Template: Fullscreen-iframe mit srcdoc + sandbox
patches/htmlviewer/patch_app.py — idempotente Registrierung in Application.php + routes.php
patches/text/TextDirectEditor.php — gepatchte Text-App (open()-Bridge)
install.sh — Installer

Status (2026-09-11)

Auf nextcloud1 (Nextcloud 34.0.2, htmlviewer 33.0.0) deployed und iPhone-getestet: HTML rendert in der iOS-App in sandboxed WebView.

2.6 KiB Raw Blame History