link/utils

@ckeditor/ckeditor5-link/src/utils

Constants

• LINK_KEYSTROKEmodule:link/utils~LINK_KEYSTROKE

  See source

  A keystroke used by the link UI feature.

Classes

• AutomaticDecoratorsmodule:link/utils~AutomaticDecorators

• ManualDecoratormodule:link/utils~ManualDecorator

Functions

• addLinkProtocolIfApplicable() → Stringmodule:link/utils~addLinkProtocolIfApplicable

  See source

  Adds the protocol prefix to the specified link when:

  • it does not contain it already, and there is a defaultProtocol configuration value provided,
  • or the link is an email address.

  Returns

  String

• createLinkElement( href, conversionApi ) → AttributeElementmodule:link/utils~createLinkElement

  See source

  Creates a link AttributeElement with the provided href attribute.

  Parameters

  href : String

  conversionApi : DowncastConversionApi

  Returns

  AttributeElement

• protected

  ensureSafeUrl( url ) → Stringmodule:link/utils~ensureSafeUrl

  See source

  Returns a safe URL based on a given value.

  A URL is considered safe if it is safe for the user (does not contain any malicious code).

  If a URL is considered unsafe, a simple "#" is returned.

  Parameters

  url : *

  Returns

  String

  Safe URL.

• getLocalizedDecorators( t, The ) → Array.<LinkDecoratorDefinition>module:link/utils~getLocalizedDecorators

  See source

  Returns the config.link.decorators configuration processed to respect the locale of the editor, i.e. to display the label in the correct language.

  Note: Only the few most commonly used labels are translated automatically. Other labels should be manually translated in the config.link.decorators configuration.

  Parameters

  t : Locale#t

  shorthand for Locale#t

  The : Array.<LinkDecoratorDefinition>

  decorator reference where the label values should be localized.

  Returns

  Array.<LinkDecoratorDefinition>

• isEmail() → Booleanmodule:link/utils~isEmail

  See source

  Returns true if the specified value is an email.

  Returns

  Boolean

• isLinkElement( node ) → Booleanmodule:link/utils~isLinkElement

  See source

  Returns true if a given view node is the link element.

  Parameters

  node : Node

  Returns

  Boolean

• isLinkableElement() → Booleanmodule:link/utils~isLinkableElement

  See source

  Returns true if the specified element can be linked (the element allows the linkHref attribute).

  Returns

  Boolean

• linkHasProtocol( link ) → Booleanmodule:link/utils~linkHasProtocol

  See source

  Checks if protocol is already included in the link.

  Parameters

  link : String

  Returns

  Boolean

• normalizeDecorators( decorators ) → Array.<LinkDecoratorDefinition>module:link/utils~normalizeDecorators

  See source

  Converts an object with defined decorators to a normalized array of decorators. The id key is added for each decorator and is used as the attribute's name in the model.

  Parameters

  decorators : Object.<String, LinkDecoratorDefinition>

  Returns

  Array.<LinkDecoratorDefinition>

• openLink( link )module:link/utils~openLink

  See source

  Opens the link in a new browser tab.

  Parameters

  link : String