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 du service HTML.

Classes

Nom	Brève description
`HtmlOutput`	Un objet `HtmlOutput` qui peut ê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 code HTML et d'autres contenus textuels à partir d'un script.
`HtmlTemplate`	Objet 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éthode	Type renvoyé	Brève description
`addMetaTag(name, content)`	`HtmlOutput`	Ajoute une balise Meta à la page.
`append(addedContent)`	`HtmlOutput`	Ajoute du nouveau contenu au contenu de cette `HtmlOutput`.
`appendUntrusted(addedContent)`	`HtmlOutput`	Ajoute du nouveau contenu au contenu de cette `HtmlOutput` à l'aide de l'échappement contextuel.
`asTemplate()`	`HtmlTemplate`	Renvoie un `HtmlTemplate` basé sur ce `HtmlOutput`.
`clear()`	`HtmlOutput`	Efface le contenu actuel.
`getAs(contentType)`	`Blob`	Renvoyez les données de cet objet en tant qu'objet blob converti au type de contenu spécifié.
`getBlob()`	`Blob`	Renvoyez les données de cet objet en tant que blob.
`getContent()`	`String`	Récupère le contenu de `HtmlOutput`.
`getFaviconUrl()`	`String`	Récupère l'URL d'un tag de lien favicon ajouté à 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 ce `HtmlOutput`.
`setFaviconUrl(iconUrl)`	`HtmlOutput`	Ajoute un tag de lien pour un favicon à la page.
`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 d'effet : elle définissait `sandbox mode` 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 la prévention 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 cet élément `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`	Il 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 dans l'éditeur de code.
`createTemplate(blob)`	`HtmlTemplate`	Il 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 dans l'éditeur de code.
`getUserAgent()`	`String`	Récupère la chaîne user-agent du 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, qui peut être évaluée.
`getCodeWithComments()`	`String`	Gé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()`	`String`	Affiche 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 à l'aide des fonctionnalités disponibles uniquement dans ECMAScript 3.
`IFRAME`	`Enum`	Un 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`.
`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.