Class HtmlTemplate

HtmlTemplate

Objet 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 HtmlOutput objet.
getCode()StringGénère une chaîne de code JavaScript, basée sur le fichier modèle, qui peut être évaluée.
getCodeWithComments()StringGénère une chaîne de code JavaScript qui peut être évaluée, chaque ligne du code contenant la ligne d'origine du modèle en tant que 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 le champ d'application lors de 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 : objet HtmlOutput.

getCode()

Génère une chaîne de code JavaScript, basée sur le fichier modèle, qui peut être évaluée. Cette méthode produit une chaîne de code JavaScript basée sur le fichier 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 qui peut ê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 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.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.