Class HtmlOutput

Ajoute une balise Meta à la page. Les balises Meta incluses directement dans un fichier HTML Apps Script sont ignorées. Seules les balises Meta suivantes sont autorisées:

<meta name="apple-mobile-web-app-capable" content="..."/>
<meta name="google-site-verification" content="..."/>
<meta name="mobile-web-app-capable" content="..."/>
<meta name="viewport" content="..."/>

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.addMetaTag('viewport', 'width=device-width, initial-scale=1');

Paramètres

Aller-retour

HtmlOutput : sortie pour le chaînage.

Ajoute du nouveau contenu au contenu de cette HtmlOutput. N'utilisez cette option que pour le contenu provenant d'une source fiable, car elle ne dispose pas d'échappement.

// Log "<b>Hello, world!</b><p>Hello again, world.</p>"
var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.append('<p>Hello again, world.</p>');
Logger.log(output.getContent());

Paramètres

Aller-retour

HtmlOutput : sortie pour le chaînage.

Génère

Error : si le code HTML est incorrect

Voir aussi

• appendUntrusted(addedContent)

Ajoute du nouveau contenu au contenu de cette HtmlOutput à l'aide de l'échappement contextuel.

Cette méthode échappe correctement le contenu en fonction de l'état actuel de HtmlOutput, afin que le résultat soit une chaîne sécurisée sans balisage ni impact secondaire. Utilisez cette méthode plutôt que "append" chaque fois que vous ajoutez du contenu provenant d'une source non fiable, comme celle d'un utilisateur, afin d'éviter d'autoriser accidentellement un bug de script intersites (XSS) qui ajoute du code ou une exécution inattendue du contenu ou du balisage.

// Log "<b>Hello, world!</b>&lt;p&gt;Hello again, world.&lt;/p&gt;"
var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.appendUntrusted('<p>Hello again, world.</p>');
Logger.log(output.getContent());

Paramètres

Aller-retour

HtmlOutput : sortie pour le chaînage.

Génère

Error : si le code HTML est très incorrect

Voir aussi

• append(addedContent)

Renvoie un HtmlTemplate basé sur ce HtmlOutput. Cette méthode peut servir à créer un modèle de manière incrémentielle. Les modifications ultérieures sur HtmlOutput affectent également le contenu de HtmlTemplate.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
var template = output.asTemplate();

Aller-retour

HtmlTemplate : nouveau HtmlTemplate.

Efface le contenu actuel.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.clear();

Aller-retour

HtmlOutput : sortie pour le chaînage.

Renvoyez les données de cet objet en tant qu'objet blob converti au type de contenu spécifié. Cette méthode ajoute l'extension appropriée au nom de fichier, par exemple "monfichier.pdf". Toutefois, nous partons du principe que la partie du nom de fichier qui suit la dernière période (le cas échéant) est une extension existante qui doit être remplacée. Par conséquent, "ShoppingList.12.25.2014" devient "ShoppingList.12.25.pdf".

Pour afficher les quotas quotidiens des conversions, consultez la page Quotas pour les services Google. Les domaines Google Workspace créés récemment peuvent être soumis à des quotas plus stricts.

Paramètres

Aller-retour

Blob : données en tant que blob.

Renvoyez les données de cet objet en tant que blob.

Aller-retour

Blob : données en tant que blob.

Récupère le contenu de HtmlOutput.

// Log "<b>Hello, world!</b>"
var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
Logger.log(output.getContent());

Aller-retour

String : contenu diffusé.

Récupère l'URL d'un tag de lien favicon ajouté à la page en appelant setFaviconUrl(iconUrl). Les tags de lien Favicon inclus directement dans un fichier HTML Apps Script sont ignorés.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setFaviconUrl('http://www.example.com/image.png');
Logger.log(output.getFaviconUrl());

Aller-retour

String : URL de l'image favicon.

Récupère la hauteur initiale de la boîte de dialogue personnalisée dans Google Docs, Sheets ou Forms. Si HtmlOutput est publié en tant qu'application Web, cette méthode renvoie null. Pour redimensionner une boîte de dialogue déjà ouverte, appelez google.script.host.setHeight(height) dans le code côté client.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setHeight(200);
Logger.log(output.getHeight());

Aller-retour

Integer : hauteur, en pixels.

Récupère un tableau d'objets représentant des balises Meta ajoutées à la page en appelant addMetaTag(name, content). Les balises Meta incluses directement dans un fichier HTML Apps Script sont ignorées.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.addMetaTag('viewport', 'width=device-width, initial-scale=1');

var tags = output.getMetaTags();
Logger.log('<meta name="%s" content="%s"/>', tags[0].getName(), tags[0].getContent());

Aller-retour

HtmlOutputMetaTag[] : tableau d'objets représentant les balises Meta ajoutées à la page en appelant addMetaTag(name, content).

Récupère le titre de la page de sortie. Notez que l'élément HTML <title> est ignoré.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
Logger.log(output.getTitle());

Aller-retour

String : titre de la page.

Récupère la largeur initiale de la boîte de dialogue personnalisée dans Google Docs, Sheets ou Forms. Si HtmlOutput est publié en tant qu'application Web, cette méthode renvoie null. Pour redimensionner une boîte de dialogue déjà ouverte, appelez google.script.host.setWidth(width) dans le code côté client.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setWidth(200);
Logger.log(output.getWidth());

Aller-retour

Integer : largeur en pixels.

Définit le contenu de ce HtmlOutput.

var output = HtmlService.createHtmlOutput();
output.setContent('<b>Hello, world!</b>');

Paramètres

Aller-retour

HtmlOutput : sortie pour le chaînage.

Génère

Error : si le code HTML est incorrect

Ajoute un tag de lien pour un favicon à la page. Les tags de lien de favicon inclus directement dans un fichier HTML Apps Script sont ignorés.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setFaviconUrl('http://www.example.com/image.png');

Paramètres

Aller-retour

HtmlOutput : sortie pour le chaînage.

Définit la hauteur initiale de la boîte de dialogue personnalisée dans Google Docs, Sheets ou Forms. Si HtmlOutput est publié en tant qu'application Web, cette méthode n'a aucun effet. Pour redimensionner une boîte de dialogue déjà ouverte, appelez google.script.host.setHeight(height) dans le code côté client.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setHeight(200);

Paramètres

Aller-retour

HtmlOutput : sortie pour le chaînage.

Cette méthode n'a plus d'effet : elle définissait sandbox mode pour les scripts côté client. Pour empêcher les utilisateurs d'être exposés à du code HTML ou JavaScript malveillant, le code côté client diffusé à partir du service HTML s'exécute dans un bac à sable de sécurité qui impose des restrictions sur le code. Auparavant, cette méthode permettait aux auteurs de scripts de choisir entre différentes versions du bac à sable. Désormais, tous les scripts utilisent désormais le mode IFRAME, quel que soit le mode de bac à sable défini. Pour en savoir plus, consultez le guide sur les restrictions dans le service HTML.

Le mode IFRAME impose beaucoup moins de restrictions que les autres modes Sandbox et s'exécute plus rapidement, mais ne fonctionne pas du tout dans certains navigateurs plus anciens, y compris Internet Explorer 9. Le mode sandbox peut être lu dans un script côté client en inspectant google.script.sandbox.mode. Notez que cette propriété renvoie le mode réel sur le client, qui peut être différent du mode demandé sur le serveur si le mode demandé n'est pas compatible avec le navigateur de l'utilisateur.

<!-- Read the sandbox mode (in a client-side script). -->
<script>
  alert(google.script.sandbox.mode);
</script>

Paramètres

Aller-retour

HtmlOutput : sortie pour le chaînage.

Définit le titre de la page de sortie. Pour les applications Web, il s'agit du titre de la page entière, tandis que pour HtmlOutput s'affiche dans Google Sheets, il s'agit du titre de la boîte de dialogue.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setTitle('My First Page');

Paramètres

Aller-retour

HtmlOutput : sortie pour le chaînage.

Définit la largeur initiale d'une boîte de dialogue personnalisée dans Google Docs, Sheets ou Forms. Si HtmlOutput est publié en tant qu'application Web, cette méthode n'a aucun effet. Pour redimensionner une boîte de dialogue déjà ouverte, appelez google.script.host.setWidth(width) dans le code côté client.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setWidth(200);

Paramètres

Aller-retour

HtmlOutput : sortie pour le chaînage.

Définit l'état de l'en-tête X-Frame-Options de la page, qui contrôle la prévention du détournement de clic.

Définir XFrameOptionsMode.ALLOWALL permet à n'importe quel site d'iFrame la page. Le développeur doit donc mettre en œuvre sa propre protection contre le détournement de clic.

Si un script ne définit pas le mode X-Frame-Options, Apps Script utilise le mode XFrameOptionsMode.DEFAULT comme mode par défaut.

// Serve HTML with no X-Frame-Options header (in Apps Script server-side code).
var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setXFrameOptionsMode(HtmlService.XFrameOptionsMode.ALLOWALL);

Paramètres

Aller-retour

HtmlOutput : sortie pour le chaînage.