تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class TextInput

تطبيق مصغّر لحقل إدخال يقبل إدخال النص

متاحة لإضافات 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)`

تحدِّد هذه السياسة إجراءً ليتم تنفيذه كلما تغيّر إدخال النص.

المَعلمات

الاسم	النوع	الوصف
`action`	`Action`	الإجراء المطلوب اتخاذه.

استرجاع الكرة

TextInput: هذا الكائن، للتسلسل.

`setSuggestions(suggestions)`

لضبط اقتراحات الإكمال التلقائي في حقل النص.

المَعلمات

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

استرجاع الكرة

TextInput: هذا الكائن، للتسلسل.

`setSuggestionsAction(suggestionsAction)`

لضبط إجراء معاودة الاتصال لجلب الاقتراحات استنادًا إلى البيانات التي يُدخلها المستخدم للإكمال التلقائي. يجب أن تحدّد المَعلَمة Action دالة استدعاء تُرجع كائن 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: هذا الكائن، للتسلسل.