Class HtmlTemplate

Modèle HTML

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éthodeType renvoyéBrève description
evaluate()HtmlOutputÉvalue ce modèle et renvoie un objet HtmlOutput.
getCode()StringGénère une chaîne de code JavaScript, basée sur le fichier de modèle, qui peut être évaluée.
getCodeWithComments()StringGénère une chaîne de code JavaScript pouvant être évaluée, chaque ligne du code contenant la ligne d'origine du modèle sous forme de commentaire.
getRawContent()StringRenvoie 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 sont incluses dans l'évaluation. Pour déboguer les erreurs dans 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());  // logs 'Hello World!'

Renvois

HtmlOutput : un 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'homme. 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 dans le champ d'application actuel. En général, il est préférable d'utiliser la méthode evaluate(), qui accepte les 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 sous forme de 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 un 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 dans le champ d'application actuel. En général, il est préférable d'utiliser la méthode evaluate(), qui accepte les liaisons explicites.

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.