Widżet TextInput
udostępnia pole, w którym użytkownicy mogą wpisywać tekst. Widżet obsługuje sugestie, które pomagają użytkownikom wprowadzać jednolite dane, oraz działania związane ze zmianą, czyli Actions
wykonywane, gdy zmiana nastąpi w polu wprowadzania tekstu, np. użytkownik dodaje lub usuwa tekst.
Jeśli chcesz zbierać abstrakcyjne lub nieznane dane od użytkowników, używaj tego widżetu TextInput
. Aby zbierać zdefiniowane dane o użytkownikach, użyj widżetu SelectionInput
.
Informacje o przetwarzaniu tekstu wpisywanego przez użytkowników znajdziesz w sekcji Odbieranie danych z formularzy.
Oto karta składająca się z widżetu TextInput
:
Reprezentacja i pola w formacie JSON
Zapis JSON |
---|
{ "name": string, "label": string, "hintText": string, "value": string, "type": enum ( |
Pola | |
---|---|
name
|
Nazwa, po której dane wejściowe są identyfikowane w zdarzeniu danych wejściowych formularza. Szczegółowe informacje o pracy z danymi wejściowymi do formularzy znajdziesz w artykule Odbieranie danych z formularzy. |
label
|
Tekst wyświetlany nad polem do wprowadzania tekstu w interfejsie.
Wpisz tekst, który pomoże użytkownikowi wpisać informacje, których potrzebuje aplikacja. Jeśli np. pytasz kogoś o imię, a konkretnie nazwisko tej osoby, zamiast „
Wymagane, jeśli właściwość |
hintText
|
Tekst wyświetlany pod polem do wprowadzania tekstu, by pomóc użytkownikom, zachęcając ich do podania określonej wartości. Ten tekst jest zawsze widoczny.
Wymagane, jeśli właściwość |
value
|
Wartość wpisana przez użytkownika zwrócona w ramach zdarzenia wprowadzania danych w formularzu. Szczegółowe informacje o pracy z danymi wejściowymi do formularzy znajdziesz w artykule Odbieranie danych z formularzy. |
type
|
Sposób wyświetlania pola do wprowadzania tekstu w interfejsie. Na przykład czy pole jest jednowierszowe czy wielowierszowe. |
onChangeAction
|
Co zrobić, gdy zmiana nastąpi w polu wprowadzania tekstu. Na przykład dodanie użytkownika do pola lub usunięcie tekstu. Przykładowe działania, które należy wykonać, to uruchomienie funkcji niestandardowej lub otwarcie okna w Google Chat. |
initialSuggestions
|
Sugerowane wartości, które użytkownicy mogą wpisywać. Te wartości pojawiają się, gdy użytkownik kliknie w polu wprowadzania tekstu. Gdy użytkownicy wpisują treść, sugerowane wartości są dynamicznie filtrowane na podstawie wpisywanych przez nich informacji.
Na przykład w polu do wprowadzania tekstu w języku programowania mogą się znaleźć podpowiedzi dotyczące Javy, JavaScriptu, Pythona i C++. Gdy użytkownicy zaczną wpisywać
Sugerowane wartości pomagają zachęcać użytkowników do wpisywania wartości, które są zrozumiałe dla aplikacji. W odniesieniu do języka JavaScript niektórzy użytkownicy mogą wpisać
Jeśli jest określona, |
autoCompleteAction
|
Opcjonalnie. Określ czynność wykonywaną, gdy pole do wprowadzania tekstu zawiera sugestie użytkownikom, którzy z niego korzystają.
Jeśli nie określono inaczej, sugestie są ustawiane przez Jeśli zostanie określony, aplikacja wykona określone tutaj działanie, na przykład uruchomi funkcję niestandardową. Są obsługiwane przez dodatki do Google Workspace, ale nie przez aplikacje Google Chat. |
placeholderText
|
Tekst, który pojawia się w polu wprowadzania tekstu, gdy jest ono puste. Użyj tego tekstu, aby poprosić użytkowników o wpisanie wartości. Na przykład: Są obsługiwane przez aplikacje do Google Chat, ale nie przez dodatki do Google Workspace. |
Typ
Wartości w polu enum | |
---|---|
SINGLE_LINE
|
Pole do wprowadzania tekstu ma stałą wysokość 1 wiersza. |
MULTIPLE_LINE
|
Pole do wprowadzania tekstu ma stałą wysokość wielu wierszy. |
Działanie
Działanie opisujące zachowanie po przesłaniu formularza. Możesz na przykład wywołać skrypt Apps Script do obsługi formularza. W przypadku uruchomienia działania wartości formularza są wysyłane na serwer.
Zapis JSON |
---|
{ "function": string, "parameters": [ { object ( |
Pola | |
---|---|
function
|
Funkcja niestandardowa do wywołania po kliknięciu lub niewłaściwym aktywowaniu elementu zawierającego ten element. Przykład wykorzystania znajdziesz w artykule o tworzeniu kart interaktywnych. |
parameters[]
|
Lista parametrów działań. |
loadIndicator
|
Określa wskaźnik wczytywania, który wyświetla się podczas wysyłania wezwania do działania. |
persistValues
|
Wskazuje, czy wartości formularza pozostają po wykonaniu czynności. Wartością domyślną jest
Jeśli
Jeśli |
interaction
|
Opcjonalnie. Wymagane przy otwieraniu okna. Co zrobić w odpowiedzi na interakcję z użytkownikiem, np. kliknięcie przez niego przycisku w wiadomości na karcie.
Jeśli nie określono inaczej, aplikacja reaguje, wykonując
Dzięki określeniu Są obsługiwane przez aplikacje do obsługi czatu, ale nie przez dodatki do Google Workspace. Jeśli określisz dodatek, zostanie ona usunięta z całej karty i klient nie będzie niczego wyświetlać. |
ActionParameter
Lista parametrów ciągu znaków, które należy podać po wywołaniu metody działania. Rozważmy na przykład trzy przyciski drzemki: „Drzemka”, „Odłóż jeden dzień” i „Drzemka” w przyszłym tygodniu. Możesz użyć właściwości action method = snooze()
, która przekazuje typ drzemki i czas drzemki na liście parametrów ciągu znaków.
Więcej informacji: CommonEventObject
.
Zapis JSON |
---|
{ "key": string, "value": string } |
Pola | |
---|---|
key
|
Nazwa parametru skryptu działania. |
value
|
Wartość parametru. |
LoadIndicator
Określa wskaźnik wczytywania, który wyświetla się podczas wysyłania wezwania do działania.
Wartości w polu enum | |
---|---|
SPINNER
|
Ikona wczytywania oznacza, że zawartość się wczytuje. |
NONE
|
Nic nie jest wyświetlane. |
Interakcja
Opcjonalnie. Wymagane przy otwieraniu okna.
Co zrobić w odpowiedzi na interakcję z użytkownikiem, np. kliknięcie przez niego przycisku w wiadomości na karcie.
Jeśli nie określono inaczej, aplikacja reaguje, wykonując action
w zwykły sposób, np. otwierając link lub uruchamiając funkcję.
Dzięki określeniu interaction
aplikacja może reagować w specjalny interaktywny sposób. Jeśli na przykład ustawisz w interaction
wartość OPEN_DIALOG
, aplikacja będzie mogła otworzyć okno.
Jeśli podasz wartość, wskaźnik wczytywania się nie wyświetli.
Są obsługiwane przez aplikacje do obsługi czatu, ale nie przez dodatki do Google Workspace. Jeśli określisz dodatek, zostanie ona usunięta z całej karty i klient nie będzie niczego wyświetlać.
Wartości w polu enum | |
---|---|
INTERACTION_UNSPECIFIED
|
Wartość domyślna. action działa w zwykły sposób.
|
OPEN_DIALOG
|
Otwiera okno, czyli okno interfejsu z kartami, za pomocą którego aplikacje Google Chat mogą komunikować się z użytkownikami. Obsługiwane tylko przez aplikacje do obsługi czatu w odpowiedzi na kliknięcia przycisków w wiadomościach kart. Nieobsługiwane przez dodatki do Google Workspace. Jeśli określisz dodatek, zostanie ona usunięta z całej karty i klient nie będzie niczego wyświetlać. |
Sugestie
Zapis JSON |
---|
{
"items": [
{
object (
|
Pola | |
---|---|
items[]
|
Lista sugestii używanych na potrzeby rekomendacji autouzupełniania w polach do wprowadzania tekstu. |
SuggestionItem
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy
|
|
text
|
Wartość sugerowanej wartości wejściowej w polu do wprowadzania tekstu. Jest to odpowiednik haseł wpisywanych przez użytkowników. |
Rozwiązywanie problemów
Gdy aplikacja lub karta Google Chat zwróci błąd, w interfejsie czatu pojawi się komunikat „Coś poszło nie tak” lub „Nie udało się przetworzyć Twojego żądania”. Czasami w interfejsie Google Chat nie pojawia się żaden komunikat o błędzie, ale aplikacja lub karta Google Chat mogą dać nieoczekiwany wynik, na przykład komunikat na karcie.
Mimo że komunikat o błędzie może nie wyświetlić się w interfejsie Google Chat, dostępne są opisowe komunikaty o błędach i dane dziennika, które pomogą Ci naprawić błędy występujące po włączeniu rejestrowania błędów w aplikacjach do obsługi czatu. Więcej informacji o wyświetlaniu, debugowaniu i naprawianiu błędów znajdziesz w artykule Rozwiązywanie problemów z Google Chat i rozwiązywanie problemów.