The base class for styled text models used by the RichTextArea.

This class handles the following functionality with the intent to simplify custom models:

• managing listeners
• firing events
• decomposing the edits into multiple operations performed on individual paragraphs
• managing Markers

Editing

The model supports editing when isWritable() returns true. Three methods participate in modification of the content: replace(StyleResolver, TextPos, TextPos, String, boolean), replace(StyleResolver, TextPos, TextPos, StyledInput, boolean), applyStyle(TextPos, TextPos, StyleAttributeMap, boolean). These methods decompose the main modification into operations with individual paragraphs and delegate these to subclasses.

At the end of this process, an event is sent to all the Listeners, followed by the skin requesting the updated paragraphs when required.

Creating a Paragraph

The model presents its content to the view(s) via immutable RichParagraph. There are two ways of adding styles to the model:

• Using the style names in the stylesheet or inline styles (example: "-fx-font-size:200%;"), or
• Using attributes defined in StyleAttributeMap, such as bold typeface, italic, and so on. In this case, the resulting paragraph appearance is decoupled from the stylesheet and will look the same regardless of the active stylesheet.

The latter method is intended for applications where an editable control is needed, such as general purpose rich text editor, the former is designed for view-only informational controls that must follow the application theme and therefore are coupled to the stylesheet.

Extending the Model

The subclasses are free to choose how the data is stored, the only limitation is that the model neither stores nor caches any Nodes, since multiple skins might be attached to the same model. When required, the model may contain properties which can be bound to the Nodes created in getParagraph(int). It is the responsibility of the model to store and restore the values of such properties.