diff --git a/README.md b/README.md index 6710e80d..89e5e8ba 100644 --- a/README.md +++ b/README.md @@ -475,4 +475,8 @@ This is useful when the document needs to be changed programmatically, but those ### linkRegExp -This is the regular expression used to automatically mark up links when inserting HTML or after pressing space. You can change it if you want to use a custom regular expression for detecting links, or set to `/[]/` to turn off link detection. +This is the regular expression used to automatically mark up links when inserting HTML or after pressing space. You can change it if you want to use a custom regular expression for detecting links, or set to `/[]/` to turn off link detection. To append to the existing regex, set it to `linkRegExp.source + '|' + newLinkRegExp`. For compatibility with linkRegExpHandlers use named capture groups (`?`). + +### linkRegExpHandlers + +This is a map of handlers for different types of matches in linkRegExp. For example, linkRegExp has a named group 'url' that matches urls, and a named group 'email' that matches emails. linkRegExpHandler['url'] and linkRegExpHandler['email'] are functions that take in the matching string and returns what the link should have in its 'href'. diff --git a/source/Editor.ts b/source/Editor.ts index 0440229d..c97ba763 100644 --- a/source/Editor.ts +++ b/source/Editor.ts @@ -1741,7 +1741,7 @@ class Squire { // Only look on boundaries '\\b(?:' + // Capture group 1: URLs - '(' + + '(?' + // Add links to URLS // Starts with: '(?:' + @@ -1775,7 +1775,7 @@ class Squire { '\\([^\\s()<>]+\\)' + ')' + // Capture group 2: Emails - ')|(' + + ')|(?' + // Add links to emails '[\\w\\-.%+]+@(?:[\\w\\-]+\\.)+[a-z]{2,}\\b' + // Allow query parameters in the mailto: style @@ -1788,8 +1788,12 @@ class Squire { ); */ linkRegExp = - /\b(?:((?:(?:ht|f)tps?:\/\/|www\d{0,3}[.]|[a-z0-9][a-z0-9.\-]*[.][a-z]{2,}\/)(?:[^\s()<>]+|\([^\s()<>]+\))+(?:[^\s?&`!()\[\]{};:'".,<>«»“”‘’]|\([^\s()<>]+\)))|([\w\-.%+]+@(?:[\w\-]+\.)+[a-z]{2,}\b(?:[?][^&?\s]+=[^\s?&`!()\[\]{};:'".,<>«»“”‘’]+(?:&[^&?\s]+=[^\s?&`!()\[\]{};:'".,<>«»“”‘’]+)*)?))/i; - + /\b(?:(?(?:(?:[a-z+]+:)?\/\/|www\d{0,3}[.]|[a-z0-9][a-z0-9.\-]*[.][a-z]{2,}\/)(?:[^\s()<>]+|\([^\s()<>]+\))+(?:[^\s?&`!()\[\]{};:'".,<>«»“”‘’]|\([^\s()<>]+\)))|(?[\w\-.%+]+@(?:[\w\-]+\.)+[a-z]{2,}\b(?:[?][^&?\s]+=[^\s?&`!()\[\]{};:'".,<>«»“”‘’]+(?:&[^&?\s]+=[^\s?&`!()\[\]{};:'".,<>«»“”‘’]+)*)?))/i; + linkRegExpHandlers = { + 'url': (m) => {return /^(?:[a-z+]+:)?\/\//i.test(m) + ? m : 'https://' + m}, + 'email': (m) => {return 'mailto:' + m}, + 'default': (m) => {return m}}; addDetectedLinks( searchInNode: DocumentFragment | Node, root?: DocumentFragment | HTMLElement, @@ -1815,15 +1819,14 @@ class Squire { node, ); } + let handler = Object.keys(this.linkRegExpHandlers).filter( + key => Object.keys(match.groups).includes(key) && match.groups[key])[0] + || 'default'; const child = createElement( 'A', Object.assign( { - href: match[1] - ? /^(?:ht|f)tps?:/i.test(match[1]) - ? match[1] - : 'http://' + match[1] - : 'mailto:' + match[0], + href: this.linkRegExpHandlers[handler](match[0]) }, defaultAttributes, ), diff --git a/test/squire.spec.ts b/test/squire.spec.ts index ad978cfa..38f72510 100644 --- a/test/squire.spec.ts +++ b/test/squire.spec.ts @@ -472,9 +472,9 @@ describe('Squire RTE', () => { 'https://google.com': 'https://google.com/', 'https://www.google.com': 'https://www.google.com/', 'https://www.google.com/': 'https://www.google.com/', - 'https://google.com/?': 'https://google.com/', - 'https://google.com?': 'https://google.com/', - 'https://google.com?a': 'https://google.com/?a', + 'HTTPS://google.com/?': 'https://google.com/', // Test protocol matching + 'ftp://google.com?': 'ftp://google.com/', // Test protocol matching + 'redis://google.com?a': 'redis://google.com?a', // Test protocol matching 'https://google.com?a=': 'https://google.com/?a=', 'https://google.com?a=b': 'https://google.com/?a=b', 'https://google.com?a=b?': 'https://google.com/?a=b', @@ -486,10 +486,15 @@ describe('Squire RTE', () => { 'https://google.com?a=b&c=d&': 'https://google.com/?a=b&c=d', 'https://google.com?a=b&c=d&e=': 'https://google.com/?a=b&c=d&e=', 'https://google.com?a=b&c=d&e=f': 'https://google.com/?a=b&c=d&e=f', + 'www.google.com': 'https://www.google.com/', // Test prepending protocol + 'foobar': 'http://localhost/foobar', // Test default handler + 'search': 'http://localhost/replace', // Test custom handler }; Object.keys(LINK_MAP).forEach((input) => { it('should auto convert links to anchor: ' + input, () => { + editor.linkRegExp = new RegExp(editor.linkRegExp.source + "|(foobar)|(?search)", editor.linkRegExp.flags); + editor.linkRegExpHandlers['extra'] = (m) => {return 'replace'}; editor.insertHTML(input); const link = document.querySelector('a')!; expect(link.href).toBe(LINK_MAP[input]);