Class HtmlService

HtmlService

Usługa zwracająca kod HTML i inną treść tekstową ze skryptu.

Ze względów bezpieczeństwa skrypty nie mogą bezpośrednio zwracać treści do przeglądarki. Muszą natomiast oczyścić kod HTML, aby nie mógł wykonywać złośliwych działań. W opisie HtmlOutput znajdziesz ograniczenia, które mogą być zwracane.

Właściwości

WłaściwośćTypOpis
SandboxModeSandboxModeWyliczenie reprezentujące tryby piaskownicy, które można używać w przypadku skryptów HtmlService po stronie klienta.
XFrameOptionsModeXFrameOptionsModeWyliczenie reprezentujące tryby X-Frame-Options, których można używać 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 ze skryptu.
createHtmlOutput(blob)HtmlOutputTworzy nowy obiekt HtmlOutput z zasobu BlobSource.
createHtmlOutput(html)HtmlOutputTworzy nowy obiekt HtmlOutput, który może zostać zwrócony 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że zostać zwrócony ze skryptu.
createTemplateFromFile(filename)HtmlTemplateTworzy nowy obiekt HtmlTemplate z pliku w edytorze kodu.
getUserAgent()StringPobiera ciąg klienta użytkownika dla bieżącej przeglądarki.

Szczegółowa dokumentacja

createHtmlOutput()

Tworzy nowy obiekt HtmlOutput, który może zostać zwrócony ze skryptu.

var output = HtmlService.createHtmlOutput();

Powroty

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 pobiera kod HTML

Powroty

HtmlOutput – nowy obiekt HtmlOutput,

Rzuty

Error – jeśli obiekt blob nie zawiera HTML lub kod HTML jest uszkodzony


createHtmlOutput(html)

Tworzy nowy obiekt HtmlOutput, który może zostać zwrócony ze skryptu.

var output = HtmlService.createHtmlOutput('<b>Hello world!</b>');

Parametry

NazwaTypOpis
htmlStringtreść do wyświetlenia

Powroty

HtmlOutput – nowy obiekt htmloutput,

Rzuty

Error – jeśli kod 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ć

Powroty

HtmlOutput – nowy obiekt HtmlOutput,

Rzuty

Error – jeśli nie udało się znaleźć pliku lub zawarty w nim kod HTML jest uszkodzony


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.

Powroty

HtmlTemplate – nowy obiekt HtmlTemplate,

Rzuty

Error – jeśli blob nie zawiera HTML


createTemplate(html)

Tworzy nowy obiekt HtmlTemplate, który może zostać zwrócony ze skryptu.

var template = HtmlService.createTemplate('<b>The time is &lt;?= new Date() ?&gt;</b>');

Parametry

NazwaTypOpis
htmlStringzawartość szablonu

Powroty

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ć

Powroty

HtmlTemplate – nowy obiekt HtmlTemplate,

Rzuty

Error – jeśli nie znaleziono pliku;


getUserAgent()

Pobiera ciąg klienta użytkownika dla bieżącej przeglądarki. Zwraca wartość null w przypadku większości wykonywania skryptu, jeśli nie jest używana w funkcji doGet() lub doPost() aplikacji internetowej.

Powroty

String – ciąg znaków klienta użytkownika,