تمت ترجمة هذه الصفحة بواسطة 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 — هذا العنصر، للتسلسل.