INPUT /  OUTPUT /  LANGUAGE



Computing with ioLProgrammer's GuideLanguage Reference

＃ operator   ? operator   @ operator   abs tag   add tag   align field   and tag   array tag   audio tag   backgroundColor field   bold field   border field   borderBottom field   borderColor field   borderLeft field   borderRight field   borderStyle field   borderTop field   bottom field   box tag   button tag   carat field   checkBox tag   choiceBox tag   class tag   clear tag   clientFrame tag   color field   console tag   dialog tag   div tag   do field   editable field   ellipse tag   else field   eq tag   false tag   focus field   focusOrder field   font field   for tag   ge tag   gt tag   height field   hotKey field   if tag   img tag   inf tag   inline field   input tag   invalid tag   int tag   italic field   join tag   layer field   le tag   left field   limit field   line tag   lt tag   margin field   marginBottom field   marginLeft field   marginRight field   marginTop field   mod tag   mul tag   ne tag   neg tag   not tag   null tag   num tag   onClear field   onClick field   onCommit field   onContextClick field   onExit field   onFocus field   onGet field   onInput field   onKeyDown field   onKeyPress field   onKeyUp field   onMouseDown field   onMouseIn field   onMouseMove field   onMouseOut field   onMouseUp field   onPull field   onPush field   onResize field   onTimer field   openLink tag   or tag   pivot field   playing field   put tag   putError tag   putLn tag   requestTransfer tag   right field   rotate field   scalar tag   scroll field   scrollPos field   selectable field   spacing field   spacingBottom field   spacingLeft field   spacingRight field   spacingTop field   span tag   split tag   sub tag   table tag   tabRow tag   then field   timer tag   top field   transfer tag   transferAbility tag   transition field   true tag   underline field   vector tag   video tag   visible field   void tag   width field   with field   wrap field   xor tag


dialog tag

Category: ephemeral logic tag

Prompts the user for input using a pop-up dialog box. The user may be prompted to select from multiple options, or enter text input.

Sample usage

<dialog title={Error} {You can't select that option now}> — Displays an error message with only the option to cancel.

<dialog {Exit now?} choices={OK} symbol={?}> — Displays a question prompt with a question mark symbol where the user can either select "OK" or they can cancel the dialog prompt.

Fields

Primary field

Category: scalar field
Specifies a string of text for the user to be prompted with. For example, {Enter your name:}, or {Are you sure you wish to continue?}.

Secondary fields

Behaviour

When the tag is complete, user interaction with the console is temporarily suspended and a dialog prompt is shown to the user. After the user responds to the dialog prompt, the dialog tag generates a value containing the user's response to the prompt. The tag's lifetime then ends.

Notes

Although the dialog tag displays stuff on the screen, it behaves as an ephemeral logic tag rather than a presentation tag. This is because it evaluates and generates a result once, rather than creating a persistent object in the document tree.

Example

The following example demonstrates how you can output a dialog tag from a Python program to get the user's response to a simple OK/Cancel question, and get the user's response input back to your program in the simple format of "Y" for yes or "N" for no.

user_response = input('<putLn|if <dialog {Are you sure you want to continue?} choices={OK}> then={Y} else={N}>')