Package ro.sync.ecss.extensions.dita

Class DITASchemaAwareEditingHandler

java.lang.Object

ro.sync.ecss.extensions.api.AuthorSchemaAwareEditingHandlerAdapter

ro.sync.ecss.extensions.dita.DITASchemaAwareEditingHandler

All Implemented Interfaces:

AuthorSchemaAwareEditingHandler

Direct Known Subclasses:

DITAMapSchemaAwareEditingHandler

@API(type=INTERNAL,
     src=PUBLIC)
public class DITASchemaAwareEditingHandler
extends AuthorSchemaAwareEditingHandlerAdapter

Specific editing support for DITA documents. Handles typing and paste events inside steps, steps-unordered (a new step with a cmd will be created and the typing/paste content be put inside it) and tables (CALS and simple).

Nested Class Summary

Nested classes/interfaces inherited from class ro.sync.ecss.extensions.api.AuthorSchemaAwareEditingHandlerAdapter

AuthorSchemaAwareEditingHandlerAdapter.WrapInAncestorsOptions

Field Summary

Fields inherited from class ro.sync.ecss.extensions.api.AuthorSchemaAwareEditingHandlerAdapter

lastHandlerResult

Fields inherited from interface ro.sync.ecss.extensions.api.AuthorSchemaAwareEditingHandler

ACTION_ID_BACKSPACE, ACTION_ID_CUT, ACTION_ID_DELETE, ACTION_ID_DND, ACTION_ID_INSERT_FRAGMENT, ACTION_ID_PASTE, ACTION_ID_TYPING, CREATE_FRAGMENT_PURPOSE_COPY, CREATE_FRAGMENT_PURPOSE_CUT, CREATE_FRAGMENT_PURPOSE_DND_COPY, CREATE_FRAGMENT_PURPOSE_DND_MOVE

Constructor Summary

Constructors

Constructor	Description
DITASchemaAwareEditingHandler()

Method Summary

Modifier and Type	Method	Description
boolean	canBeReplaced(AuthorNode nodeToReplace)	When pasting an element inside an empty element with the same name, a possible solution is to replace the empty node with the new one.
boolean	changeElementsToMoveUpDown(List<AuthorNode> selectedElements)	Determine the elements that should be moved by the Move Up/Down operation.
AuthorSchemaAwareEditingHandlerAdapter.WrapInAncestorsOptions	getAncestorDetectionOptions()	One of the default smart paste strategies involves detecting an path o ancestors from the context element to the inserted one.
QName	getPreferredElement(AuthorDocumentController ctrl, int offset)	Get the qualified name of the best element to be inserted at the caret position as a wrapper for the content that is being typed or pasted.
boolean	handlePasteFragment(int offset, AuthorDocumentFragment[] fragmentsToInsert, int actionId, AuthorAccess authorAccess)	Handle an insert fragment event generated by: a Paste action.
boolean	handleTyping(int offset, char ch, AuthorAccess authorAccess)	Handle a typing event.
boolean	handleTypingFallback(int offset, char ch, AuthorAccess authorAccess)	Give a fallback solution for a typing event.

Methods inherited from class ro.sync.ecss.extensions.api.AuthorSchemaAwareEditingHandlerAdapter

getLastResult, handleCreateDocumentFragment, handleDelete, handleDeleteElementTags, handleDeleteNodes, handleDeleteSelection, handleJoinElements

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface ro.sync.ecss.extensions.api.AuthorSchemaAwareEditingHandler

handleCodePointTyping, handleCodePointTypingFallback

Constructor Details

DITASchemaAwareEditingHandler

public DITASchemaAwareEditingHandler()

Method Details

handleTyping

public boolean handleTyping(int offset,
 char ch,
 AuthorAccess authorAccess)
                     throws InvalidEditException

Description copied from interface: AuthorSchemaAwareEditingHandler

Handle a typing event. If the event is not handled, the default implementation of a handler will be given a chance to handle the event. If that fails to provide a solution, AuthorSchemaAwareEditingHandler.handleTypingFallback(int, char, AuthorAccess) will get called.

Specified by:

handleTyping in interface AuthorSchemaAwareEditingHandler

Overrides:

handleTyping in class AuthorSchemaAwareEditingHandlerAdapter

Parameters:

offset - Offset where the typing occurred.

ch - The typed character.

authorAccess - Access class to the author functions.

Returns:

true if the typing was handled.

Throws:

InvalidEditException - This is an invalid edit and must be rejected.

See Also:

• AuthorSchemaAwareEditingHandlerAdapter.handleTyping(int, char, ro.sync.ecss.extensions.api.AuthorAccess)

handleTypingFallback

public boolean handleTypingFallback(int offset,
 char ch,
 AuthorAccess authorAccess)
                             throws InvalidEditException

Description copied from interface: AuthorSchemaAwareEditingHandler

Give a fallback solution for a typing event. This call comes when this object's AuthorSchemaAwareEditingHandler.handleTyping(int, char, AuthorAccess) method did not handle the typing event and neither did the AuthorSchemaAwareEditingHandler.handleTyping(int, char, AuthorAccess) from the default implementation.

As a fallback solution, a paragraph can be inserted at the given offset (if allowed) and then the typed character can be inserted inside it.

Specified by:

handleTypingFallback in interface AuthorSchemaAwareEditingHandler

Overrides:

handleTypingFallback in class AuthorSchemaAwareEditingHandlerAdapter

Parameters:

offset - Offset where the typing occurred.

ch - The typed character.

authorAccess - Access class to the author functions.

Returns:

true if the typing was handled.

Throws:

InvalidEditException - This is an invalid edit and must be rejected.

See Also:

• AuthorSchemaAwareEditingHandlerAdapter.handleTypingFallback(int, char, ro.sync.ecss.extensions.api.AuthorAccess)

handlePasteFragment

public boolean handlePasteFragment(int offset,
 AuthorDocumentFragment[] fragmentsToInsert,
 int actionId,
 AuthorAccess authorAccess)
                            throws InvalidEditException

Description copied from interface: AuthorSchemaAwareEditingHandler

Handle an insert fragment event generated by:

• a Paste action. In this case, selection removal is handled before calling this method.
• a DND action. In this case source removal is handled after calling this method (unless an exception was thrown).
• an insert fragment event occurred as a result of an schema aware insert event, like AuthorDocumentController.insertXMLFragmentSchemaAware(String, int). Selection removal is handled before calling this method.

Specified by:

handlePasteFragment in interface AuthorSchemaAwareEditingHandler

Overrides:

handlePasteFragment in class AuthorSchemaAwareEditingHandlerAdapter

Parameters:

offset - Offset where the event occurred.

fragmentsToInsert - Fragments to be inserted.

actionId - ACTION_ID_PASTE if event was generated by paste action, ACTION_ID_DND if it was generated by a DND event or ACTION_ID_INSERT_FRAGMENT if the event was generated by an AuthorDocumentController schema aware insert method.

authorAccess - Access class to the author functions.

Returns:

true if the insertion was handled.

Throws:

InvalidEditException - This is an invalid edit and must be rejected.

See Also:

• AuthorSchemaAwareEditingHandlerAdapter.handlePasteFragment(int, ro.sync.ecss.extensions.api.node.AuthorDocumentFragment[], int, ro.sync.ecss.extensions.api.AuthorAccess)

changeElementsToMoveUpDown

public boolean changeElementsToMoveUpDown(List<AuthorNode> selectedElements)

Description copied from class: AuthorSchemaAwareEditingHandlerAdapter

Determine the elements that should be moved by the Move Up/Down operation. For example if the current selected element is a title then the element that should actually be moved is its parent (e.g. section for DocBook).

Overrides:

changeElementsToMoveUpDown in class AuthorSchemaAwareEditingHandlerAdapter

Parameters:

selectedElements - the selected elements in the author page. This list should be altered depending on the framework specific structure.
For example if the current selected element is a title then the element that should actually be present in this list is its parent (e.g. section for DocBook).

Returns:

true if the list of elements to be moved was altered by the framework specific handler.

See Also:

• AuthorSchemaAwareEditingHandlerAdapter.changeElementsToMoveUpDown(java.util.List)

getAncestorDetectionOptions

public AuthorSchemaAwareEditingHandlerAdapter.WrapInAncestorsOptions getAncestorDetectionOptions()

Description copied from class: AuthorSchemaAwareEditingHandlerAdapter

One of the default smart paste strategies involves detecting an path o ancestors from the context element to the inserted one. These are the preferences that control how these ancestors are chosen.

Overrides:

getAncestorDetectionOptions in class AuthorSchemaAwareEditingHandlerAdapter

Returns:

Preferences for choosing the best possible ancestors while building a path.

See Also:

• AuthorSchemaAwareEditingHandlerAdapter.getAncestorDetectionOptions()

canBeReplaced

public boolean canBeReplaced(AuthorNode nodeToReplace)

Description copied from class: AuthorSchemaAwareEditingHandlerAdapter

When pasting an element inside an empty element with the same name, a possible solution is to replace the empty node with the new one. This callback has a chance of rejecting this behavior when, for example, the node to replace has important attributes set on it.

Overrides:

canBeReplaced in class AuthorSchemaAwareEditingHandlerAdapter

Parameters:

nodeToReplace - The node to replace.

Returns:

true if this node can be replaced by the strategy with a similar one. false if this node is important and must be kept in the document.

See Also:

• AuthorSchemaAwareEditingHandlerAdapter.canBeReplaced(ro.sync.ecss.extensions.api.node.AuthorNode)

getPreferredElement

public QName getPreferredElement(AuthorDocumentController ctrl,
 int offset)

Description copied from class: AuthorSchemaAwareEditingHandlerAdapter

Get the qualified name of the best element to be inserted at the caret position as a wrapper for the content that is being typed or pasted.

Overrides:

getPreferredElement in class AuthorSchemaAwareEditingHandlerAdapter

Parameters:

ctrl - Provides methods for modifying the Author document.

offset - The caret offset where the insertion is performed.

Returns:

the qualified name of the preferred element or null.

See Also:

• AuthorSchemaAwareEditingHandlerAdapter.getPreferredElement(ro.sync.ecss.extensions.api.AuthorDocumentController, int)