goog.editor.Link

Provided By	`goog.editor.Link`

Wrap an editable link.

new Link( `anchor`, `isNew` )

Parameters

`anchor`	`(HTMLAnchorElement\|null)`
	The anchor element.
`isNew`	`boolean`
	Whether this is a new link.

VIEW SOURCE

Instance Methods

After link creation, finish creating the link depending on the type of link being created.

Parameters

`field`	`(goog.editor.Field\|null)`
	The field where this link is being created.

VIEW SOURCE

Parameters

None.

Returns

(HTMLAnchorElement|null)

The anchor element.

VIEW SOURCE

Parameters

None.

Returns

string

The inner text for the anchor.

VIEW SOURCE

Parameters

None.

Returns

Array<(HTMLAnchorElement|null)>

The extra anchor elements, if any, created by the browser from a selection.

VIEW SOURCE

Parameters

None.

Returns

(string|null)

The modified string for the link if the link text appears to be a valid link. Returns null if this is not a valid link address.

VIEW SOURCE

Set the url without affecting the isNew() status of the link.

Parameters

`url`	`string`
	A URL.

VIEW SOURCE

Parameters

None.

Returns

boolean

Whether the link is new.

VIEW SOURCE

Places the cursor to the right of the anchor. Note that this is different from goog.editor.range's placeCursorNextTo in that it specifically handles the placement of a cursor in browsers that trap you in links, by adding a space when necessary and placing the cursor after that space.

VIEW SOURCE

Removes the link, leaving its contents in the document. Note that this object will no longer be usable/useful after this call.

VIEW SOURCE

Change the link.

Parameters

`newText`	`string`
	New text for the link. If the link contains all its text in one descendant, newText will only replace the text in that one node. Otherwise, we'll change the innerHTML of the whole link to newText.
`newUrl`	`string`
	A new URL.

VIEW SOURCE

Static Functions

Initialize a new link.

Parameters

`anchor`	`(HTMLAnchorElement\|null)`
	The anchor element.
`url`	`string`
	The initial URL.
`opt_target`	`string=`
	The target.
`opt_extraAnchors`	`(Array<(HTMLAnchorElement\|null)>\|null)=`
	Extra anchors created by the browser when parsing a selection.

Returns

goog.editor.Link

The link.

VIEW SOURCE

Initialize a new link using text in anchor, or empty string if there is no likely url in the anchor.

Parameters

`anchor`	`(HTMLAnchorElement\|null)`
	The anchor element with likely url content.
`opt_target`	`string=`
	The target.

Returns

goog.editor.Link

The link.

VIEW SOURCE

Returns true if str could be an email address, false otherwise

Ex: goog.editor.Link.isLikelyEmailAddress_("some word") == false goog.editor.Link.isLikelyEmailAddress_("foo@foo.com") == true

Parameters

`str`	`string`
	String to test for being email address.

Returns

boolean

Whether "str" looks like an email address.

VIEW SOURCE

Returns true if str could be a URL, false otherwise

Ex: TR_Util.isLikelyUrl_("http://www.google.com") == true TR_Util.isLikelyUrl_("www.google.com") == true

Parameters

`str`	`string`
	String to check if it looks like a URL.

Returns

boolean

Whether str could be a URL.

VIEW SOURCE

Determines whether or not a url is an email link.

Parameters

`url`	`string`
	A url.

Returns

boolean

Whether the url is a mailto link.

VIEW SOURCE

goog.editor.Link

new Link( `anchor`, `isNew` )

Instance Methods

`this.`finishLinkCreation( `field` ) `→` `void`

`this.`getAnchor() `→` `(HTMLAnchorElement|null)`

`this.`getCurrentText() `→` `string`

`this.`getExtraAnchors() `→` `Array<(HTMLAnchorElement|null)>`

`this.`getValidLinkFromText() `→` `(string|null)`

`this.`initializeUrl( `url` ) `→` `void`

`this.`isNew() `→` `boolean`

`this.`placeCursorRightOf() `→` `void`

`this.`removeLink() `→` `void`

`this.`setTextAndUrl( `newText`, `newUrl` ) `→` `void`

Static Functions

Link.createNewLink( `anchor`, `url`, `opt_target`, `opt_extraAnchors` ) `→` `goog.editor.Link`

Link.createNewLinkFromText( `anchor`, `opt_target` ) `→` `goog.editor.Link`

Link.isLikelyEmailAddress( `str` ) `→` `boolean`

Link.isLikelyUrl( `str` ) `→` `boolean`

Link.isMailto( `url` ) `→` `boolean`

goog.editor.Link

new Link( anchor, isNew )

Instance Methods

this.finishLinkCreation( field ) → void

this.getAnchor() → (HTMLAnchorElement|null)

this.getCurrentText() → string

this.getExtraAnchors() → Array<(HTMLAnchorElement|null)>

this.getValidLinkFromText() → (string|null)

this.initializeUrl( url ) → void

this.isNew() → boolean

this.placeCursorRightOf() → void

this.removeLink() → void

this.setTextAndUrl( newText, newUrl ) → void

Static Functions

Link.createNewLink( anchor, url, opt_target, opt_extraAnchors ) → goog.editor.Link

Link.createNewLinkFromText( anchor, opt_target ) → goog.editor.Link

Link.isLikelyEmailAddress( str ) → boolean

Link.isLikelyUrl( str ) → boolean

Link.isMailto( url ) → boolean

new Link( `anchor`, `isNew` )

`this.`finishLinkCreation( `field` ) `→` `void`

`this.`getAnchor() `→` `(HTMLAnchorElement|null)`

`this.`getCurrentText() `→` `string`

`this.`getExtraAnchors() `→` `Array<(HTMLAnchorElement|null)>`

`this.`getValidLinkFromText() `→` `(string|null)`

`this.`initializeUrl( `url` ) `→` `void`

`this.`isNew() `→` `boolean`

`this.`placeCursorRightOf() `→` `void`

`this.`removeLink() `→` `void`

`this.`setTextAndUrl( `newText`, `newUrl` ) `→` `void`

Link.createNewLink( `anchor`, `url`, `opt_target`, `opt_extraAnchors` ) `→` `goog.editor.Link`

Link.createNewLinkFromText( `anchor`, `opt_target` ) `→` `goog.editor.Link`

Link.isLikelyEmailAddress( `str` ) `→` `boolean`

Link.isLikelyUrl( `str` ) `→` `boolean`

Link.isMailto( `url` ) `→` `boolean`