Widżet TextInput
zawiera pole, w którym użytkownicy mogą wpisać tekst. Widżet obsługuje sugestie, które ułatwiają użytkownikom wpisywanie ujednoliconych danych, a także działania powodujące zmianę, czyli działania Actions
uruchamiane po wprowadzeniu zmiany w polu wprowadzania tekstu, np. dodanie lub usunięcie tekstu.
Jeśli chcesz zbierać abstrakcyjne lub nieznane dane użytkowników, używaj tego widżetu TextInput
. Aby zbierać określone dane od użytkowników, użyj widżetu SelectionInput
.
Aplikacje do obsługi czatu otrzymują i przetwarzają wartość wprowadzanego tekstu podczas zdarzeń w formularzu. Więcej informacji o korzystaniu z danych wejściowych formularza znajdziesz w artykule Odbieranie danych formularza.
Przykład
Poniższa ilustracja przedstawia kartę zawierającą widżet TextInput
.

TextInput
widżety.
Oto kod JSON karty:
JSON
{
"cardsV2": [
{
"cardId": "exampleCard",
"card": {
"sections": [
{
"header": "Add new contact",
"widgets": [
{
"textInput": {
"label": "Name",
"type": "SINGLE_LINE",
"name": "contactName"
}
},
{
"textInput": {
"label": "Address",
"type": "MULTIPLE_LINE",
"name": "address"
}
},
{
"decoratedText": {
"text": "Add to favorites",
"switchControl": {
"controlType": "SWITCH",
"name": "saveFavorite"
}
}
},
{
"decoratedText": {
"text": "Merge with existing contacts",
"switchControl": {
"controlType": "SWITCH",
"name": "mergeContact",
"selected": true
}
}
},
{
"buttonList": {
"buttons": [
{
"text": "Next",
"onClick": {
"action": {
"function": "openSequentialDialog"
}
}
}
]
}
}
]
}
]
}
}
]
}
Reprezentacja i pola JSON
Zapis JSON |
---|
{ "name": string, "label": string, "hintText": string, "value": string, "type": enum ( |
Pola | |
---|---|
name
|
Nazwa określająca dane wejściowe w zdarzeniu wprowadzania danych z formularza. Więcej informacji na temat pracy z danymi z formularzy znajdziesz w artykule Odbieranie danych formularza. |
label
|
Tekst wyświetlany nad polem wprowadzania tekstu w interfejsie.
Podaj tekst, który pomoże użytkownikowi wpisać informacje, których potrzebuje Twoja aplikacja. Jeśli na przykład prosisz kogoś o imię, ale potrzebujesz imienia, wpisz
Wymagany, jeśli właściwość |
hintText
|
Tekst wyświetlany pod polem wprowadzania tekstu, który ma zachęcić użytkowników do wpisania określonej wartości. Ten tekst jest zawsze widoczny.
Wymagany, jeśli właściwość |
value
|
Wartość wpisana przez użytkownika, zwracana w ramach zdarzenia wejściowego formularza. Więcej informacji na temat pracy z danymi z formularzy znajdziesz w artykule Odbieranie danych formularza. |
type
|
Sposób, w jaki w interfejsie wyświetlane jest pole do wprowadzania tekstu. np. czy pole jest jednowierszowe czy wielowierszowe. |
onChangeAction
|
Co zrobić, gdy w polu tekstowym pojawi się zmiana. Na przykład użytkownik dodający do pola lub usuwając tekst. Przykładowe działania to uruchomienie własnej funkcji lub otwarcie okna w Google Chat. |
initialSuggestions
|
Sugerowane wartości, które użytkownicy mogą wpisać. Te wartości pojawiają się, gdy użytkownicy klikają pole do wprowadzania tekstu. Gdy użytkownicy piszą, sugerowane wartości są dynamicznie filtrowane zgodnie z wpisanym tekstem.
Na przykład pole do wprowadzania tekstu w języku programowania może proponować język Java, JavaScript, Python i C++. Gdy użytkownicy zaczną wpisywać
Sugerowane wartości pomagają użytkownikom wpisywać wartości, które mogą być przydatne w aplikacji. Gdy odwołujemy się do JavaScriptu, niektórzy użytkownicy mogą wpisać
Jeśli zasada jest określona, właściwość |
autoCompleteAction
|
Opcjonalnie. Określ, jakie działania mają być wykonywane, gdy pole do wprowadzania tekstu zawiera sugestie dla użytkowników, którzy z niego korzystają.
Jeśli nie określono inaczej, sugestie są ustawiane przez zasadę Jeśli zasada jest skonfigurowana, aplikacja wykonuje opisane tu działanie, takie jak uruchamianie funkcji niestandardowej. Obsługiwana przez dodatki do Google Workspace, ale nie przez aplikacje Google Chat. |
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. |
Czynność
Działanie opisujące zachowanie podczas przesyłania formularza. Możesz na przykład wywołać skrypt Apps Script, aby obsłużyć formularz. Jeśli działanie zostanie aktywowane, wartości formularza zostaną przesłane na serwer.
Zapis JSON |
---|
{ "function": string, "parameters": [ { object ( |
Pola | |
---|---|
function
|
Funkcja niestandardowa, która ma być wywoływana po kliknięciu lub aktywowaniu elementu zawierającego. Więcej informacji znajdziesz w artykule Tworzenie interaktywnych kart. |
parameters[]
|
Lista parametrów działania. |
loadIndicator
|
Określa wskaźnik wczytywania wyświetlany podczas wykonywania działania. |
persistValues
|
Wskazuje, czy po formularzu działanie formularza pozostaje aktywne. Wartością domyślną jest
Jeśli pole
Jeśli |
interaction
|
Opcjonalnie. Wymagane przy otwieraniu okna. Co zrobić w odpowiedzi na interakcję użytkownika, np. kliknięcie przycisku w wiadomości na karcie.
Jeśli nie określono inaczej, aplikacja reaguje w zwykły sposób, uruchamiając
Jeśli określisz Obsługiwane przez aplikacje do obsługi czatu, ale nie w ramach dodatków do Google Workspace. Jeśli dodatek jest określony jako dodatek, cała karta jest usuwana i nic nie jest wyświetlane w kliencie. |
Parametr działania
Lista parametrów ciągu znaków, które mają zostać podane po wywołaniu metody działania. Możesz np. wybrać 3 przyciski drzemki: drzemka teraz, drzemka na dzień lub drzemkę w przyszłym tygodniu. Można użyć właściwości action method = snooze()
, przekazując 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. |
Wskaźnik obciążenia
Określa wskaźnik wczytywania wyświetlany podczas wykonywania działania.
Wartości w polu enum | |
---|---|
SPINNER
|
Wyświetla wskaźnik postępu wczytywania treści. |
NONE
|
Nic nie jest wyświetlane. |
Interakcja
Opcjonalnie. Wymagane przy otwieraniu okna.
Co zrobić w odpowiedzi na interakcję użytkownika, np. kliknięcie przycisku w wiadomości na karcie.
Jeśli nie określono inaczej, aplikacja reaguje w zwykły sposób, uruchamiając action
, np. otwierając link lub uruchamiając funkcję.
Jeśli określisz interaction
, aplikacja może reagować w specjalny sposób. Jeśli na przykład ustawisz interaction
na wartość OPEN_DIALOG
, aplikacja będzie mogła otwierać okno.
Jeśli podasz wartość, wskaźnik ładowania się nie wyświetli.
Obsługiwane przez aplikacje do obsługi czatu, ale nie w ramach dodatków do Google Workspace. Jeśli dodatek jest określony jako dodatek, cała karta jest usuwana i nic nie jest wyświetlane w kliencie.
Wartości w polu enum | |
---|---|
INTERACTION_UNSPECIFIED
|
Wartość domyślna. action działa normalnie.
|
OPEN_DIALOG
|
Otwiera okno – interfejs użytkownika w postaci okna, który umożliwia aplikacjom Google Chat interakcję z użytkownikami. Obsługiwane tylko przez aplikacje do obsługi czatu w odpowiedzi na kliknięcie przycisku na karcie. Nieobsługiwane przez dodatki do Google Workspace. Jeśli dodatek jest określony jako dodatek, cała karta jest usuwana i nic nie jest wyświetlane w kliencie. |
Sugestie
Zapis JSON |
---|
{
"items": [
{
object (
|
Pola | |
---|---|
items[]
|
Lista sugestii używanych do autouzupełniania rekomendacji w polach wprowadzania tekstu. |
Sugestia elementu
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy:
|
|
text
|
Wartość sugerowanego pola wprowadzania tekstu. Jest to odpowiednik tekstu wpisanego przez użytkownika. |