Informational Boxes
Information in a box
When you want to present information to the user in a form of a dialog box, you'll want to use this feature that presents you with a wide variety of informational box styles to choose from, depending on the purpose. Some informational box styles are modal, while others are non-modal. Modal informational boxes require input from the end user, while non-modal informational boxes don't require input and usually represent a progress being made.
The following informational box styles are presented in this way:
Modal informational boxes
Buttons
Input
Password input
Modal dialog box
Slider
Selection
Multi selection
Non-modal informational boxes
Non-modal dialog box
Progress
Modal informational boxes
Informational box styles of this nature are modal. They require input from the end user in order to present information to the user with action. These boxes are common in interactive console applications where information is to be conveyed to the user. They are presented in a different style, based on how or what action the user needs to take, and their borders are customizable with the BorderSettings
instance.
Every single modal informational box style contain their own help page which you can access via the K
key. They support both keyboard and mouse.
For informational boxes that use choice-based input styles, you can discover how to define choices by visiting this page:
Buttons
This style utilizes choice-based input to render the buttons inside the informational box of this style, which makes them look like a conventional dialog box. This style can render up to three buttons from the right to the left, which means three instances of InputChoiceInfo
. You can use this style with the InfoBoxButtonsColor
class.
Input
This style uses the input reader to tell the user to write something, based on the informational box contents. For example, if this informational box tells an end-user to write a hostname of an SFTP server, the user will have to write the hostname. You can use this style with InfoBoxInputColor
.
Input (password)
This style uses the input reader masked with the password to tell the user to write something, based on the informational box contents. For example, if this informational box tells an end-user to write a password of an account when logging in to the SFTP server, the user will have to write the password. You can use this style with InfoBoxInputPasswordColor
.
Normal modal info box
This style only prints information that the end user needs to read. This is suitable for information that doesn't need any action. You can use this style with the InfoBoxModalColor
class.
Slider
This style allows you to define a minimum, a current, and a maximum value of an integral value that can only be described as surrounded between the minimum value and the maximum value. For example, a slider that has a minimum value of 5 and a maximum value of 10 can only accept values of between 5 and 10, which means 5, 6, 7, 8, 9, and 10. You can use this style with the InfoBoxSliderColor
class.
Selection styles
There are two styles in this category:
Single selection
Multiple selection
Single selection informational box
This info box style uses the choice-based input to define choices that the end user will have to select one of them. Plus, you can search for a choice using the F
key to initiate a regex-based search for maximum flexibility. You can use this style with the InfoBoxSelectionColor
class.
Multiple selection informational box
This info box style uses the choice-based input to define multiple choices that the end user will have to select one of them. Plus, you can search for a choice using the F
key to initiate a regex-based search for maximum flexibility. You can use this style with the InfoBoxSelectionMultipleColor
class.
Non-modal informational boxes
In addition to the modal informational boxes, we also have non-modal informational boxes that don't wait for user input, but gets rendered once per call.
Normal infobox
This is used to convey information to the end user that some progress is being made without any percentage. Such progress is called indeterminate progress. However, this can be used to display a disclaimer or any other information within a limited time.
Progress
This is used to tell the end user through an informational box with a progress bar that something is happening, and that the progress is being done all the way to 100%. This infobox needs to be in a loop while progress is being made.
Last updated