HTML Service

HTML

Ce service permet aux applications Apps Script de renvoyer du code HTML, généralement sous la forme d'une interface utilisateur. Si vous débutez avec cette classe, nous vous recommandons également de consulter le guide du service HTML.

.

Classes

NomBrève description
HtmlOutputObjet HtmlOutput pouvant être diffusé à partir d'un script.
HtmlOutputMetaTagObjet représentant une balise Meta ajoutée à la page en appelant HtmlOutput.addMetaTag(name, content).
HtmlServiceService permettant de renvoyer du contenu HTML et d'autres contenus textuels à partir d'un script.
HtmlTemplateObjet de modèle permettant de créer du code HTML de manière dynamique.
SandboxModeÉnumération représentant les modes bac à sable pouvant être utilisés pour les scripts HtmlService côté client.
XFrameOptionsModeÉnumération représentant les modes X-Frame-Options pouvant être utilisés pour les scripts HtmlService côté client.

HtmlOutput

Méthodes

MéthodeType renvoyéBrève description
addMetaTag(name, content)HtmlOutputAjoute une balise Meta à la page.
append(addedContent)HtmlOutputAjoute du contenu à la fin du contenu de ce HtmlOutput.
appendUntrusted(addedContent)HtmlOutputAjoute du contenu à celui de ce HtmlOutput, en utilisant l'échappement contextuel.
asTemplate()HtmlTemplateRenvoie un HtmlTemplate soutenu par ce HtmlOutput.
clear()HtmlOutputEfface le contenu actuel.
getAs(contentType)BlobRenvoie les données de cet objet sous forme de blob converti au type de contenu spécifié.
getBlob()BlobRenvoie les données de cet objet sous forme de blob.
getContent()StringRécupère le contenu de ce HtmlOutput.
getFaviconUrl()StringRécupère l'URL d'une balise de lien de favicon ajoutée à la page en appelant setFaviconUrl(iconUrl).
getHeight()IntegerObtient la hauteur initiale de la boîte de dialogue personnalisée dans Google Docs, Sheets ou Forms.
getMetaTags()HtmlOutputMetaTag[]Obtient un tableau d'objets représentant les balises Meta ajoutées à la page en appelant addMetaTag(name, content).
getTitle()StringRécupère le titre de la page de sortie.
getWidth()IntegerObtient la largeur initiale de la boîte de dialogue personnalisée dans Google Docs, Sheets ou Forms.
setContent(content)HtmlOutputDéfinit le contenu de ce HtmlOutput.
setFaviconUrl(iconUrl)HtmlOutputAjoute une balise de lien pour un favicon à la page.
setHeight(height)HtmlOutputDéfinit la hauteur initiale de la boîte de dialogue personnalisée dans Google Docs, Sheets ou Forms.
setSandboxMode(mode)HtmlOutputCette méthode n'a désormais aucun effet. Auparavant, elle définissait le sandbox mode utilisé pour les scripts côté client.
setTitle(title)HtmlOutputDéfinit le titre de la page de sortie.
setWidth(width)HtmlOutputDéfinit la largeur initiale d'une boîte de dialogue personnalisée dans Google Docs, Sheets ou Forms.
setXFrameOptionsMode(mode)HtmlOutputDé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.

HtmlOutputMetaTag

Méthodes

MéthodeType renvoyéBrève description
getContent()StringRécupère le contenu de cette balise Meta.
getName()StringRécupère le nom de cet objet HtmlOutputMetaTag.

HtmlService

Propriétés

PropriétéTypeDescription
SandboxModeSandboxModeÉnumération représentant les modes bac à sable pouvant être utilisés pour les scripts HtmlService côté client.
XFrameOptionsModeXFrameOptionsModeÉnumération représentant les modes X-Frame-Options pouvant être utilisés pour les scripts HtmlService côté client.

Méthodes

MéthodeType renvoyéBrève description
createHtmlOutput()HtmlOutputCrée un objet HtmlOutput qui peut être renvoyé à partir du script.
createHtmlOutput(blob)HtmlOutputCrée un objet HtmlOutput à partir d'une ressource BlobSource.
createHtmlOutput(html)HtmlOutputCrée un objet HtmlOutput qui peut être renvoyé à partir du script.
createHtmlOutputFromFile(filename)HtmlOutputCrée un objet HtmlOutput à partir d'un fichier dans l'éditeur de code.
createTemplate(blob)HtmlTemplateCrée un objet HtmlTemplate à partir d'une ressource BlobSource.
createTemplate(html)HtmlTemplateCrée un objet HtmlTemplate qui peut être renvoyé à partir du script.
createTemplateFromFile(filename)HtmlTemplateCrée un objet HtmlTemplate à partir d'un fichier dans l'éditeur de code.
getUserAgent()StringObtient la chaîne user-agent du navigateur actuel.

HtmlTemplate

Méthodes

MéthodeType renvoyéBrève description
evaluate()HtmlOutputÉvalue ce modèle et renvoie un objet HtmlOutput.
getCode()StringGénère une chaîne de code JavaScript, basée sur le fichier de modèle, qui peut être évaluée.
getCodeWithComments()StringGénère une chaîne de code JavaScript pouvant être évaluée, chaque ligne du code contenant la ligne d'origine du modèle sous forme de commentaire.
getRawContent()StringRenvoie le contenu non traité de ce modèle.

SandboxMode

Propriétés

PropriétéTypeDescription
EMULATEDEnumMode bac à sable hérité qui émule le mode strict ECMAScript 5 en utilisant uniquement les fonctionnalités disponibles dans ECMAScript 3.
IFRAMEEnumMode bac à sable qui utilise le bac à sable iframe au lieu de la technologie de bac à sable Caja utilisée par les modes EMULATED et NATIVE.
NATIVEEnumMode bac à sable basé sur le mode strict ECMAScript 5.

XFrameOptionsMode

Propriétés

PropriétéTypeDescription
ALLOWALLEnumAucun en-tête X-Frame-Options n'est défini.
DEFAULTEnumDéfinit la valeur par défaut de l'en-tête X-Frame-Options, qui préserve les hypothèses de sécurité normales.