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

Class HtmlService

Service permettant de renvoyer du code HTML et d'autres contenus textuels à partir d'un script.

Pour des raisons de sécurité, les scripts ne peuvent pas renvoyer directement du contenu à un navigateur. Ils doivent donc nettoyer le code HTML afin qu'il ne puisse pas effectuer d'actions malveillantes. Reportez-vous à la description de HtmlOutput pour connaître les limites de ce champ concernant les éléments qui peuvent être renvoyés.

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.

Documentation détaillée

`createHtmlOutput()`

Crée un objet HtmlOutput qui peut être renvoyé à partir du script.

var output = HtmlService.createHtmlOutput();

Aller-retour

HtmlOutput : nouvel objet htmlOutput

`createHtmlOutput(blob)`

Il crée un objet HtmlOutput à partir d'une ressource BlobSource.

function createFromBlob(blob) {
  var output = HtmlService.createHtmlOutput(blob);
  return output;
}

Paramètres

Nom	Type	Description
`blob`	`BlobSource`	Objet contenant le code HTML

Aller-retour

HtmlOutput : nouvel objet HtmlOutput

Génère

Error : si l'objet blob ne contient pas de code HTML ou si son format est incorrect

`createHtmlOutput(html)`

Crée un objet HtmlOutput qui peut être renvoyé à partir du script.

var output = HtmlService.createHtmlOutput('<b>Hello world!</b>');

Paramètres

Nom	Type	Description
`html`	`String`	le contenu à diffuser

Aller-retour

HtmlOutput : nouvel objet htmlOutput

Génère

Error : si le code HTML n'est pas rédigé correctement

`createHtmlOutputFromFile(filename)`

Crée un objet HtmlOutput à partir d'un fichier dans l'éditeur de code.

var output = HtmlService.createHtmlOutputFromFile('myPage');

Paramètres

Nom	Type	Description
`filename`	`String`	Nom du fichier à utiliser

Aller-retour

HtmlOutput : nouvel objet HtmlOutput

Génère

Error : si le fichier est introuvable ou si son code HTML est incorrect

`createTemplate(blob)`

Il crée un objet HtmlTemplate à partir d'une ressource BlobSource.

function createFromBlob(blob) {
  var template = HtmlService.createTemplate(blob);
  return output;
}

Paramètres

Nom	Type	Description
`blob`	`BlobSource`	Objet dont le code HTML doit être extrait.

Aller-retour

HtmlTemplate : nouvel objet HtmlTemplate

Génère

Error : si l'objet blob ne contient pas de code HTML

`createTemplate(html)`

Crée un objet HtmlTemplate qui peut être renvoyé à partir du script.

var template = HtmlService.createTemplate('<b>The time is &lt;?= new Date() ?&gt;</b>');

Paramètres

Nom	Type	Description
`html`	`String`	le contenu du modèle

Aller-retour

HtmlTemplate : nouvel objet HtmlTemplate

`createTemplateFromFile(filename)`

Crée un objet HtmlTemplate à partir d'un fichier dans l'éditeur de code.

var template = HtmlService.createTemplateFromFile('myTemplate');

Paramètres

Nom	Type	Description
`filename`	`String`	Nom du fichier à utiliser

Aller-retour

HtmlTemplate : nouvel objet HtmlTemplate

Génère

Error — si le fichier est introuvable

`getUserAgent()`

Récupère la chaîne user-agent du navigateur actuel. Renvoie null pour la plupart des exécutions de script si elles ne sont pas utilisées dans une fonction doGet() ou doPost() d'une application Web.

Aller-retour

String : chaîne du user-agent