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ą odkażać kod HTML, aby nie mógł wykonywać szkodliwych działań. Zapoznaj się z opisem HtmlOutput, aby dowiedzieć się, jakie ograniczenia dotyczą zwracanych produktów.

Właściwości

WłaściwośćTypOpis
SandboxModeSandboxModeTyp enumeracji reprezentujący tryby piaskownicy, które można stosować w przypadku skryptów po stronie klienta HtmlService
XFrameOptionsModeXFrameOptionsModeTyp enumeracji reprezentujący tryby X-Frame-Options, które można stosować w skryptach 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 na podstawie zasobu BlobSource.
createHtmlOutput(html)HtmlOutputTworzy nowy obiekt HtmlOutput, który może zostać zwrócony przez skrypt.
createHtmlOutputFromFile(filename)HtmlOutputTworzy nowy obiekt HtmlOutput na podstawie pliku w edytorze kodu.
createTemplate(blob)HtmlTemplateTworzy nowy obiekt HtmlTemplate na podstawie zasobu BlobSource.
createTemplate(html)HtmlTemplateTworzy nowy obiekt HtmlTemplate, który może zostać zwrócony przez skrypt.
createTemplateFromFile(filename)HtmlTemplateTworzy nowy obiekt HtmlTemplate na podstawie pliku w edytorze kodu.
getUserAgent()StringPobiera ciąg znaków klienta użytkownika w przypadku bieżącej przeglądarki.

Szczegółowa dokumentacja

createHtmlOutput()

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

const output = HtmlService.createHtmlOutput();

Powrót

HtmlOutput – nowy obiekt HtmlOutput

createHtmlOutput(blob)

Tworzy nowy obiekt HtmlOutput na podstawie zasobu BlobSource. 

function createFromBlob(blob) {
  const output = HtmlService.createHtmlOutput(blob);
  return output;
}

Parametry

NazwaTypOpis
blobBlobSourceobiekt, z którego chcesz pobrać kod HTML;

Powrót

HtmlOutput – nowy obiekt HtmlOutput,

Rzuty

Error – jeśli blob nie zawiera kodu HTML lub kod HTML jest błędnie sformatowany.

createHtmlOutput(html)

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

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

Parametry

NazwaTypOpis
htmlStringtreści do wyświetlenia;

Powrót

HtmlOutput – nowy obiekt HtmlOutput

Rzuty

Error – jeśli kod HTML jest nieprawidłowy

createHtmlOutputFromFile(filename)

Tworzy nowy obiekt HtmlOutput na podstawie pliku w edytorze kodu. 

const output = HtmlService.createHtmlOutputFromFile('myPage');

Parametry

NazwaTypOpis
filenameStringnazwa pliku do użycia.

Powrót

HtmlOutput – nowy obiekt HtmlOutput,

Rzuty

Error – jeśli plik nie został znaleziony lub kod HTML jest nieprawidłowy

createTemplate(blob)

Tworzy nowy obiekt HtmlTemplate na podstawie zasobu BlobSource. 

function createFromBlob(blob) {
  const template = HtmlService.createTemplate(blob);
  const output = template.evaluate();
  return output;
}

Parametry

NazwaTypOpis
blobBlobSourceObiekt, z którego ma zostać wyodrębniony kod HTML.

Powrót

HtmlTemplate – nowy obiekt HtmlTemplate,

Rzuty

Error – jeśli blob nie zawiera kodu HTML,

createTemplate(html)

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

const 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 na podstawie pliku w edytorze kodu. 

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

Parametry

NazwaTypOpis
filenameStringnazwa pliku do użycia.

Powrót

HtmlTemplate – nowy obiekt HtmlTemplate,

Rzuty

Error – jeśli plik nie został znaleziony

getUserAgent()

Pobiera ciąg znaków klienta użytkownika w przypadku bieżącej przeglądarki. Zwraca wartość null w przypadku większości wywołań skryptu, jeśli nie jest używany w funkcji doGet() lub doPost() aplikacji internetowej.

Powrót

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