Class HtmlTemplate

HtmlŞablonu

HTML'yi dinamik olarak oluşturmak için kullanılan bir şablon nesnesi. Daha fazla bilgi için şablon kılavuzuna bakın.

Yöntemler

YöntemDönüş türüKısa açıklama
evaluate()HtmlOutputBu şablonu değerlendirir ve HtmlOutput nesnesi döndürür.
getCode()StringŞablon dosyasına göre, değerlendirilebilecek bir JavaScript kodu dizesi oluşturur.
getCodeWithComments()StringDeğerlendirilebilen bir JavaScript kodu dizesi oluşturur. Kodun her satırında, şablondaki orijinal satır yorum olarak yer alır.
getRawContent()StringBu şablonun işlenmemiş içeriğini döndürür.

Ayrıntılı belgeler

evaluate()

Bu şablonu değerlendirir ve HtmlOutput nesnesi döndürür. Bu HtmlTemplate nesnesinde ayarlanan tüm özellikler değerlendirme sırasında kapsam dahilindedir. Şablondaki hataları ayıklamak için getCode() yöntemini kullanarak kodu inceleyin.

// 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!'

Return

HtmlOutput: Bir HtmlOutput nesnesi.


getCode()

Şablon dosyasına göre, değerlendirilebilecek bir JavaScript kodu dizesi oluşturur. Bu yöntem, şablon dosyasına göre bir JavaScript kodu dizesi oluşturur. eval(<code>) işlevi, tüm yerleştirilmiş sunucu komut dosyaları çalıştırıldıktan sonra şablonun içeriğini içeren yeni bir HtmlOutput nesnesi döndürür. Oluşturulan kodun insanlar tarafından okunması amaçlanmıştır. Bu nedenle, bir şablonda hata ayıklamanız gerekiyorsa ne üretildiğini görmek için Logger.log(<code>) işlevini çağırabilirsiniz.

Bu kodu değerlendirmek, geçerli kapsamdaki tüm değişkenleri dolaylı olarak bağlar. Genel olarak, açık bağlamaları alan evaluate() yönteminin kullanılması tercih edilir.

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

Return

String — Şablona dayalı ve değerlendirilebilen bir dize.


getCodeWithComments()

Değerlendirilebilen bir JavaScript kodu dizesi oluşturur. Kodun her satırında, şablondaki orijinal satır yorum olarak yer alır. Bu yöntem, şablon dosyasına dayalı bir JavaScript kodu dizesi oluşturur. eval(<code>) işlevi, tüm yerleştirilmiş sunucu komut dosyaları çalıştırıldıktan sonra şablonun içeriğini içeren yeni bir HtmlOutput nesnesi döndürür. Oluşturulan kodun okunabilir olması amaçlanmıştır. Bu nedenle, bir şablonda hata ayıklamanız gerekirse ne üretildiğini görmek için Logger.log(<code>) işlevini çağırabilirsiniz.

Bu kodu değerlendirmek, geçerli kapsamdaki tüm değişkenleri dolaylı olarak bağlar. Genel olarak, açık bağlamaları alan evaluate() yönteminin kullanılması tercih edilir.

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

Return

String — Şablona dayalı ve değerlendirilebilen bir dize.


getRawContent()

Bu şablonun işlenmemiş içeriğini döndürür.

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

Return

String — Şablonun ham içeriği.