HTML Service

w kodzie HTML,

Ta usługa umożliwia aplikacjom Apps Script zwracanie kodu HTML, zwykle jako interfejsu użytkownika. Jeśli dopiero zaczynasz korzystać z tej klasy, zapoznaj się też z przewodnikiem po usłudze HTML.

.

Zajęcia

NazwaKrótki opis
HtmlOutputObiekt HtmlOutput, który można wyświetlać za pomocą skryptu.
HtmlOutputMetaTagObiekt reprezentujący metatag dodany do strony przez wywołanie HtmlOutput.addMetaTag(name, content).
HtmlServiceUsługa zwracająca kod HTML i inne treści tekstowe ze skryptu.
HtmlTemplateObiekt szablonu do dynamicznego tworzenia kodu HTML.
SandboxModeWartość wyliczająca tryby piaskownicy, które mogą być używane dla skryptów HtmlService po stronie klienta.
XFrameOptionsModeWyliczenie przedstawiające tryby X-Frame-Options, których można używać w skryptach HtmlService po stronie klienta.

HtmlOutput

Metody

MetodaZwracany typKrótki opis
addMetaTag(name, content)HtmlOutputDodaje metatag do strony.
append(addedContent)HtmlOutputDołącza nową treść do sekcji HtmlOutput.
appendUntrusted(addedContent)HtmlOutputDodaje nową treść do elementu HtmlOutput, stosując zmianę znaczenia.
asTemplate()HtmlTemplateZwraca obiekt HtmlTemplate obsługiwany przez zasadę HtmlOutput.
clear()HtmlOutputCzyści bieżącą zawartość.
getAs(contentType)BlobZwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści.
getBlob()BlobZwraca dane wewnątrz tego obiektu jako blob.
getContent()StringPobiera zawartość HtmlOutput.
getFaviconUrl()StringPobiera adres URL favikony dodanej do strony przez wywołanie setFaviconUrl(iconUrl).
getHeight()IntegerPoczątkowa wysokość okna niestandardowego w Dokumentach, Arkuszach lub Formularzach Google.
getMetaTags()HtmlOutputMetaTag[]Pobiera tablicę obiektów reprezentujących metatagi dodane do strony przez wywołanie addMetaTag(name, content).
getTitle()StringPobiera tytuł strony wyjściowej.
getWidth()IntegerPoczątkowa szerokość okna niestandardowego w Dokumentach, Arkuszach lub Formularzach Google.
setContent(content)HtmlOutputUstawia treść elementu HtmlOutput.
setFaviconUrl(iconUrl)HtmlOutputDodaje do strony tag linku do favikony.
setHeight(height)HtmlOutputOkreśla początkową wysokość okna niestandardowego w Dokumentach, Arkuszach lub Formularzach Google.
setSandboxMode(mode)HtmlOutputTa metoda nie ma już skutków – wcześniej ustawiona była zasada sandbox mode używana w skryptach po stronie klienta.
setTitle(title)HtmlOutputUstawia tytuł strony wyjściowej.
setWidth(width)HtmlOutputOkreśla początkową szerokość niestandardowego okna w Dokumentach, Arkuszach lub Formularzach Google.
setXFrameOptionsMode(mode)HtmlOutputUstawia stan nagłówka X-Frame-Options na stronie, który zapobiega zapobieganiem przejęciom kliknięć.

HtmlOutputMetaTag

Metody

MetodaZwracany typKrótki opis
getContent()StringPobiera zawartość tego metatagu.
getName()StringPobiera nazwę tego elementu: HtmlOutputMetaTag.

HtmlService

Właściwości

WłaściwośćTypOpis
SandboxModeSandboxModeWartość wyliczająca tryby piaskownicy, które mogą być używane dla skryptów HtmlService po stronie klienta.
XFrameOptionsModeXFrameOptionsModeWyliczenie przedstawiające tryby X-Frame-Options, których można używać w skryptach HtmlService po stronie klienta.

Metody

MetodaZwracany typKrótki opis
createHtmlOutput()HtmlOutputTworzy nowy obiekt HtmlOutput, który można zwrócić ze skryptu.
createHtmlOutput(blob)HtmlOutputTworzy nowy obiekt HtmlOutput z zasobu BlobSource.
createHtmlOutput(html)HtmlOutputTworzy nowy obiekt HtmlOutput, który można zwrócić ze skryptu.
createHtmlOutputFromFile(filename)HtmlOutputTworzy nowy obiekt HtmlOutput z pliku w edytorze kodu.
createTemplate(blob)HtmlTemplateTworzy nowy obiekt HtmlTemplate z zasobu BlobSource.
createTemplate(html)HtmlTemplateTworzy nowy obiekt HtmlTemplate, który można zwrócić ze skryptu.
createTemplateFromFile(filename)HtmlTemplateTworzy nowy obiekt HtmlTemplate z pliku w edytorze kodu.
getUserAgent()StringPobiera ciąg znaków klienta użytkownika dla bieżącej przeglądarki.

HtmlTemplate

Metody

MetodaZwracany typKrótki opis
evaluate()HtmlOutputOcenia ten szablon i zwraca obiekt HtmlOutput.
getCode()StringGeneruje ciąg kodu JavaScript na podstawie pliku szablonu, który można ocenić.
getCodeWithComments()StringGeneruje ciąg kodu JavaScript, który można ocenić. Każdy wiersz tego kodu zawiera oryginalny wiersz z szablonu jako komentarz.
getRawContent()StringZwraca nieprzetworzoną zawartość tego szablonu.

SandboxMode

Właściwości

WłaściwośćTypOpis
EMULATEDEnumStarszy tryb piaskownicy, który emuluje ścisły tryb ECMAscript 5 przy użyciu tylko funkcji dostępnych w ECMAScript 3.
IFRAMEEnumTryb piaskownicy, który używa piaskownicy piaskownicy iframe zamiast technologii piaskownicy Caja używanej w trybach EMULATED i NATIVE.
NATIVEEnumTryb piaskownicy oparty na ścisłym trybie ECMAScript 5.

XFrameOptionsMode

Właściwości

WłaściwośćTypOpis
ALLOWALLEnumNagłówek X-Frame-Options nie zostanie ustawiony.
DEFAULTEnumUstawia domyślną wartość nagłówka X-Frame-Options, która pozwala zachować normalne zabezpieczenia.