Usługa zwracająca kod HTML i inne treści tekstowe ze skryptu.
Ze względów bezpieczeństwa skrypty nie mogą bezpośrednio zwracać treści do przeglądarki. Zamiast tego:
muszą oczyścić kod HTML, tak aby nie mógł wykonywać szkodliwych działań. Zobacz opis
HtmlOutput
– informacje o ograniczeniach dotyczących elementów, które mogą być zwracane.
Właściwości
Właściwość | Typ | Opis |
---|---|---|
SandboxMode | SandboxMode | Wyliczenie reprezentujące tryby piaskownicy, które mogą być używane na potrzeby funkcji HtmlService po stronie klienta
skryptów. |
XFrameOptionsMode | XFrameOptionsMode | Wyliczenie reprezentujące tryby X-Frame-Options , które mogą być używane w przypadku skryptów HtmlService po stronie klienta. |
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
createHtmlOutput() | HtmlOutput | Tworzy nowy obiekt HtmlOutput , który może zostać zwrócony przez skrypt. |
createHtmlOutput(blob) | HtmlOutput | Tworzy nowy obiekt HtmlOutput z zasobu BlobSource . |
createHtmlOutput(html) | HtmlOutput | Tworzy nowy obiekt HtmlOutput , który może zostać zwrócony przez skrypt. |
createHtmlOutputFromFile(filename) | HtmlOutput | Tworzy nowy obiekt HtmlOutput z pliku w edytorze kodu. |
createTemplate(blob) | HtmlTemplate | Tworzy nowy obiekt HtmlTemplate z zasobu BlobSource . |
createTemplate(html) | HtmlTemplate | Tworzy nowy obiekt HtmlTemplate , który może zostać zwrócony przez skrypt. |
createTemplateFromFile(filename) | HtmlTemplate | Tworzy nowy obiekt HtmlTemplate z pliku w edytorze kodu. |
getUserAgent() | String | Pobiera ciąg znaków klienta użytkownika dla bieżącej przeglądarki. |
Szczegółowa dokumentacja
createHtmlOutput()
Tworzy nowy obiekt HtmlOutput
, który może zostać zwrócony przez skrypt.
var output = HtmlService.createHtmlOutput();
Powrót
HtmlOutput
– nowy obiekt htmlOutput,
createHtmlOutput(blob)
Tworzy nowy obiekt HtmlOutput
z zasobu BlobSource
.
function createFromBlob(blob) { var output = HtmlService.createHtmlOutput(blob); return output; }
Parametry
Nazwa | Typ | Opis |
---|---|---|
blob | BlobSource | z obiektu, z którego |
Powrót
HtmlOutput
– nowy obiekt HtmlOutput
,
Rzuty
Error
– jeśli obiekt blob nie zawiera kodu HTML lub ma on nieprawidłowy format,
createHtmlOutput(html)
Tworzy nowy obiekt HtmlOutput
, który może zostać zwrócony przez skrypt.
var output = HtmlService.createHtmlOutput('<b>Hello world!</b>');
Parametry
Nazwa | Typ | Opis |
---|---|---|
html | String | treść, która ma być wyświetlana |
Powrót
HtmlOutput
– nowy obiekt htmlOutput,
Rzuty
Error
– jeśli plik HTML jest uszkodzony.
createHtmlOutputFromFile(filename)
Tworzy nowy obiekt HtmlOutput
z pliku w edytorze kodu.
var output = HtmlService.createHtmlOutputFromFile('myPage');
Parametry
Nazwa | Typ | Opis |
---|---|---|
filename | String | nazwa pliku, którego chcesz użyć |
Powrót
HtmlOutput
– nowy obiekt HtmlOutput
,
Rzuty
Error
– jeśli pliku nie udało się znaleźć lub zawarty w nim kod HTML jest nieprawidłowy
createTemplate(blob)
Tworzy nowy obiekt HtmlTemplate
z zasobu BlobSource
.
function createFromBlob(blob) { var template = HtmlService.createTemplate(blob); return output; }
Parametry
Nazwa | Typ | Opis |
---|---|---|
blob | BlobSource | Obiekt, z którego ma zostać pobrany kod HTML. |
Powrót
HtmlTemplate
– nowy obiekt HtmlTemplate
,
Rzuty
Error
– jeśli obiekt blob nie zawiera kodu HTML,
createTemplate(html)
Tworzy nowy obiekt HtmlTemplate
, który może zostać zwrócony przez skrypt.
var template = HtmlService.createTemplate('<b>The time is <?= new Date() ?></b>');
Parametry
Nazwa | Typ | Opis |
---|---|---|
html | String | zawartość szablonu, |
Powrót
HtmlTemplate
– nowy obiekt HtmlTemplate
,
createTemplateFromFile(filename)
Tworzy nowy obiekt HtmlTemplate
z pliku w edytorze kodu.
var template = HtmlService.createTemplateFromFile('myTemplate');
Parametry
Nazwa | Typ | Opis |
---|---|---|
filename | String | nazwa pliku, którego chcesz użyć |
Powrót
HtmlTemplate
– nowy obiekt HtmlTemplate
,
Rzuty
Error
– jeśli plik nie został znaleziony;
getUserAgent()
Pobiera ciąg znaków klienta użytkownika dla bieżącej przeglądarki. Zwraca null
w przypadku większości skryptu
uruchomień, jeśli nie jest używana w funkcji doGet()
lub doPost()
aplikacji internetowej.
Powrót
String
– ciąg znaków klienta użytkownika;