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ść	Typ	Opis
SandboxMode	SandboxMode	Typ enumeracji reprezentujący tryby piaskownicy, które można stosować w przypadku skryptów po stronie klienta HtmlService
XFrameOptionsMode	XFrameOptionsMode	Typ enumeracji reprezentujący tryby X-Frame-Options, które można stosować w skryptach 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 na podstawie 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 na podstawie pliku w edytorze kodu.
createTemplate(blob)	HtmlTemplate	Tworzy nowy obiekt HtmlTemplate na podstawie 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 na podstawie pliku w edytorze kodu.
getUserAgent()	String	Pobiera 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

Nazwa	Typ	Opis
blob	BlobSource	obiekt, 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

Nazwa	Typ	Opis
html	String	treś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

Nazwa	Typ	Opis
filename	String	nazwa 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

Nazwa	Typ	Opis
blob	BlobSource	Obiekt, 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

Nazwa	Typ	Opis
html	String	zawartość 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

Nazwa	Typ	Opis
filename	String	nazwa 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