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

Class HtmlTemplate

Objet de modèle permettant de créer du code HTML de manière dynamique. Pour en savoir plus, consultez le guide des modèles.

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.

Documentation détaillée

`evaluate()`

Évalue ce modèle et renvoie un objet HtmlOutput. Toutes les propriétés définies sur cet objet HtmlTemplate seront incluses dans la portée lors de l'évaluation. Pour déboguer les erreurs d'un modèle, examinez le code à l'aide de la méthode getCode().

// A template which evaluates to whatever is bound to 'foo'.
const template = HtmlService.createTemplate('<?= foo ?>');
template.foo = 'Hello World!';
Logger.log(template.evaluate().getContent());  // will log 'Hello World!'

Renvois

HtmlOutput : objet HtmlOutput

`getCode()`

Génère une chaîne de code JavaScript, basée sur le fichier de modèle, qui peut être évaluée. Cette méthode produit une chaîne de code JavaScript basée sur le fichier de modèle. L'appel de eval(<code>) renvoie un nouvel objet HtmlOutput avec le contenu du modèle après l'exécution de tous les scripts de serveur intégrés. Le code généré est destiné à être lisible par l'humain. Par conséquent, si vous devez déboguer un modèle, vous pouvez appeler Logger.log(<code>) pour voir ce qui a été produit.

L'évaluation de ce code lie implicitement toutes les variables du champ d'application actuel. En règle générale, il est préférable d'utiliser la méthode evaluate(), qui accepte des liaisons explicites.

const template = HtmlService.createTemplate(
    '<b>The time is &lt;?= new Date() ?&gt;</b>',
);
Logger.log(template.getCode());

Renvois

String : chaîne basée sur le modèle, qui peut être évaluée

`getCodeWithComments()`

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. Cette méthode produit une chaîne de code JavaScript basée sur le fichier de modèle. L'appel de eval(<code>) renvoie un nouvel objet HtmlOutput avec le contenu du modèle après l'exécution de tous les scripts de serveur intégrés. Le code généré est censé être lisible par l'humain. Par conséquent, si vous devez déboguer un modèle, vous pouvez appeler Logger.log(<code>) pour voir ce qui a été produit.

const template = HtmlService.createTemplate(
    '<b>The time is &lt;?= new Date() ?&gt;</b>',
);
Logger.log(template.getCodeWithComments());

Renvois

String : chaîne basée sur le modèle, qui peut être évaluée

`getRawContent()`

Renvoie le contenu non traité de ce modèle.

const template = HtmlService.createTemplate(
    '<b>The time is &lt;?= new Date() ?&gt;</b>',
);
Logger.log(template.getRawContent());

Renvois

String : contenu brut du modèle