Skip to end of metadata
Go to start of metadata

Crosslight Dialog Presenter allows you to present a dialog and receive additional input from users. Unlike other Crosslight presenter variations such as Message Presenter which provides only simple and basic interaction, dialog presenter lets you present any custom content that may contain additional input controls and more sophisticated UI logic bound to a ViewModel. Similar to the other presenter variants, you can easily consume dialog presenter right from the ViewModel.

On this page:

Using Dialog Presenter

Using dialog presenter is simple and straightforward. You can target virtually any type of view context by specifying the respective ViewModel. To learn more how to implement the platform-specific view, see Data Presentation Overview.

Here are some basic usage examples. To show a simple dialog and retrieve the result, you can use the following code snippet:

Customizing Dialog Presenter

Dialog Presenter comes with 3 built-in buttons which represents negative, positive, and neutral actions. By default, the dialog presenter will only display the positive and neutral buttons. However you can easily customize what are going to be displayed through the DialogOptions. See the following code.

 

If you wish to hide the buttons, you can do it in this way.

 

There are several properties that you can customize in the DialogOptions. See the following list.

  • Title
    Specifies the caption text of the dialog.
  • Buttons
    Specifies the visible buttons.
  • HideButtons
    Indicates whether buttons should be included in the
  • NegativeButtonText
    Specifies the negative button text.
  • NegativeButtonStyle
    Specifies the negative button style.
  • PositiveButtonText
    Specifies the positive button text.
  • PositiveButtonStyle
    Specifies the positive button style.
  • NeutralButtonText
    Specifies the neutral button text.
  • NeutralButtonStyle
    Specifies the neutral button style.

Platform-specific Settings

In addition to the generic dialog settings, each platform has their own settings that are specific to their interface guidelines. For instance, you can enable universal presenter setting in iOS, customizing its transition, presentation mode, and much more.

To learn more about the settings for dialog presenter in iOS and Android, see iOS Dialog Presenter and Android Dialog Presenter respectively.

Samples

To jump start with Crosslight Dialog Presenter and see how it is implemented, please check out our comprehensive samples here: http://git.intersoftpt.com/projects/CROS-SUPP/repos/dialogpresenter-sample/browse.

Get Started

For step-by-step walkthrough on how to get started with the Crosslight Dialog Presenter, check out this document: Get Started with Crosslight Dialog Presenter.