Class Prompt

Prompts allow the creation and display of custom dialogs to request information or confirmation from the user.

Example

let p = Prompt.create();

p.title = "Hello";
p.message = "World!";

p.addTextField("textFieldName", "Label", "");

p.addDatePicker("myDate", "Start date", new Date(), {
  "mode": "date"
});
p.addButton("First");
p.addButton("Second");

let didSelect = p.show();

let textFieldContents = p.fieldValues["textFieldName"];
let startDate = p.fieldValues["myDate"];

if (p.buttonPressed == "First") {
  // do something
}

Hierarchy

Prompt

Index

Display

isCancellable

isCancellable: boolean

If true, a "Cancel" button will be included in the dialog. Defaults to true. If the user selects the cancel button, the show() method will return false. If false, no cancel button will be displayed and the user must select one of the button name options.

message

message: string

A longer message explaining the purpose of the dialog, if needed.

title

title: string

Short title.

Field

addButton

addButton(name, value?, isDefault?, isDestructive?): void
Add a button to the array of buttons to be displayed. All buttons should be created before calling show().
Parameters
- name: string
- Optional value: object
  only needed to associate a different value than will be displayed in the button. For example, if you call prompt.addButton("First Button", 1), after calling prompt.show() if that button is pressed, the prompt.buttonPressed will contain the number value 1.
- Optional isDefault: boolean
  used to specify a single button which will be pinned to the bottom of the prompt and respond to cmd + return as the default button. If only one button is added to a prompt, it is assumed to be the default.
- Optional isDestructive: boolean
  if true, present the button as a destructive action, typically a red button, in the intereface.
Returns void

addDatePicker

addDatePicker(name, label, initialDate, options?): void
Add a date and/or time picker to the prompt, with the arguments as below. The fieldValues entry for this will be a date object.
Parameters
- name: string
  Identifier for the field. This will be used as the key in the fieldValues dictionary to access the contents of the field after calling show().
- label: string
  User-friendly text label to place next to the field.
- initialDate: Date
  The initial date to selected for the field. Minimum and maximum values should be defined in options.
- Optional options: {
      maximumDate?: Date;
      minimumDate?: Date;
      minuteInterval?: number;
      mode?: "date" | "time" | "dateAndTime";
  }
  A dictionary of options for configuring the text field.
  - Optional maximumDate?: Date
  - Optional minimumDate?: Date
  - Optional minuteInterval?: number
  - Optional mode?: "date" | "time" | "dateAndTime"
Returns void

addLabel

addLabel(name, label, options?): void
Add an information text label to the prompt.
Parameters
- name: string
  Identifier for the field.
- label: string
  The text of the label.
- Optional options: {
  textSize?: "body" | "caption" | "headline";
  }
  A dictionary of options for configuring the text field.
  - Optional textSize?: "body" | "caption" | "headline"
Returns void

addPasswordField

addPasswordField(name, label, initialValue): void
Same as addTextField, but the input field will be password masked.
Parameters
- name: string
- label: string
- initialValue: string
Returns void

addPicker

addPicker(name, label, columns, selectedRows): void
Add a picker to the prompt, with the arguments as below. Picker can contain multiple rows. The fieldValues entry for this will be a array of selected index values object.
Parameters
- name: string
  Identifier for the field. This will be used as the key in the fieldValues dictionary to access the contents of the field after calling show().
- label: string
  User-friendly text label to place next to the field.
- columns: string[][]
  The values to display in the picker. Should be an array containing arrays of string values, each sub-array representing a column in the picker. Example two column picker: [["Item 1", "Item 2"],["Column 2 Item 1", "Column 2 Item 2"]]
- selectedRows: number[]
  Array of zero-based index values to set the initial selected row in each column.
Returns void

addSegmentedControl

addSegmentedControl(name, label, values, selectedValue): void
Add a segmented control. Best used for selection between a small number of values. Returns a string value in fieldValues.
Parameters
- name: string
  Identifier for the field. This will be used as the key in the fieldValues dictionary to access the contents of the field after calling show().
- label: string
  User-friendly text label to place next to the field.
- values: string[]
  The array of string values that will be available in the segmented control.
- selectedValue: string
  String values that should be initially selected when the prompt is displayed. Value should match value in the values array.
Returns void

addSelect

addSelect(name, label, values, selectedValues, allowMultiple): void
Add a select control. Returns an array of string values in fieldValues.
Parameters
- name: string
  Identifier for the field. This will be used as the key in the fieldValues dictionary to access the contents of the field after calling show().
- label: string
  User-friendly text label to place next to the field.
- values: string[]
  The array of string values that will be available to select.
- selectedValues: string[]
  Array of string values that should be initially selected when the prompt is displayed. All values in this array should match values in the values array.
- allowMultiple: boolean
  If false, selecting a value will deselect all other values. If true, the user may select multiple items.
Returns void

addSwitch

addSwitch(name, label, initialValue): void
Add an on/off toggle switch. The fieldValues entry for this item will be a boolean indicating whether the switch was on.
Parameters
- name: string
  Identifier for the field. This will be used as the key in the fieldValues dictionary to access the contents of the field after calling show().
- label: string
  User-friendly text label to place next to the field.
- initialValue: boolean
  indicate if the switch should be on or off when initially displayed.
Returns void

addTextField

addTextField(name, label, initialText, options?): void
Add a text input field to the prompt
Parameters
- name: string
  Identifier for the field. This will be used as the key in the fieldValues dictionary to access the contents of the field after calling show().
- label: string
  User-friendly text label to place next to the field.
- initialText: string
  The initial text contents for the field.
- Optional options: {
      autocapitalization?: capitalizationTypes;
      autocorrect?: boolean;
      keyboard?: keyboardTypes;
      placeholder?: string;
      wantsFocus?: boolean;
  }
  A dictionary of options for configuring the text field.
  - Optional autocapitalization?: capitalizationTypes
  - Optional autocorrect?: boolean
    Should system autocorrect be enabled in field, Default: true
  - Optional keyboard?: keyboardTypes
  - Optional placeholder?: string
    Placeholder text to use when field is empty
  - Optional wantsFocus?: boolean
    If true, focus this field when prompt is displayed
Returns void

addTextView

addTextView(name, label, initialText, options?): void
Add a text input field to the prompt
Parameters
- name: string
  Identifier for the field. This will be used as the key in the fieldValues dictionary to access the contents of the field after calling show().
- label: string
  User-friendly text label to place next to the field.
- initialText: string
  The initial text contents for the field.
- Optional options: {
      autocapitalization?: capitalizationTypes;
      autocorrect?: boolean;
      height?: number;
      keyboard?: keyboardTypes;
      wantsFocus?: boolean;
  }
  A dictionary of options for configuring the text field.
  - Optional autocapitalization?: capitalizationTypes
  - Optional autocorrect?: boolean
    Should system autocorrect be enabled in field, Default: true
  - Optional height?: number
  - Optional keyboard?: keyboardTypes
  - Optional wantsFocus?: boolean
    If true, focus this field when prompt is displayed
Returns void

Other

constructor

new Prompt(): Prompt
Create new instance.

Returns Prompt

show

show(): boolean
Displays the prompt. Returns true if the user selected one of the buttons in the buttons array, false if the user selected the "Cancel" button. After the dialog has been shown, the buttonPressed property will contain the name of the button selected by the user.

Returns boolean

`Static` create

create(): Prompt
Create new instance.

Returns Prompt

Result

buttonPressed

buttonPressed: string

After the show() method is called, this property will contain the name of the button selected by the user.

fieldValues

fieldValues: {
[x: string]: any;
}

After the show() method is called, this property will contain values from any fields added to the prompt. The dictionary keys will be the names of the fields as passed in when they were created, and the value will be the current contents of that field. They type of data depends on the type of field.

Type declaration

[x: string]: any

Class Prompt

Example

Hierarchy

Index

Display

Field

Other

Result

Display

isCancellable

message

title

Field

addButton

Parameters

name: string

Optional value: object

Optional isDefault: boolean

Optional isDestructive: boolean

Returns void

addDatePicker

Parameters

name: string

label: string

initialDate: Date

Optional options: { maximumDate?: Date; minimumDate?: Date; minuteInterval?: number; mode?: "date" | "time" | "dateAndTime"; }

Optional maximumDate?: Date

Optional minimumDate?: Date

Optional minuteInterval?: number

Optional mode?: "date" | "time" | "dateAndTime"

Returns void

addLabel

Parameters

name: string

label: string

Optional options: { textSize?: "body" | "caption" | "headline"; }

Optional textSize?: "body" | "caption" | "headline"

Returns void

addPasswordField

Parameters

name: string

label: string

initialValue: string

Returns void

addPicker

Parameters

name: string

label: string

columns: string[][]

selectedRows: number[]

Returns void

addSegmentedControl

Parameters

name: string

label: string

values: string[]

selectedValue: string

Returns void

addSelect

Parameters

name: string

label: string

values: string[]

selectedValues: string[]

allowMultiple: boolean

Returns void

addSwitch

Parameters

name: string

label: string

initialValue: boolean

Returns void

addTextField

Parameters

name: string

label: string

initialText: string

Optional options: { autocapitalization?: capitalizationTypes; autocorrect?: boolean; keyboard?: keyboardTypes; placeholder?: string; wantsFocus?: boolean; }

Optional autocapitalization?: capitalizationTypes

Optional autocorrect?: boolean

`Optional` value: object

`Optional` isDefault: boolean

`Optional` isDestructive: boolean

`Optional` options: {
maximumDate?: Date;
minimumDate?: Date;
minuteInterval?: number;
mode?: "date" | "time" | "dateAndTime";
}

`Optional` maximumDate?: Date

`Optional` minimumDate?: Date

`Optional` minuteInterval?: number

`Optional` mode?: "date" | "time" | "dateAndTime"

`Optional` options: {
textSize?: "body" | "caption" | "headline";
}

`Optional` textSize?: "body" | "caption" | "headline"

`Optional` options: {
autocapitalization?: capitalizationTypes;
autocorrect?: boolean;
keyboard?: keyboardTypes;
placeholder?: string;
wantsFocus?: boolean;
}

`Optional` autocapitalization?: capitalizationTypes

`Optional` autocorrect?: boolean

`Optional` keyboard?: keyboardTypes

`Optional` placeholder?: string

`Optional` wantsFocus?: boolean

`Optional` options: {
autocapitalization?: capitalizationTypes;
autocorrect?: boolean;
height?: number;
keyboard?: keyboardTypes;
wantsFocus?: boolean;
}

`Optional` autocapitalization?: capitalizationTypes

`Optional` autocorrect?: boolean

`Optional` height?: number

`Optional` keyboard?: keyboardTypes

`Optional` wantsFocus?: boolean

`Static` create