پاسخی به یک گفتگوی prompt که در محیط رابط کاربری برای یک برنامه Google نمایش داده می شود. پاسخ شامل هر متنی است که کاربر در فیلد ورودی گفتگو وارد کرده است و نشان می دهد که کاربر روی کدام دکمه کلیک کرده تا گفتگو را رد کند.
// Display a dialog box with a title, message, input field, and "Yes" and "No"
// buttons. The user can also close the dialog by clicking the close button in
// its title bar.
const ui = DocumentApp.getUi();
const response = ui.prompt(
'Getting to know you',
'May I know your name?',
ui.ButtonSet.YES_NO,
);
// Process the user's response.
if (response.getSelectedButton() === ui.Button.YES) {
Logger.log('The user\'s name is %s.', response.getResponseText());
} else if (response.getSelectedButton() === ui.Button.NO) {
Logger.log('The user didn\'t want to provide a name.');
} else {
Logger.log('The user clicked the close button in the dialog\'s title bar.');
}روش ها
| روش | نوع برگشت | شرح مختصر |
|---|---|---|
get Response Text() | String | متنی را که کاربر در قسمت ورودی گفتگو وارد کرده است دریافت می کند. |
get Selected Button() | Button | دکمه ای را دریافت می کند که کاربر برای رد کردن گفتگو روی آن کلیک کرده است. |
مستندات دقیق
get Response Text()
متنی را که کاربر در قسمت ورودی گفتگو وارد کرده است دریافت می کند. متن در دسترس است حتی اگر کاربر با کلیک کردن روی دکمه ای با مفهوم منفی مانند "لغو" یا دکمه بستن در نوار عنوان گفتگو، گفتگو را ببندد. get Selected Button() می تواند به تعیین اینکه آیا کاربر قصد دارد متن پاسخ معتبر باشد یا خیر کمک کند.
بازگشت
String - متنی که کاربر در فیلد ورودی گفتگو وارد کرده است.
get Selected Button()
دکمه ای را دریافت می کند که کاربر برای رد کردن گفتگو روی آن کلیک کرده است. اگر کاربر روی دکمه بستن که در نوار عنوان هر گفتگو موجود است کلیک کند، این روش Button.CLOSE برمی‌گرداند.
بازگشت
Button - دکمه ای که کاربر روی آن کلیک کرده است.