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 méta 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.
SandboxModeEnumération représentant les modes de bac à sable pouvant être utilisés pour les scripts HtmlService côté client.
XFrameOptionsModeEnumé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 un nouveau contenu au contenu de cet élément HtmlOutput.
appendUntrusted(addedContent)HtmlOutputAjoute un nouveau contenu au contenu de cet élément HtmlOutput, à l'aide d'une échappement contextuel.
asTemplate()HtmlTemplateRenvoie un HtmlTemplate basé sur cet objet 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()BlobRenvoyez les données de cet objet sous forme de blob.
getContent()StringRécupère le contenu de cet élément HtmlOutput.
getFaviconUrl()StringRécupère l'URL d'une balise de lien de favicon ajoutée à la page en appelant setFaviconUrl(iconUrl).
getHeight()IntegerRécupère la hauteur initiale de la boîte de dialogue personnalisée dans Google Docs, Sheets ou Forms.
getMetaTags()HtmlOutputMetaTag[]Récupère un tableau d'objets représentant les balises méta ajoutées à la page en appelant addMetaTag(name, content).
getTitle()StringRécupère le titre de la page de sortie.
getWidth()IntegerRécupère la largeur initiale de la boîte de dialogue personnalisée dans Google Docs, Sheets ou Forms.
setContent(content)HtmlOutputDéfinit le contenu de cet élément HtmlOutput.
setFaviconUrl(iconUrl)HtmlOutputAjoute une balise de lien pour une icône de favoris à 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 l'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 hameçonnage par clic.

HtmlOutputMetaTag

Méthodes

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

HtmlService

Propriétés

PropriétéTypeDescription
SandboxModeSandboxModeEnumération représentant les modes de bac à sable pouvant être utilisés pour les scripts HtmlService côté client.
XFrameOptionsModeXFrameOptionsModeEnumé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 pouvant être renvoyé à partir du script.
createHtmlOutput(blob)HtmlOutputCrée un objet HtmlOutput à partir d'une ressource BlobSource.
createHtmlOutput(html)HtmlOutputCrée un objet HtmlOutput pouvant ê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 pouvant ê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 en tant que commentaire.
getRawContent()StringRenvoie le contenu non traité de ce modèle.

SandboxMode

Propriétés

PropriétéTypeDescription
EMULATEDEnumAncien mode bac à sable qui émule le mode strict ECMAScript 5 en n'utilisant que 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 ne sera 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.