Class Action

পদক্ষেপ

এমন একটি অ্যাকশন যা UI এলিমেন্টগুলোর মধ্যে ইন্টারঅ্যাক্টিভিটি সক্ষম করে। এই অ্যাকশনটি সরাসরি ক্লায়েন্টে ঘটে না, বরং এটি ঐচ্ছিক প্যারামিটারসহ একটি অ্যাপস স্ক্রিপ্ট কলব্যাক ফাংশনকে আহ্বান করে।

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

const image = CardService.newImage().setOnClickAction(
    CardService.newAction().setFunctionName('handleImageClick').setParameters({
      imageSrc: 'carImage'
    }),
);

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
add Required Widget(requiredWidget) Action একটি বৈধ সাবমিশনের জন্য এই অ্যাকশনটির প্রয়োজনীয় উইজেটগুলোর নাম যোগ করে।
set All Widgets Are Required(allWidgetsAreRequired) Action এই অ্যাকশনটির জন্য সমস্ত উইজেট থেকে ইনপুট প্রয়োজন কিনা তা নির্দেশ করে।
set Function Name(functionName) Action যে কলব্যাক ফাংশনটি কল করা হবে তার নাম নির্ধারণ করে।
set Interaction(interaction) Action ব্যবহারকারীর সাথে মিথস্ক্রিয়া নির্ধারণ করে, যা শুধুমাত্র একটি ডায়ালগ খোলার সময় প্রয়োজন হয়।
set Load Indicator(loadIndicator) Action কাজটি চলাকালীন প্রদর্শিত লোডিং ইন্ডিকেটরটি নির্ধারণ করে।
set Parameters(parameters) Action কলব্যাক ফাংশনে কাস্টম প্যারামিটার পাস করার সুযোগ দেয়।
set Persist Values(persistValues) Action কোনো অ্যাকশন রেসপন্স ফর্মের Card আপডেট করার পর, ফর্মের মানগুলো ক্লায়েন্টের মান দ্বারা নাকি সার্ভারের মান দ্বারা নির্ধারিত হবে, তা নির্দেশ করে।

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

addRequiredWidget(requiredWidget)

একটি বৈধ সাবমিশনের জন্য এই অ্যাকশনটির প্রয়োজনীয় উইজেটগুলোর নাম যোগ করে। এই অ্যাকশনটি চালু করার সময় যদি এই তালিকার উইজেটগুলোতে কোনো ভ্যালু না থাকে, তাহলে ফর্ম সাবমিশনটি বাতিল হয়ে যায়।

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

const textInput = CardService.newTextInput()
                      .setFieldName('text_input_1')
                      .setTitle('Text input title');

// Creates a footer button that requires an input from the above TextInput
// Widget.
const action = CardService.newAction()
                   .setFunctionName('notificationCallback')
                   .addRequiredWidget('text_input_1');
const fixedFooter = CardService.newFixedFooter().setPrimaryButton(
    CardService.newTextButton().setText('help').setOnClickAction(action),
);

প্যারামিটার

নাম প্রকার বর্ণনা
required Widget String এই অ্যাকশনটির জন্য প্রয়োজনীয় উইজেটের নাম।

ফেরত

Action — এই অবজেক্টটি, চেইন করার জন্য।

setAllWidgetsAreRequired(allWidgetsAreRequired)

এই অ্যাকশনটির জন্য সমস্ত উইজেট থেকে ইনপুট প্রয়োজন কিনা তা নির্দেশ করে।

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

// Creates a button with an action that requires inputs from all widgets.
const button = CardService.newTextButton()
                   .setText('Create notification')
                   .setOnClickAction(
                       CardService.newAction().setAllWidgetsAreRequired(true));

প্যারামিটার

নাম প্রকার বর্ণনা
all Widgets Are Required Boolean কাজটি করার জন্য সমস্ত উইজেট থেকে ইনপুট প্রয়োজন হবে কিনা। ডিফল্ট মান হলো false ।

ফেরত

Action — এই অবজেক্টটি, চেইন করার জন্য।

setFunctionName(functionName)

যে কলব্যাক ফাংশনটি কল করা হবে তার নাম নির্ধারণ করে। আবশ্যক।

প্যারামিটার

নাম প্রকার বর্ণনা
function Name String ফাংশনের নাম। আপনি অন্তর্ভুক্ত লাইব্রেরি, যেমন Library.libFunction1 থেকে ফাংশন ব্যবহার করতে পারেন।

ফেরত

Action — এই অবজেক্টটি, চেইন করার জন্য।

setInteraction(interaction)

ব্যবহারকারীর সাথে মিথস্ক্রিয়া নির্ধারণ করে, যা শুধুমাত্র একটি ডায়ালগ খোলার সময় প্রয়োজন হয়। যদি এটি নির্দিষ্ট করা না থাকে, তাহলে অ্যাপটি স্বাভাবিকভাবেই একটি লিঙ্ক খোলা বা কোনো ফাংশন চালানোর মতো একটি Action সম্পাদন করে সাড়া দেয়।

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

const action = CardService.newAction()
                   .setFunctionName('handleDialog')
                   .setInteraction(CardService.Interaction.OPEN_DIALOG);

প্যারামিটার

নাম প্রকার বর্ণনা
interaction Interaction নির্দিষ্ট করার জন্য মিথস্ক্রিয়া।

ফেরত

Action — এই অবজেক্টটি, চেইন করার জন্য।

setLoadIndicator(loadIndicator)

কাজটি চলাকালীন প্রদর্শিত লোডিং ইন্ডিকেটরটি নির্ধারণ করে।

প্যারামিটার

নাম প্রকার বর্ণনা
load Indicator Load Indicator প্রদর্শনের জন্য সূচকটি।

ফেরত

Action — এই অবজেক্টটি, চেইন করার জন্য।

setParameters(parameters)

কলব্যাক ফাংশনে নিজস্ব প্যারামিটার পাঠানোর সুযোগ দেয়। ঐচ্ছিক।

প্যারামিটার

নাম প্রকার বর্ণনা
parameters Object কী এবং ভ্যালু উভয়ই স্ট্রিং হতে হবে।

ফেরত

Action — এই অবজেক্টটি, চেইন করার জন্য।

setPersistValues(persistValues)

কোনো অ্যাকশন রেসপন্স ফর্মের Card আপডেট করার পর, ফর্মের ভ্যালুগুলো ক্লায়েন্টের ভ্যালু দ্বারা নির্ধারিত হবে নাকি সার্ভারের ভ্যালু দ্বারা, false নির্দেশ করে। যখন এটি ' true সেট করা হয়, তখন সার্ভারের ভ্যালুগুলো সার্ভারের ভ্যালু দ্বারা প্রতিস্থাপিত হয়। ডিফল্ট মান ' false ।

ক্লায়েন্ট ভ্যালুগুলো সংরক্ষণ করলে এমন পরিস্থিতি এড়ানো যায় যেখানে ব্যবহারকারীর কোনো সম্পাদনার পর ফর্মটি অপ্রত্যাশিতভাবে পরিবর্তিত হয়ে যায়। উদাহরণস্বরূপ, যদি কোনো ব্যবহারকারী ফর্ম জমা দেওয়ার পর, কিন্তু সার্ভার সাড়া দেওয়ার আগে, একটি TextInput সম্পাদনা করেন। যদি ভ্যালুগুলো সংরক্ষিত থাকে, তাহলে সার্ভারের সাড়া Card আপডেট করার পরেও ব্যবহারকারীর করা সম্পাদনাটি থেকে যায়; অন্যথায় ফর্মের ভ্যালুটি সেই অবস্থায় ফিরে আসে যা ব্যবহারকারী প্রথমে জমা দিয়েছিলেন।

ক্লায়েন্ট ভ্যালু স্থায়ীভাবে রেখে দিলে তা আপনার স্ক্রিপ্টের ফর্ম ফিল্ড খালি করা বা ফর্মের ভ্যালু ওভাররাইড করার ক্ষমতায় বাধা সৃষ্টি করতে পারে, তাই এই ধরনের কার্যকারিতার জন্য পার্সিস্টেন্স চালু করা থেকে বিরত থাকুন। পার্সিস্টেন্স ছাড়া, ইভেন্টের জন্য LoadIndicator.SPINNER ব্যবহার করার পরামর্শ দেওয়া হয়, কারণ এটি UI লক করে দেয় এবং সার্ভার সাড়া দেওয়ার আগে ব্যবহারকারীকে সম্পাদনা করতে বাধা দেয়। বিকল্পভাবে, আপনি LoadIndicator.NONE ব্যবহার করতে পারেন এবং নিশ্চিত করতে পারেন যে ফর্মের প্রতিটি এলিমেন্টের একটি onChange অ্যাকশন রয়েছে।

// Creates a button with an action that persists the client's values as the
// on-click action.
const button =
    CardService.newTextButton()
        .setText('Create notification')
        .setOnClickAction(
            CardService.newAction().setPersistValues(true).setFunctionName(
                'functionName'),
        );

প্যারামিটার

নাম প্রকার বর্ণনা
persist Values Boolean মানগুলি সংরক্ষণ করা হবে কিনা। ডিফল্টরূপে এটি false থাকে।

ফেরত

Action — এই অবজেক্টটি, চেইন করার জন্য।

অপ্রচলিত পদ্ধতি