Perché il tuo file HTML sembra rotto nell'anteprima di File su iOS

Cosa fa davvero l'anteprima di File

Quick Look — il sistema di anteprima dietro quel tocco — mostra l'HTML in una modalità volutamente limitata. È pensato per un'occhiata sicura, non per la fedeltà:

• I fogli di stile esterni non vengono caricati: sopravvivono solo gli stili inline.
• Il JavaScript non viene mai eseguito: tutto ciò che la pagina costruisce a runtime semplicemente non esiste.
• I file richiamati con percorsi relativi — immagini, font, altre pagine — non vengono risolti.
• Non c'è modo di concedere a una pagina l'accesso alla rete, nemmeno volendolo.

Diagnosi in base al sintomo

• Testo leggibile, zero stile → la pagina usa un foglio di stile esterno o su CDN che l'anteprima ha ignorato.
• Completamente vuota → la pagina viene costruita dal JavaScript (tipico delle app e delle pagine con grafici generate dall'IA); senza script non c'è nulla da mostrare.
• Codice grezzo a schermo → il file è arrivato come .txt o ha perso l'estensione per strada; rinominarlo di nuovo in .html ripristina il comportamento corretto.
• Icone di immagini rotte → le immagini stanno accanto al file HTML; aprire in anteprima il solo file le lascia orfane.
• Caratteri illeggibili (中文/日本語 come simboli) → il file usa una codifica legacy come GB18030 o Shift-JIS che l'anteprima ha letto come UTF-8.

La soluzione: aprilo con un vero motore di rendering

Tutti i guasti qui sopra spariscono quando il file viene aperto da qualcosa che mostra l'HTML come si deve. OpenHTML (gratis) lo fa sul dispositivo: condividi il file con l'app — oppure aprilo una volta sola da File senza importarlo — e la pagina si mostra con gli stili applicati e il JavaScript locale in esecuzione.

• Pagine multi-file: importa la cartella o lo ZIP così i percorsi relativi continuano a funzionare — vedi progetti web ZIP su iPhone.
• Le codifiche legacy vengono rilevate automaticamente, così il testo CJK si vede correttamente.
• Se qualcosa ancora non torna, la Diagnostica nomina il file mancante o la risorsa bloccata esatta invece di lasciarti tirare a indovinare, e dove possibile propone una correzione con un tocco.

A differenza dell'anteprima, OpenHTML ti permette di consentire l'accesso alla rete per singolo documento quando una pagina ha davvero bisogno della sua CDN, mantenendo ogni altra pagina completamente offline.

Perché non usare semplicemente Safari?

Safari è un motore di rendering eccellente, ma non esiste alcun modo supportato per dargli in pasto un file locale insieme alle sue risorse. Gli espedienti ci sono, ma ognuno ha un lato tagliente: i file singoli a volte si aprono con Condividi → Safari, però perdono i file che stanno loro accanto; ospitare il file da qualche parte trasforma dati privati in un caricamento. Per i file, un'app di visualizzazione è la risposta noiosa e affidabile — la guida completa per aprire l'HTML su iPhone mette a confronto tutte le opzioni.