Class HtmlService

HtmlService

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śćTypOpis
SandboxModeSandboxModeWyliczenie reprezentujące tryby piaskownicy, które mogą być używane na potrzeby funkcji HtmlService po stronie klienta skryptów.
XFrameOptionsModeXFrameOptionsModeWyliczenie reprezentujące tryby X-Frame-Options, które mogą być używane w przypadku skryptów HtmlService po stronie klienta.

Metody

MetodaZwracany typKrótki opis
createHtmlOutput()HtmlOutputTworzy nowy obiekt HtmlOutput, który może zostać zwrócony przez skrypt.
createHtmlOutput(blob)HtmlOutputTworzy nowy obiekt HtmlOutput z zasobu BlobSource.
createHtmlOutput(html)HtmlOutputTworzy nowy obiekt HtmlOutput, który może zostać zwrócony przez skrypt.
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że zostać zwrócony przez skrypt.
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.

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

NazwaTypOpis
blobBlobSourcez 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

NazwaTypOpis
htmlStringtreść, 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

NazwaTypOpis
filenameStringnazwa 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

NazwaTypOpis
blobBlobSourceObiekt, 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 &lt;?= new Date() ?&gt;</b>');

Parametry

NazwaTypOpis
htmlStringzawartość szablonu,

Powrót

HtmlTemplate – nowy obiekt HtmlTemplate,


createTemplateFromFile(filename)

Tworzy nowy obiekt HtmlTemplate z pliku w edytorze kodu.

var template = HtmlService.createTemplateFromFile('myTemplate');

Parametry

NazwaTypOpis
filenameStringnazwa 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;