Class TextInput

إدخالالنص

أداة حقل إدخال تقبل إدخال النص.

يتيح التحقّق من صحة عمليات إرسال النماذج. عند ضبط 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');

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
setFieldName(fieldName)TextInputتضبط هذه السمة المفتاح الذي يحدّد إدخال النص هذا في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل مع واجهة المستخدم.
setHint(hint)TextInputتضبط هذه السمة تلميحًا لإدخال النص.
setHostAppDataSource(hostAppDataSource)TextInputتضبط هذه السمة مصدر بيانات من تطبيقات Google Workspace.
setMultiline(multiline)TextInputتحديد ما إذا كان النص المُدخَل يظهر في سطر واحد أو عدة أسطر
setOnChangeAction(action)TextInputتضبط هذه السمة إجراءً يتم تنفيذه كلما تغيّر النص المُدخَل.
setSuggestions(suggestions)TextInputتضبط هذه السمة الاقتراحات الخاصة بالإكمال التلقائي في حقل النص.
setSuggestionsAction(suggestionsAction)TextInputتضبط هذه السمة إجراء معاودة الاتصال لجلب الاقتراحات استنادًا إلى إدخال المستخدم للإكمال التلقائي.
setTitle(title)TextInputتضبط هذه السمة العنوان المطلوب عرضه فوق حقل الإدخال.
setValidation(validation)TextInputتضبط هذه السمة قاعدة التحقّق من الصحة لهذا التطبيق المصغّر.
setValue(value)TextInputتضبط هذه السمة القيمة التي سيتم ملؤها مسبقًا في حقل الإدخال.

مستندات تفصيلية

setFieldName(fieldName)

تضبط هذه السمة المفتاح الذي يحدّد إدخال النص هذا في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل مع واجهة المستخدم. لا يظهر للمستخدم. مطلوب، ويجب أن يكون فريدًا.

المعلمات

الاسمالنوعالوصف
fieldNameStringالمفتاح المستخدَم لتحديد هذا الإدخال.

الإرجاع

TextInput: هذا العنصر، للتسلسل


setHint(hint)

تضبط هذه السمة تلميحًا لإدخال النص. تُستخدَم لتزويد المستخدم بإرشادات إضافية حول ما يجب إدخاله. على سبيل المثال، يمكن أن يصف تلميح التنسيق ("xxx-xxx-xxxx") لحقل رقم الهاتف.

المعلمات

الاسمالنوعالوصف
hintStringتلميح النص المطلوب عرضه أسفل حقل الإدخال يظهر هذا النص دائمًا.

الإرجاع

TextInput: هذا العنصر، للتسلسل


setHostAppDataSource(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);

المعلمات

الاسمالنوعالوصف
hostAppDataSourceHostAppDataSourceمصدر البيانات

الإرجاع

TextInput: هذا العنصر، للتسلسل


setMultiline(multiline)

تحديد ما إذا كان النص المُدخَل يظهر في سطر واحد أو عدة أسطر

المعلمات

الاسمالنوعالوصف
multilineBooleanإعداد الأسطر المتعددة

الإرجاع

TextInput: هذا العنصر، للتسلسل


setOnChangeAction(action)

تضبط هذه السمة إجراءً يتم تنفيذه كلما تغيّر النص المُدخَل.

المعلمات

الاسمالنوعالوصف
actionActionالإجراء المطلوب اتّخاذه

الإرجاع

TextInput: هذا العنصر، للتسلسل


setSuggestions(suggestions)

تضبط هذه السمة الاقتراحات الخاصة بالإكمال التلقائي في حقل النص.

المعلمات

الاسمالنوعالوصف
suggestionsSuggestionsمجموعة الاقتراحات التي يمكن استخدامها

الإرجاع

TextInput: هذا العنصر، للتسلسل


setSuggestionsAction(suggestionsAction)

تضبط هذه السمة إجراء معاودة الاتصال لجلب الاقتراحات استنادًا إلى إدخال المستخدم للإكمال التلقائي. يجب أن تحدّد المَعلمة Action دالة ردّ اتصال تعرض عنصر SuggestionsResponse.

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();
}

المعلمات

الاسمالنوعالوصف
suggestionsActionActionالإجراء الذي يسترد اقتراحات لهذا الإدخال.

الإرجاع

TextInput: هذا العنصر، للتسلسل


setTitle(title)

تضبط هذه السمة العنوان المطلوب عرضه فوق حقل الإدخال. الحقل مطلوب.

المعلمات

الاسمالنوعالوصف
titleStringتمثّل هذه السمة التصنيف النصي لعنصر الإدخال هذا.

الإرجاع

TextInput: هذا العنصر، للتسلسل


setValidation(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);

المعلمات

الاسمالنوعالوصف
validationValidationقاعدة التحقّق من الصحة لعنصر واجهة المستخدم TextInput هذا

الإرجاع

TextInput: هذا العنصر، للتسلسل


setValue(value)

تضبط هذه السمة القيمة التي سيتم ملؤها مسبقًا في حقل الإدخال.

المعلمات

الاسمالنوعالوصف
valueStringالقيمة التلقائية التي يتم وضعها في حقل الإدخال ويتم تمثيله دائمًا كسلسلة في مَعلمات معاودة الاتصال الخاصة بالنموذج.

الإرجاع

TextInput: هذا العنصر، للتسلسل