أداة حقل إدخال تقبل إدخال النص.
يتيح التحقّق من صحة عمليات إرسال النماذج. عند ضبط Action.setAllWidgetsAreRequired(allWidgetsAreRequired) على true أو تحديد هذه الأداة من خلال Action.addRequiredWidget(requiredWidget)، يتم حظر إجراء الإرسال ما لم يتم إدخال قيمة.
متاحة لإضافات Google Workspace وتطبيقات Google Chat.
const textInput = CardService.newTextInput() .setFieldName('text_input_form_input_key') .setTitle('Text input title') .setHint('Text input hint');
الطُرق
| الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
|---|---|---|
set | Text | تضبط هذه السمة المفتاح الذي يحدّد إدخال النص هذا في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل مع واجهة المستخدم. |
set | Text | تضبط هذه السمة تلميحًا لإدخال النص. |
set | Text | تضبط هذه السمة مصدر بيانات من تطبيقات Google Workspace. |
set | Text | تحديد ما إذا كان النص المُدخَل يظهر في سطر واحد أو عدة أسطر |
set | Text | تضبط هذه السمة إجراءً يتم تنفيذه كلما تغيّر النص المُدخَل. |
set | Text | تضبط هذه السمة الاقتراحات الخاصة بالإكمال التلقائي في حقل النص. |
set | Text | تضبط هذه السمة إجراء معاودة الاتصال لجلب الاقتراحات استنادًا إلى إدخال المستخدم للإكمال التلقائي. |
set | Text | تضبط هذه السمة العنوان المطلوب عرضه فوق حقل الإدخال. |
set | Text | تضبط هذه السمة قاعدة التحقّق من الصحة لهذا التطبيق المصغّر. |
set | Text | تضبط هذه السمة القيمة التي سيتم ملؤها مسبقًا في حقل الإدخال. |
مستندات تفصيلية
set Field Name(fieldName)
تضبط هذه السمة المفتاح الذي يحدّد إدخال النص هذا في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل مع واجهة المستخدم. لا يظهر للمستخدم. مطلوب، ويجب أن يكون فريدًا.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
field | String | المفتاح المستخدَم لتحديد هذا الإدخال. |
الإرجاع
Text: هذا العنصر، للتسلسل
set Hint(hint)
تضبط هذه السمة تلميحًا لإدخال النص. تُستخدَم لتزويد المستخدم بإرشادات إضافية حول ما يجب إدخاله. على سبيل المثال، يمكن أن يصف تلميح التنسيق ("xxx-xxx-xxxx") لحقل رقم الهاتف.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
hint | String | تلميح النص المطلوب عرضه أسفل حقل الإدخال يظهر هذا النص دائمًا. |
الإرجاع
Text: هذا العنصر، للتسلسل
set Host App Data Source(hostAppDataSource)
تضبط هذه السمة مصدر بيانات من تطبيقات Google Workspace. يتوافق حاليًا مع المستخدمين ومساحات Chat.
متاحة فقط من خلال برنامج Gemini Alpha لإضافات Google Workspace التي توسّع نطاق استخدام Google Workspace Flows.
const workflowDataSource = CardService.newWorkflowDataSource().setIncludeVariables(true); const hostAppDataSource = CardService.newHostAppDataSource().setWorkflowDataSource(workflowDataSource); const textInput = CardService.newTextInput() .setFieldName('text_input_form_input_key') .setTitle('Text input title') .setHint('Text input hint') .setHostAppDataSource(hostAppDataSource);
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
host | Host | مصدر البيانات |
الإرجاع
Text: هذا العنصر، للتسلسل
set Multiline(multiline)
تحديد ما إذا كان النص المُدخَل يظهر في سطر واحد أو عدة أسطر
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
multiline | Boolean | إعداد الأسطر المتعددة |
الإرجاع
Text: هذا العنصر، للتسلسل
set On Change Action(action)
set Suggestions(suggestions)
تضبط هذه السمة الاقتراحات الخاصة بالإكمال التلقائي في حقل النص.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
suggestions | Suggestions | مجموعة الاقتراحات التي يمكن استخدامها |
الإرجاع
Text: هذا العنصر، للتسلسل
set Suggestions Action(suggestionsAction)
تضبط هذه السمة إجراء معاودة الاتصال لجلب الاقتراحات استنادًا إلى إدخال المستخدم للإكمال التلقائي. يجب أن تحدّد المَعلمة Action دالة ردّ اتصال تعرض عنصر Suggestions.
const action = CardService.newAction() .setFunctionName('suggestionCallback') .setParameters({numSuggestions: 3}); CardService.newTextInput() .setFieldName('option-field') .setTitle('Option Selected') .setSuggestionsAction(action); // ... function suggestionCallback(e) { const suggestions = CardService.newSuggestions(); const numSuggestions = Number.parseInt(e.parameter.numSuggestions); for (let i = 1; i <= numSuggestions; i++) { suggestions.addSuggestion(`Suggestion ${i}`); } return CardService.newSuggestionsResponseBuilder() .setSuggestions(suggestions) .build(); }
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
suggestions | Action | الإجراء الذي يسترد اقتراحات لهذا الإدخال. |
الإرجاع
Text: هذا العنصر، للتسلسل
set Title(title)
تضبط هذه السمة العنوان المطلوب عرضه فوق حقل الإدخال. الحقل مطلوب.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
title | String | تمثّل هذه السمة التصنيف النصي لعنصر الإدخال هذا. |
الإرجاع
Text: هذا العنصر، للتسلسل
set Validation(validation)
تضبط هذه السمة قاعدة التحقّق من الصحة لهذا التطبيق المصغّر.
const validation = CardService.newValidation().setCharacterLimit('10').setType( CardService.InputType.TEXT); const input = CardService.newTextInput() .setFieldName('text_name_xxx1') .setTitle('Max 10 characters') .setValidation(validation);
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
validation | Validation | قاعدة التحقّق من الصحة لعنصر واجهة المستخدم Text هذا |
الإرجاع
Text: هذا العنصر، للتسلسل
set Value(value)
تضبط هذه السمة القيمة التي سيتم ملؤها مسبقًا في حقل الإدخال.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
value | String | القيمة التلقائية التي يتم وضعها في حقل الإدخال ويتم تمثيله دائمًا كسلسلة في مَعلمات معاودة الاتصال الخاصة بالنموذج. |
الإرجاع
Text: هذا العنصر، للتسلسل