Prompt.promptOptions()

Overview

Displays a dialog box that prompts a user with button options. This function is asynchronous and will return before the response is given. Use the callback parameter to handle results.

Added in version 2.0.1

Format

Prompt.promptOptions(title, message, options, resultDelegate);

Parameter Description Type Required Notes
title A title to display for the dialog. Can be null or an empty string if no title is desired. String Required  
message The message to display in the dialog box. String Required  
options Button options for the user to select. String Required Separate options with a | character.
resultDelegate A function that takes a single string result parameter that is called when the user responds to the prompt. When the user selects an option that value will be returned. Function with a single String parameter Required  

Example

Copy
/* Prompt the user to choose 'Dog', 'Cat' or 'Bird'.
*/
 
Prompt.promptOptions("Favorite Animal","Choose your favorite animal.", "Dog|Cat|Bird", function (result) {
  if(result === 'Dog') {
    View.toast('bark', true);
  }
  if(result === 'Cat') {
    View.toast('meow', true);
  }
  if(result === 'Bird') {
    View.toast('tweet', true);
  }
});