Class TextInput

টেক্সট ইনপুট

একটি ইনপুট ফিল্ড উইজেট যা টেক্সট ইনপুট গ্রহণ করে।

ফর্ম জমা দেওয়ার বৈধতা যাচাই সমর্থন করে। যখন Action.setAllWidgetsAreRequired(allWidgetsAreRequired) true সেট করা হয় অথবা Action.addRequiredWidget(requiredWidget) এর মাধ্যমে এই উইজেটটি নির্দিষ্ট করা হয়, তখন কোনো মান প্রবেশ না করা পর্যন্ত জমা দেওয়ার প্রক্রিয়াটি অবরুদ্ধ থাকে।

গুগল ওয়ার্কস্পেস অ্যাড-অন এবং গুগল চ্যাট অ্যাপের জন্য উপলব্ধ।

const textInput = CardService.newTextInput()
                      .setFieldName('text_input_form_input_key')
                      .setTitle('Text input title')
                      .setHint('Text input hint');

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
add Event Action(eventAction) Widget উইজেটটিতে সম্পাদনযোগ্য ইভেন্ট অ্যাকশনটি যোগ করে।
set Field Name(fieldName) Text Input UI ইন্টারঅ্যাকশনের ফলে যে ইভেন্ট অবজেক্টটি তৈরি হয়, তাতে এই টেক্সট ইনপুটটিকে শনাক্তকারী কী (key) সেট করে।
set Hint(hint) Text Input টেক্সট ইনপুটের জন্য একটি ইঙ্গিত সেট করে।
set Host App Data Source(hostAppDataSource) Text Input গুগল ওয়ার্কস্পেস অ্যাপ্লিকেশনগুলো থেকে একটি ডেটা উৎস নির্ধারণ করে।
set Id(id) Widget যে উইজেটটি পরিবর্তন করা হবে, সেটিকে শনাক্ত করার জন্য নির্ধারিত অনন্য আইডি সেট করে।
set Input Mode(inputMode) Text Input এই টেক্সট ইনপুট ফিল্ডটি ভেরিয়েবল সন্নিবেশ সমর্থন করে কিনা তা নির্ধারণ করে।
set Multiline(multiline) Text Input ইনপুট করা টেক্সট এক লাইনে নাকি একাধিক লাইনে প্রদর্শিত হবে তা নির্ধারণ করে।
set On Change Action(action) Text Input টেক্সট ইনপুট পরিবর্তিত হলে যে কাজটি করা হবে, তা নির্ধারণ করে।
set Suggestions(suggestions) Text Input টেক্সট ফিল্ডে স্বয়ংক্রিয়ভাবে পূরণের জন্য সাজেশনগুলো সেট করে।
set Suggestions Action(suggestionsAction) Text Input স্বয়ংক্রিয়ভাবে সম্পূর্ণ করার জন্য ব্যবহারকারীর ইনপুটের ভিত্তিতে সাজেশন আনার কলব্যাক অ্যাকশন নির্ধারণ করে।
set Title(title) Text Input ইনপুট ফিল্ডের উপরে প্রদর্শিত হওয়ার জন্য শিরোনাম নির্ধারণ করে।
set Validation(validation) Text Input এই উইজেটের জন্য যাচাইকরণ নিয়ম নির্ধারণ করে।
set Value(value) Text Input ইনপুট ফিল্ডে সেট করার জন্য আগে থেকে পূরণ করা মান নির্ধারণ করে।
set Visibility(visibility) Widget উইজেটটির দৃশ্যমানতা নির্ধারণ করে।

বিস্তারিত ডকুমেন্টেশন

addEventAction(eventAction)

উইজেটটিতে সম্পাদনযোগ্য ইভেন্ট অ্যাকশনটি যোগ করে।

প্যারামিটার

নাম প্রকার বর্ণনা
event Action Event Action Event Action যোগ করা হবে।

ফেরত

Widget — শৃঙ্খলিত করার জন্য ব্যবহৃত অবজেক্ট।


setFieldName(fieldName)

UI ইন্টারঅ্যাকশনের ফলে যে ইভেন্ট অবজেক্টটি তৈরি হয়, সেখানে এই টেক্সট ইনপুটটিকে শনাক্তকারী কী (key) সেট করে। এটি ব্যবহারকারীর কাছে দৃশ্যমান নয়। আবশ্যক এবং অবশ্যই অনন্য হতে হবে।

প্যারামিটার

নাম প্রকার বর্ণনা
field Name String এই ইনপুটটি শনাক্ত করতে যে কী-টি ব্যবহার করা হয়।

ফেরত

TextInput — এটি একটি অবজেক্ট, যা চেইনিংয়ের জন্য ব্যবহৃত হয়।


setHint(hint)

টেক্সট ইনপুটের জন্য একটি ইঙ্গিত সেট করে। ব্যবহারকারীকে কী ইনপুট করতে হবে সে সম্পর্কে অতিরিক্ত নির্দেশনা দিতে এটি ব্যবহৃত হয়। উদাহরণস্বরূপ, একটি ফোন নম্বর ফিল্ডের জন্য ইঙ্গিতটি ফরম্যাটিং ("xxx-xxx-xxxx") বর্ণনা করতে পারে।

প্যারামিটার

নাম প্রকার বর্ণনা
hint String ইনপুট ফিল্ডের নিচে প্রদর্শিত হওয়ার জন্য টেক্সট হিন্ট। এই লেখাটি সর্বদা দৃশ্যমান থাকে।

ফেরত

TextInput — এটি একটি অবজেক্ট, যা চেইনিংয়ের জন্য ব্যবহৃত হয়।


setHostAppDataSource(hostAppDataSource)

গুগল ওয়ার্কস্পেস অ্যাপ্লিকেশন থেকে একটি ডেটা উৎস নির্ধারণ করে। বর্তমানে ব্যবহারকারী এবং চ্যাট স্পেস সমর্থন করে।

শুধুমাত্র সেইসব Google Workspace অ্যাড-অনের জন্য উপলব্ধ, যেগুলো Google Workspace Studio-এর পরিধি বৃদ্ধি করে।

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 App Data Source Host App Data Source তথ্যের উৎস।

ফেরত

TextInput — এটি একটি অবজেক্ট, যা চেইনিংয়ের জন্য ব্যবহৃত হয়।


setId(id)

যে উইজেটটি পরিবর্তন করা হবে, সেটিকে শনাক্ত করার জন্য একটি অনন্য আইডি নির্ধারণ করে। উইজেট পরিবর্তন শুধুমাত্র অ্যাড-অন-এ সমর্থিত।

প্যারামিটার

নাম প্রকার বর্ণনা
id String উইজেটের আইডি, যা সর্বোচ্চ ৬৪ অক্ষরের হতে হবে এবং এর ফরম্যাট হবে `[a-zA-Z0-9-]+`।

ফেরত

Widget — এই অবজেক্টটি, চেইন করার জন্য ব্যবহৃত হয়।


setInputMode(inputMode)

এই টেক্সট ইনপুট ফিল্ডটি ভেরিয়েবল সন্নিবেশ সমর্থন করে কিনা তা নির্ধারণ করে।

শুধুমাত্র সেইসব Google Workspace অ্যাড-অনের জন্য উপলব্ধ, যেগুলো Google Workspace Studio-এর পরিধি বৃদ্ধি করে।

const textInput = CardService.newTextInput()
                      .setFieldName('text_input_form_input_key')
                      .setTitle('Text input title')
                      .setInputMode(CardService.TextInputMode.PLAIN_TEXT);

প্যারামিটার

নাম প্রকার বর্ণনা
input Mode Text Input Mode এই টেক্সট ইনপুট ফিল্ডের জন্য অনুমোদিত ইনপুটের ধরণ হলো RICH_TEXT, যা ভ্যারিয়েবল সন্নিবেশ সমর্থন করে।

ফেরত

TextInput — এটি একটি অবজেক্ট, যা চেইনিংয়ের জন্য ব্যবহৃত হয়।


setMultiline(multiline)

ইনপুট করা টেক্সট এক লাইনে নাকি একাধিক লাইনে প্রদর্শিত হবে তা নির্ধারণ করে।

প্যারামিটার

নাম প্রকার বর্ণনা
multiline Boolean মাল্টিলাইন সেটিং।

ফেরত

TextInput — এটি একটি অবজেক্ট, যা চেইনিংয়ের জন্য ব্যবহৃত হয়।


setOnChangeAction(action)

টেক্সট ইনপুট পরিবর্তিত হলে যে কাজটি করা হবে, তা নির্ধারণ করে।

প্যারামিটার

নাম প্রকার বর্ণনা
action Action করণীয় পদক্ষেপ।

ফেরত

TextInput — এটি একটি অবজেক্ট, যা চেইনিংয়ের জন্য ব্যবহৃত হয়।


setSuggestions(suggestions)

টেক্সট ফিল্ডে স্বয়ংক্রিয়ভাবে পূরণের জন্য সাজেশনগুলো সেট করে।

প্যারামিটার

নাম প্রকার বর্ণনা
suggestions Suggestions ব্যবহারের জন্য পরামর্শসমূহের সংকলন।

ফেরত

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

প্যারামিটার

নাম প্রকার বর্ণনা
suggestions Action Action যে অ্যাকশনটি এই ইনপুটের জন্য সাজেশন নিয়ে আসে।

ফেরত

TextInput — এটি একটি অবজেক্ট, যা চেইনিংয়ের জন্য ব্যবহৃত হয়।


setTitle(title)

ইনপুট ফিল্ডের উপরে প্রদর্শিত হওয়ার জন্য শিরোনাম নির্ধারণ করে। আবশ্যক।

প্যারামিটার

নাম প্রকার বর্ণনা
title String এই ইনপুটের জন্য টেক্সট লেবেল।

ফেরত

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

প্যারামিটার

নাম প্রকার বর্ণনা
validation Validation এই Text Input উইজেটের জন্য বৈধতা যাচাইয়ের নিয়ম।

ফেরত

TextInput — এটি একটি অবজেক্ট, যা চেইনিংয়ের জন্য ব্যবহৃত হয়।


setValue(value)

ইনপুট ফিল্ডে সেট করার জন্য আগে থেকে পূরণ করা মান নির্ধারণ করে।

প্যারামিটার

নাম প্রকার বর্ণনা
value String ইনপুটে নির্ধারিত ডিফল্ট মান। ফর্ম কলব্যাক প্যারামিটারগুলোতে এটি সর্বদা একটি স্ট্রিং হিসেবে উপস্থাপিত হয়।

ফেরত

TextInput — এটি একটি অবজেক্ট, যা চেইনিংয়ের জন্য ব্যবহৃত হয়।


setVisibility(visibility)

উইজেটটির দৃশ্যমানতা নির্ধারণ করে। এর ডিফল্ট মান হলো `VISIBLE`।

প্যারামিটার

নাম প্রকার বর্ণনা
visibility Visibility উইজেটটির Visibility

ফেরত

Widget — শৃঙ্খলিত করার জন্য ব্যবহৃত অবজেক্ট।