<< Click to Display Table of Contents >> Rich Text Format Editor |
Overview
The Rich Text Format Editor Widget for Bizagi is available for download at Bizagi Widget Xchange.
Through this Widget, you will be able to edit and visualize text in rich format, using the capabilities of the TinyMCE plugin. With this widget, you will be able to change characteristics of a text, such as its font, size, foreground color, background color and content type (paragraph, header, etc.), among others.
Before you start
In order to test and use this Widget, you will need:
1.Bizagi Studio previously installed.
2.This specific Widget previously installed, either as described at https://help.bizagi.com/platform/en/index.html?widget_xchange.htm, or as described at https://help.bizagi.com/platform/en/index.html?widgets_manualinst.htm.
Content Security Policy considerations
The Content Security Policy is an HTTP header that adds an additional layer of security to web pages. By configuring this header, users can allow or deny different resources that can be loaded in the Work Portal, such as JavaScript calls, or CSS components. To use this component, it is necessary to configure the Content Security Policy in Bizagi Studio, as described here.
The Rich Text Format Editor Widget allows you to insert images. However, the CSP blocks the images from external sources. Hence, it is necessary to specify the URL where the image is located, so that it is not blocked.
The following is the Content Security Policy for the Rich Text Format Editor widget:
default-src 'self' data: blob:;
script-src 'self' 'unsafe-inline' 'unsafe-eval';
style-src 'self' 'unsafe-inline';
img-src 'self' example.com data: blob:;
font-src * 'unsafe-inline' data: blob:;
Where example.com is the URL where the image you want to load is located.
The Content Security Policy configuration is only necessary for Bizagi 11.2.5 and later versions. |
Data model considerations
In order to use this Widget, you need in your data model:
•A String type or an extended text type attribute which holds the message you want to display.
Other considerations
Language
The widget supports all the languages supported by Bizagi: English, Spanish, German, French, Portuguese, Russian, Dutch, Italian, Japanese, Chinese simplified, Czech and Arabic. Any other language will be shown in English.
Paste option
The Paste option from the menu is not available in the Google Chrome, Firefox and Safari browsers. However, you can use the "Ctrl + V" shortcut in your keyboard.
Themes
The widget allows you to define a theme for different elements (e.g, buttons). Nonetheless, the widget does not have access to the theme used by the Work Portal. Hence, the elements defined in the widget with a specific theme will still be shown in a neutral color.
Browsers compatibility
The Rich Text Format Editor widget is not compatible with Internet Explorer.
Properties configuration
In order to configure this Widget once it is installed in your project, include it in any form and set its properties in the Forms designer, just as you would do with any other Bizagi control. When installed, the widget will appear in the Text editors section of the Controls tab.
To configure the widget, consider the following properties.
PROPERTY |
POSSIBLE VALUES |
DEFAULT VALUE / SUGGESTED |
---|---|---|
Data binding |
A string type or extended text attribute which holds RTF text. |
Not applicable. This property is mandatory. |
Height |
Widget's height in pixels within the form. The minimum height required for the widget to display all its options is 124px. A lower value will not be considered and the widget will use a 124px height.
Also, bear in mind that this parameter is only used when the widget is editable. |
400px |
Notice all Bizagi controls and Widgets, enable a visible property which lets you set if that control should be displayed in a given form or not (e.g, by using a business rule). |
For complete documentation or more information about this Widget's possibilities (e.g, if you wish to customize and extend it), refer to the information about the implemented jQuery Plugin at https://www.tiny.cloud/docs/.
Last Updated 10/28/2022 10:01:58 AM