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 ce cours, nous vous recommandons de consulter également le guide du service HTML.

.

Classes

NomBrève description
HtmlOutputUn objet HtmlOutput qui peut ê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 code HTML et d'autres contenus textuels à partir d'un script.
HtmlTemplateObjet de modèle permettant de créer dynamiquement du code HTML
SandboxModeÉnumération représentant les modes de 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 nouveau contenu au contenu de cette HtmlOutput.
appendUntrusted(addedContent)HtmlOutputAjoute du nouveau contenu au contenu de cette HtmlOutput à l'aide de l'échappement contextuel.
asTemplate()HtmlTemplateRenvoie un HtmlTemplate basé sur ce HtmlOutput.
clear()HtmlOutputEfface le contenu actuel.
getAs(contentType)BlobRenvoyez les données de cet objet en tant qu'objet blob converti au type de contenu spécifié.
getBlob()BlobRenvoyez les données de cet objet en tant que blob.
getContent()StringRécupère le contenu de HtmlOutput.
getFaviconUrl()StringRécupère l'URL d'un tag de lien favicon ajouté à 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 des balises Meta 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 ce HtmlOutput.
setFaviconUrl(iconUrl)HtmlOutputAjoute un tag 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 plus d'effet : elle définissait sandbox mode 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 élément HtmlOutputMetaTag.

HtmlService

Propriétés

PropriétéTypeDescription
SandboxModeSandboxModeÉnumération représentant les modes de 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)HtmlOutputIl cré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)HtmlTemplateIl cré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()StringRécupère 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 en tant que commentaire la ligne d'origine du modèle.
getRawContent()StringAffiche 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 à l'aide des fonctionnalités disponibles uniquement dans ECMAScript 3.
IFRAMEEnumUn mode de bac à sable qui utilise le bac à sable iFrame au lieu de la technologie de bac à sable de 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, ce qui préserve les hypothèses de sécurité normales.