CKEDITOR.Link Class
src/core/link.js:8
Link class utility. Provides methods for create, delete and update links.
Constructor
CKEDITOR.Link
-
editor
Parameters:
-
editorObjectThe CKEditor instance.
Index
Methods
Methods
_getCompleteURI
-
URI
Checks if the URI begins with a '#' symbol to determine if it's an on page bookmark. If it doesn't, it then checks if the URI has an '@' symbol. If it does and the URI looks like an email and doesn't have 'mailto:', 'mailto:' is added to the URI. If it doesn't and the URI doesn't have a scheme, the default 'http' scheme with hierarchical path '//' is added to the URI.
Parameters:
-
URIStringThe URI of the link.
Returns:
The URI updated with the protocol.
advanceSelection
-
link
Advances the editor selection to the next available position after a given link or the one in the current selection.
Parameters:
-
linkCKEDITOR.dom.elementThe link element which link style should be removed.
create
-
attrs -
modifySelection -
URI
Create a link with given URI as href.
Parameters:
-
attrsObjectA config object with link attributes. These might be arbitrary DOM attributes.
-
modifySelectionObjectA config object with an advance attribute to indicate if the selection should be moved after the link creation.
-
URIStringThe URI of the link.
debounce
-
args -
callback -
timeout -
context
Debounce util function. If a function execution is expensive, it might be debounced. This means that it will be executed after some amount of time after its last call. For example, if we attach a a function on scroll event, it might be called hundreds times per second. In this case it may be debounced with, let's say 100ms. The real execution of this function will happen 100ms after last scroll event.
Parameters:
-
argsArrayAn array of arguments which the callback will receive.
-
callbackFunctionThe callback which has to be called after given timeout.
-
timeoutNumberTimeout in milliseconds after which the callback will be called.
-
contextObjectThe context in which the callback will be called. This argument is optional.
getFromSelection
()
CKEDITOR.dom.element
Retrieves a link from the current selection.
Returns:
The retrieved link or null if not found.
remove
-
link -
modifySelection
Removes a link from the editor.
Parameters:
-
linkCKEDITOR.dom.elementThe link element which link style should be removed.
-
modifySelectionObjectA config object with an advance attribute to indicate if the selection should be moved after the link creation.
update
-
link -
attrs -
modifySelection
Updates the href of an already existing link.
Parameters:
-
linkCKEDITOR.dom.elementThe link element which href should be removed.
-
attrsObject | StringThe attributes to update or remove. Attributes with null values will be removed.
-
modifySelectionObjectA config object with an advance attribute to indicate if the selection should be moved after the link creation.