Linkify
Linkify is a small yet comprehensive JavaScript plugin for finding URLs in plain-text and converting them to HTML links. It works with all valid URLs and email addresses.
A build repository is maintained here.
Jump to
- Features
- Demo
- Installation and Usage
- Internet Explorer
- Downloads
- API Documentation
- Caveats
- Contributing
- License
Features
- Accuracy
Linkify uses a (close to) complete list of valid top-level domains to ensure that only valid URLs and email addresses are matched. - Speed
Each string is analyzed exactly once to detect every kind of linkable entity - Extensibility
Linkify is designed to be fast and lightweight, but comes with a powerful plugin API that lets you detect even more information like #hashtags and @mentions. - Small footprint
Linkify and its jQuery interface clock in at approximately 15KB minified (5KB gzipped) - approximately 50% the size of Twitter Text - Modern implementation
Linkify is written in ECMAScript6 and compiles to ES5 for modern JavaScript runtimes.- Linkify is compatible with all modern browsers, as well as Internet Explorer 8 and up.
Demo
Installation and Usage
Download the latest release, or install via NPM
npm install linkifyjs
or Bower
bower install linkifyjs
Quick Start
Add linkify and linkify-jquery to your HTML following jQuery:
Note: A polyfill is required for Internet Explorer 8.
Find all links and convert them to anchor tags
;;
Find all links in the given string
linkify;
Returns the following array
type: 'url' value: 'github.com' href: 'http://github.com' type: 'email' value: 'test@example.com' href: 'mailto:test@example.com'
Node.js/Browserify
var linkify = ;linkify; // optionalvar linkifyHtml = ;
Example string usage
;
Returns the following string
'The site <a href="https://github.com">github.com</a> is <a href="#awesome">#awesome</a>.'
AMD
<!-- optional -->
; ;
Note that if you are using linkify-jquery.amd.js
, a jquery
module must be defined.
Browser globals
linkify; // true ReactDOM;
Internet Explorer
Linkify natively supports Internet Explorer 9 and above. Internet Explorer 8 is supported with a polyfill.
You can use either es5-shim (sham also required) or the provided linkify-polyfill.js
:
<!--[if IE 8]><script src="linkify-polyfill.js"></script><![endif]-->
Downloads
Download the latest release or clone the build repository.
linkify (required)
.min.js
· .js
· .amd.min.js
· .amd.js
Plugins (optional)
- hashtag
.min.js
·.js
·.amd.min.js
·.amd.js
Interfaces (recommended - include at least one)
- react
.min.js
·.js
·.amd.min.js
·.amd.js
- jquery
.min.js
·.js
·.amd.min.js
·.amd.js
- html
.min.js
·.js
·.amd.min.js
·.amd.js
- element (Included with linkify-jquery)
.min.js
·.js
·.amd.min.js
·.amd.js
- string
.min.js
·.js
·.amd.min.js
·.amd.js
API Documentation
View full documentation at soapbox.github.io/linkifyjs/docs/.
Caveats
The core linkify library (excluding plugins) attempts to find emails and URLs that match RFC specifications. However, it doesn't always get it right.
Here are a few of the known issues.
- Non-standard email local parts delimited by " (quote characters)
- Emails with quotes in the localpart are detected correctly, unless the quotes contain certain characters like
@
.
- Emails with quotes in the localpart are detected correctly, unless the quotes contain certain characters like
- Slash characters in email addresses
- Non-latin domains or TLDs are not supported (support may be added via plugin in the future)
Contributing
Check out CONTRIBUTING.md.
License
MIT
Authors
Linkify is built with Love™ and maintained by SoapBox Innovations.