Class HtmlTemplate

HtmlTemplate

HTML을 동적으로 구성하기 위한 템플릿 객체입니다. 자세한 내용은 템플릿 가이드를 참고하세요.

메서드

메서드반환 유형간략한 설명
evaluate()HtmlOutput이 템플릿을 평가하고 HtmlOutput 객체를 반환합니다.
getCode()String평가할 수 있는 JavaScript 코드 문자열을 템플릿 파일을 기반으로 생성합니다.
getCodeWithComments()String평가할 수 있는 JavaScript 코드 문자열을 생성하며, 코드의 각 줄에는 템플릿의 원래 줄이 주석으로 포함됩니다.
getRawContent()String이 템플릿의 처리되지 않은 콘텐츠를 반환합니다.

자세한 문서

evaluate()

이 템플릿을 평가하고 HtmlOutput 객체를 반환합니다. 이 HtmlTemplate 객체에 설정된 모든 속성은 평가 시 범위에 포함됩니다. 템플릿의 오류를 디버그하려면 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!'

리턴

HtmlOutput: HtmlOutput 객체


getCode()

평가할 수 있는 JavaScript 코드 문자열을 템플릿 파일을 기반으로 생성합니다. 이 메서드는 템플릿 파일을 기반으로 JavaScript 코드 문자열을 생성합니다. eval(<code>)를 호출하면 모든 삽입된 서버 스크립트를 실행한 후 템플릿의 콘텐츠가 포함된 새 HtmlOutput 객체가 반환됩니다. 생성된 코드는 사람이 읽을 수 있도록 설계되었으므로 템플릿을 디버그해야 하는 경우 Logger.log(<code>)를 호출하여 생성된 내용을 확인할 수 있습니다.

이 코드를 평가하면 현재 범위의 모든 변수가 암시적으로 바인딩됩니다. 일반적으로 명시적 바인딩을 사용하는 evaluate() 메서드를 사용하는 것이 좋습니다.

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

리턴

String: 평가할 수 있는 템플릿 기반 문자열


getCodeWithComments()

평가할 수 있는 JavaScript 코드 문자열을 생성하며, 코드의 각 줄에는 템플릿의 원래 줄이 주석으로 포함됩니다. 이 메서드는 템플릿 파일을 기반으로 JavaScript 코드 문자열을 생성합니다. eval(<code>)를 호출하면 모든 삽입된 서버 스크립트를 실행한 후 템플릿의 콘텐츠가 포함된 새 HtmlOutput 객체가 반환됩니다. 생성된 코드는 사람이 읽을 수 있도록 설계되었으므로 템플릿을 디버그해야 하는 경우 Logger.log(<code>)를 호출하여 생성된 내용을 확인할 수 있습니다.

이 코드를 평가하면 현재 범위의 모든 변수가 암시적으로 바인딩됩니다. 일반적으로 명시적 바인딩을 사용하는 evaluate() 메서드를 사용하는 것이 좋습니다.

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

리턴

String: 평가할 수 있는 템플릿 기반 문자열


getRawContent()

이 템플릿의 처리되지 않은 콘텐츠를 반환합니다.

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

리턴

String: 템플릿의 원시 콘텐츠