Cette page a été traduite par l'API Cloud Translation.

HTML Service

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 sur le service HTML.

Classes

Nom	Brève description
`HtmlOutput`	Objet `HtmlOutput` pouvant être diffusé à partir d'un script.
`HtmlOutputMetaTag`	Objet représentant une balise Meta ajoutée à la page en appelant `HtmlOutput.addMetaTag(name, content)`.
`HtmlService`	Service permettant de renvoyer du contenu HTML et d'autres contenus textuels à partir d'un script.
`HtmlTemplate`	Objet de modèle permettant de créer du code HTML de manière dynamique.
`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éthode	Type renvoyé	Brève description
`addMetaTag(name, content)`	`HtmlOutput`	Ajoute une balise Meta à la page.
`append(addedContent)`	`HtmlOutput`	Ajoute le nouveau contenu au contenu de ce `HtmlOutput`.
`appendUntrusted(addedContent)`	`HtmlOutput`	Ajoute du nouveau contenu au contenu de ce `HtmlOutput` à l'aide d'échappements contextuels.
`asTemplate()`	`HtmlTemplate`	Renvoie un `HtmlTemplate` sauvegardé par ce `HtmlOutput`.
`clear()`	`HtmlOutput`	Efface le contenu actuel.
`getAs(contentType)`	`Blob`	Renvoie les données contenues dans cet objet sous forme d'objet blob converti dans le type de contenu spécifié.
`getBlob()`	`Blob`	Renvoyez les données contenues dans cet objet sous forme d'objet blob.
`getContent()`	`String`	Récupère le contenu de ce `HtmlOutput`.
`getFaviconUrl()`	`String`	Récupère l'URL d'une balise de lien favicon ajoutée à la page en appelant `setFaviconUrl(iconUrl)`.
`getHeight()`	`Integer`	Ré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()`	`String`	Récupère le titre de la page de sortie.
`getWidth()`	`Integer`	Récupère la largeur initiale de la boîte de dialogue personnalisée dans Google Docs, Sheets ou Forms.
`setContent(content)`	`HtmlOutput`	Définit le contenu de cet élément `HtmlOutput`.
`setFaviconUrl(iconUrl)`	`HtmlOutput`	Ajoute à la page une balise de lien pour un favicon.
`setHeight(height)`	`HtmlOutput`	Définit la hauteur initiale de la boîte de dialogue personnalisée dans Google Docs, Sheets ou Forms.
`setSandboxMode(mode)`	`HtmlOutput`	Cette méthode n'a plus aucun effet. Auparavant, elle définissait le `sandbox mode` utilisé pour les scripts côté client.
`setTitle(title)`	`HtmlOutput`	Définit le titre de la page de sortie.
`setWidth(width)`	`HtmlOutput`	Définit la largeur initiale d'une boîte de dialogue personnalisée dans Google Docs, Sheets ou Forms.
`setXFrameOptionsMode(mode)`	`HtmlOutput`	Définit l'état de l'en-tête `X-Frame-Options` de la page, qui contrôle le blocage du détournement de clic.

`HtmlOutputMetaTag`

Méthodes

Méthode	Type renvoyé	Brève description
`getContent()`	`String`	Récupère le contenu de cette balise Meta.
`getName()`	`String`	Récupère le nom de ce `HtmlOutputMetaTag`.

`HtmlService`

Propriétés

Propriété	Type	Description
`SandboxMode`	`SandboxMode`	Énumération représentant les modes de bac à sable pouvant être utilisés pour les scripts `HtmlService` côté client.
`XFrameOptionsMode`	`XFrameOptionsMode`	Énumération représentant les modes `X-Frame-Options` pouvant être utilisés pour les scripts `HtmlService` côté client.

Méthodes

Méthode	Type renvoyé	Brève description
`createHtmlOutput()`	`HtmlOutput`	Crée un objet `HtmlOutput` qui peut être renvoyé à partir du script.
`createHtmlOutput(blob)`	`HtmlOutput`	Crée un objet `HtmlOutput` à partir d'une ressource `BlobSource`.
`createHtmlOutput(html)`	`HtmlOutput`	Crée un objet `HtmlOutput` qui peut être renvoyé à partir du script.
`createHtmlOutputFromFile(filename)`	`HtmlOutput`	Crée un objet `HtmlOutput` à partir d'un fichier de l'éditeur de code.
`createTemplate(blob)`	`HtmlTemplate`	Crée un objet `HtmlTemplate` à partir d'une ressource `BlobSource`.
`createTemplate(html)`	`HtmlTemplate`	Crée un objet `HtmlTemplate` qui peut être renvoyé à partir du script.
`createTemplateFromFile(filename)`	`HtmlTemplate`	Crée un objet `HtmlTemplate` à partir d'un fichier de l'éditeur de code.
`getUserAgent()`	`String`	Récupère la chaîne du user-agent pour le navigateur actuel.

`HtmlTemplate`

Méthodes

Méthode	Type renvoyé	Brève description
`evaluate()`	`HtmlOutput`	Évalue ce modèle et renvoie un objet `HtmlOutput`.
`getCode()`	`String`	Génère une chaîne de code JavaScript, basée sur le fichier de modèle, pouvant être évaluée.
`getCodeWithComments()`	`String`	Gé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()`	`String`	Renvoie le contenu non traité de ce modèle.

`SandboxMode`

Propriétés

Propriété	Type	Description
`EMULATED`	`Enum`	Ancien mode bac à sable qui émule le mode strict ECMAScript 5 en utilisant uniquement les fonctionnalités disponibles dans ECMAScript 3
`IFRAME`	`Enum`	Un mode 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`
`NATIVE`	`Enum`	Mode bac à sable basé sur le mode strict ECMAScript 5.

`XFrameOptionsMode`

Propriétés

Propriété	Type	Description
`ALLOWALL`	`Enum`	Aucun en-tête `X-Frame-Options` ne sera défini.
`DEFAULT`	`Enum`	Dé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.