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

Classes

Nom	Brève description
`HtmlOutput`	Objet `HtmlOutput` pouvant être diffusé à partir d'un script.
`HtmlOutputMetaTag`	Objet représentant une balise méta 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`	Enumération représentant les modes de bac à sable pouvant être utilisés pour les scripts `HtmlService` côté client.
`XFrameOptionsMode`	Enumé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 un nouveau contenu au contenu de cet élément `HtmlOutput`.
`appendUntrusted(addedContent)`	`HtmlOutput`	Ajoute un nouveau contenu au contenu de cet élément `HtmlOutput`, à l'aide d'une échappement contextuel.
`asTemplate()`	`HtmlTemplate`	Renvoie un `HtmlTemplate` basé sur cet objet `HtmlOutput`.
`clear()`	`HtmlOutput`	Efface le contenu actuel.
`getAs(contentType)`	`Blob`	Renvoie les données de cet objet sous forme de blob converti au type de contenu spécifié.
`getBlob()`	`Blob`	Renvoyez les données de cet objet sous forme de blob.
`getContent()`	`String`	Récupère le contenu de cet élément `HtmlOutput`.
`getFaviconUrl()`	`String`	Récupère l'URL d'une balise de lien de 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 les balises méta 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 une balise de lien pour une icône de favoris à 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 désormais aucun effet. Auparavant, elle définissait l'`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 la prévention du hameçonnage par clic.

`HtmlOutputMetaTag`

Méthodes

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

`HtmlService`

Propriétés

Propriété	Type	Description
`SandboxMode`	`SandboxMode`	Enumération représentant les modes de bac à sable pouvant être utilisés pour les scripts `HtmlService` côté client.
`XFrameOptionsMode`	`XFrameOptionsMode`	Enumé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` pouvant ê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` pouvant ê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`	Crée un objet `HtmlTemplate` à partir d'une ressource `BlobSource`.
`createTemplate(html)`	`HtmlTemplate`	Crée un objet `HtmlTemplate` pouvant être renvoyé à partir du script.
`createTemplateFromFile(filename)`	`HtmlTemplate`	Crée un objet `HtmlTemplate` à partir d'un fichier dans l'éditeur de code.
`getUserAgent()`	`String`	Obtient 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 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 n'utilisant que les fonctionnalités disponibles dans ECMAScript 3.
`IFRAME`	`Enum`	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`, qui préserve les hypothèses de sécurité normales.