Rich Text in Touch UI

Monday, October 16, 2017PrintSubscribe
Rich Text in Touch UI

By default any HTML content stored in the database table column will be displayed in the raw format with the tags plainly visible to the end user. Rich text mode will force the framework to prevent encoding of the values and let the browser to render the content with the formatting. Property Text Mode of a data field  enables rich text formatting when set to Rich Text. End users will have access to the text formatting options available on the special toolbar displayed when the field is focused on the form.

Rich Text Editor in apps with Touch UI.

The formatted text will also be visible in the Grid and List view styles.

Rich Text formatting in visible in Grid and List styles in apps created with Code On Time.

If the Text Mode is set to the default value, then the formatting tags are revealed as plain text.

By default Rich Text formatting tags are revealed in plain form.

Button “…” displayed on the right side of the formatting toolbar will bring up a full list of formatting commands available to the user.

The panel of RTF options activated from the built-in RTF editor in apps with Touch UI.

Developers control the Richt Text Format (RTF) toolbar with the tags assigned to the data field.

Tag rtf-frame will display a frame around the field content when the focus is received.

A frame may optional surround the boundaries of Rich Text in apps with Touch UI.

Tag rtf-toolbar-location-bottom will set the preferred location of the formatting tollbar to be at the bottom of the field in the form. This option may prove to be useful when implementing messaging forms with the the recepient and subject displayed above the field value.

An optional location as the bottom can be specified for RTF fields in apps with Touch UI.

Note that the framework will move the toolbar above or below the field boundaries as the user scrolls the contents of the form. The text boundaries will grow as the user types in more content.

Tag rtf-editor will force a dedicated editor form to be displayed when user activated the field with the Text Mode set to  Rich Text. This mode may help when a long text is expected to be entered as the field value. User can press Ctrl+Enter keyboard shortcut to save the contents when edting is finished to retun to the data form.

A dedicated rich text editor form can be activated by default or when user preses F11 while editing RTF text in apps with Touch UI.

Tag rtf-editor-fullscreen will display a fullscreen editor window upon activation.

A fullscreen editor can be specified as the default editing option in apps with Touch UI created with Code On Time app generator.

The dedicated editor form can be activated by pressing F11 when the rtf-editor tag is not specified and the focus is on the Rich Text field.

Individual commands on the toolbar can be controlled by providing a combination of rtf-command-(command-name) tags. For example, if a limited text formating is desired then rtf-command-bold rtf-command-italic rtf-command-insertUnorderedList combination of tags will transform the formatting toolbar as follows.

Developers have a control over RTF formatting commands in apps created with Touch UI.

The complete list of supported formatting commands is presented in the table.

Tag Description
rtf-command-formatBlock-p Formats text as a paragraph. This option is avialable in under Format drop down on the toolbar.
rtf-command-formatBlock-blockquote Format text as a quotation. This option is avialable in under Format drop down on the toolbar.
rtf-command-formatBlock-h1 Format text as Heading 1. This option is avialable in under Format drop down on the toolbar.
rtf-command-formatBlock-h2 Format text as Heading 2. This option is avialable in under Format drop down on the toolbar.
rtf-command-formatBlock-h3 Format text as Heading 3. This option is avialable in under Format drop down on the toolbar.
rtf-command-formatBlock-h4 Format text as Heading 4. This option is avialable in under Format drop down on the toolbar.
rtf-command-formatBlock-h5 Format text as Heading 5. This option is avialable in under Format drop down on the toolbar.
rtf-command-formatBlock-h6 Format text as Heading 6. This option is avialable in under Format drop down on the toolbar.
rtf-command-bold Format text as bold.
rtf-command-italic Format text as italic.
rtf-command-underline Format text as underlined.
rtf-command-strikethrough Format text with a strike through.
rtf-command-insertUnorderedList Format selected text as unoredered list or start a new unordered list.
rtf-command-insertOrderedList Format selected text as ordered list or start a new oredered list.
rtf-command-justifyLeft Align the selected text to the left.
rtf-command-justifyCenter Align the selected text to the center.
rtf-command-justifyRight Alight the selected text to the right.
rtf-command-justifyFull Justify the text to fill the full width of text boundaries.
rtf-command-indent Increase indentation of the text on the left side.
rtf-command-outdent Decrease indentation of the text on the left side.
rtf-command-removeFormat Remove formatting from the selected text.
rtf-command-rtf-editor Enables an option to activate a dedicated editor for the field content.

Additional formatting commands will be available in the future releases. Don’t hesisitate to contact customer support if specific formatting options are desired.

The implementation of rich text formatting is based on the native content editing capabilities of the modern browsers. Applicaiton frameowork will use P tag to format paragraphs accross different platforms and strip all formatting when the text is pasted from the clipboard. The implementation of rich formatting is touch friendly. The new RTF editing support will be also utilized in the upcoming page builder of the built-in Content Management System (CMS) available in the apps created with Code On Time.

Note that variations in the implementations of content editing by browser vendors may produce a slightly different formatting output but appear the same to the end users on different platforms. An attempt to provide a unified formatting across various platforms will require creating a full featured document editor, which is not an easy task.

There are great RTF editors out there. Many of them are with a permissive licensing. Some of the editors are already providing a decent touch-friendly user interface. We will be integrating support for the leading solutions in the future implementations of the framework. Custom RTF editors are equipped with their own extensive user interface. Therefore we will be offering external RTF editor integration as dedicated forms via rtf-editor tag extensions. External editors will display on top of the forms. If you would like to sponsor an integration of a particular RTF editing framework, then please contact customer support to request a quote.