| 48. insertNewlineOrSplitBlock | ||
|---|---|---|
 | Chapter 6. Commands written in the Java™ programming language |  |
| 48. insertNewlineOrSplitBlock | ||
|---|---|---|
| | Chapter 6. Commands written in the Java™ programming language | |
No parameter.
If the caret is contained in a element which accepts newline characters (e.g. pre, programlisting), a newline character (&) is inserted in this element. Otherwise, if the caret is contained in a block, this block is split in two parts.0#xA;
To make it simple, a block is a paragraph, a heading (e.g. XHTML h1, h2, ..., h6 or DocBook bridgehead) or a list item. However what is exactly a block must be specified as explained in Section 52.1, “Specifying splittable blocks”.
More precisely,
If the caret is found at the very beginning of a block, a new, similar, empty block is inserted before the current one.
If the caret is found at the very end of a block, a new, similar, empty block is inserted after the current one.
Otherwise, the current block is split in two parts.
However, if a block is declared as being a heading and if another block has been declared as being the most common form of paragraphs (see Section 52.1, “Specifying splittable blocks”):
If the caret is found at the very beginning of a heading, a new, empty paragraph is inserted before this heading.
If the caret is found at the very end of a heading, a new, empty paragraph is inserted after this heading.
Otherwise, the current heading is split in two parts.
When acting on the current block, this command can be executed if there is no selection or if a single element is explicitly selected. When there is no selection, the current block is automatically determined among the elements which directly or indirectly contain the caret. When an element is selected, this element is considered to be the current block if and only if it directly or indirectly contains the caret and it is listed in the configuration_name blockList
This command is intended to be bound to the Enter key.
| |  | |
| 47. insertControlChar |  | 49. insertNode |