ویجت فیلد ورودی که ورودی متن را می پذیرد.
برای افزونههای Google Workspace و برنامههای Google Chat موجود است.
var textInput = CardService.newTextInput() .setFieldName("text_input_form_input_key") .setTitle("Text input title") .setHint("Text input hint");
روش | نوع برگشت | شرح مختصر |
---|---|---|
setFieldName(fieldName) | TextInput | کلیدی را تنظیم می کند که این ورودی متن را در شی رویدادی که در هنگام وجود تعامل رابط کاربری ایجاد می شود، مشخص می کند. |
setHint(hint) | TextInput | یک راهنمایی برای ورودی متن تنظیم می کند. |
setMultiline(multiline) | TextInput | تنظیم می کند که متن ورودی در یک خط یا چند خط نشان داده شود. |
setOnChangeAction(action) | TextInput | یک عمل را تنظیم می کند تا هر زمان که ورودی متن تغییر کند، انجام شود. |
setSuggestions(suggestions) | TextInput | پیشنهادات تکمیل خودکار را در قسمت متن تنظیم می کند. |
setSuggestionsAction(suggestionsAction) | TextInput | عملکرد برگشت به تماس را برای واکشی پیشنهادات بر اساس ورودی کاربر برای تکمیل خودکار تنظیم میکند. |
setTitle(title) | TextInput | عنوان را تنظیم می کند که در بالای فیلد ورودی نشان داده شود. |
setValue(value) | TextInput | مقدار از پیش پر شده را برای تنظیم در قسمت ورودی تنظیم می کند. |
setFieldName(fieldName)
کلیدی را تنظیم می کند که این ورودی متن را در شی رویدادی که در هنگام وجود تعامل رابط کاربری ایجاد می شود، مشخص می کند. برای کاربر قابل مشاهده نیست. الزامی، باید منحصر به فرد باشد.
نام | تایپ کنید | توضیحات |
---|---|---|
fieldName | String | کلیدی که برای شناسایی این ورودی استفاده می شود. |
TextInput
- این شیء، برای زنجیر کردن.
setHint(hint)
یک راهنمایی برای ورودی متن تنظیم می کند. برای راهنمایی بیشتر کاربر در مورد آنچه باید وارد شود استفاده می شود. به عنوان مثال، یک راهنمایی می تواند قالب بندی ("xxx-xxx-xxxx") را برای فیلد شماره تلفن توصیف کند.
نام | تایپ کنید | توضیحات |
---|---|---|
hint | String | راهنمایی متن برای نمایش در زیر فیلد ورودی. این متن همیشه قابل مشاهده است. |
TextInput
- این شی، برای زنجیرهبندی.
setMultiline(multiline)
تنظیم می کند که متن ورودی در یک خط یا چند خط نشان داده شود.
نام | تایپ کنید | توضیحات |
---|---|---|
multiline | Boolean | تنظیم چند خطی |
TextInput
- این شیء، برای زنجیر کردن.
setOnChangeAction(action)
setSuggestions(suggestions)
پیشنهادات تکمیل خودکار را در قسمت متن تنظیم می کند.
نام | تایپ کنید | توضیحات |
---|---|---|
suggestions | Suggestions | مجموعه پیشنهادات برای استفاده |
TextInput
- این شیء، برای زنجیر کردن.
setSuggestionsAction(suggestionsAction)
عملکرد برگشت به تماس را برای واکشی پیشنهادات بر اساس ورودی کاربر برای تکمیل خودکار تنظیم میکند. پارامتر Action
باید تابع callback را مشخص کند که یک شیء SuggestionsResponse
را برمی گرداند.
var action = CardService.newAction() .setFunctionName('suggestionCallback') .setParameters({'numSuggestions': 3}); CardService.newTextInput() .setFieldName('option-field') .setTitle('Option Selected') .setSuggestionsAction(action); // ... function suggestionCallback(e) { var suggestions = CardService.newSuggestions(); var numSuggestions = parseInt(e.parameter['numSuggestions']); for(var i = 1; i <= numSuggestions; i++) { suggestions.addSuggestion('Suggestion ' + i); } return CardService.newSuggestionsResponseBuilder() .setSuggestions(suggestions) .build(); }
نام | تایپ کنید | توضیحات |
---|---|---|
suggestionsAction | Action | اقدامی که پیشنهادهایی را برای این ورودی واکشی میکند. |
TextInput
- این شیء، برای زنجیر کردن.
setTitle(title)
عنوان را تنظیم می کند که در بالای فیلد ورودی نشان داده شود. مورد نیاز.
نام | تایپ کنید | توضیحات |
---|---|---|
title | String | برچسب متنی برای این ورودی. |
TextInput
- این شیء، برای زنجیر کردن.
setValue(value)
مقدار از پیش پر شده را برای تنظیم در قسمت ورودی تنظیم می کند.
نام | تایپ کنید | توضیحات |
---|---|---|
value | String | مقدار پیش فرض قرار داده شده در ورودی. همیشه به عنوان یک رشته در پارامترهای پاسخ به تماس نشان داده می شود. |
TextInput
- این شیء، برای زنجیر کردن.