word rich text content control vs plain text

However, we need to consider that selections may also be “collapsed”.Ī collapsed selection is one where start and end values are identical (e.g. In general, this is useful for knowing which portion of the text is selected.

If, as a user, I make a selection of the word Hello this would result in a value object with start and end as 0 and 5 respectively. Let’s continue to consider the above example with the text Hello world. arrays within the sparse array at positions 2-8 that include the core/link format.arrays within the sparse array at positions 2-5 that include the core/bold format.

If text is formatted from position 2-5 in bold ( core/bold) and from position 2-8 with a link ( core/link), then you’ll find: It is important to understand how a value represents richly formatted text. Rather you should rely on the built in methods of the package to build these for you.

You should not attempt to create your own value objects. end – an index in the text representing the end of the currently active selection.start – an index in the text representing the start of the currently active selection.core/link, core/bold etc.) at the positions where the text is formatted. formats – a sparse array of the same length as text that is filled with formats (e.g.text – the string of text to which rich formats are to be applied.The value object is comprised of the following: The Rich Text package is designed to aid in the manipulation of plain text strings in order that they can represent complex formatting.īy using a RichTextValue value object (referred to from here on as value) it is possible to separate text from formatting, thereby affording the ability to easily search and manipulate rich formats.

If you’re using an environment that has limited or no support for such language features and APIs, you should include the polyfill shipped in in your code. Install the module npm install package assumes that your code will run in an ES2015+ environment. This module contains helper functions to convert HTML or a DOM tree into a rich text value and back, and to modify the value with functions that are similar to String methods, plus some additional ones for formatting. Browse: Home / Block Editor Handbook / Reference Guides / Package Reference / Edit

Word rich text content control vs plain text