Skip to content

Repository files navigation

linkify-urls

Linkify URLs in a string

Install

npm install linkify-urls

Usage

import{linkifyUrlsToHtml,linkifyUrlsToDom}from'linkify-urls';linkifyUrlsToHtml('See https://sindresorhus.com',{attributes: {class: 'unicorn',one: 1,foo: true,multiple: ['a','b']}});//=> 'See <a href="https://sindresorhus.com" class="unicorn" one="1" foo multiple="a b">https://sindresorhus.com</a>'// In the browserconstfragment=linkifyUrlsToDom('See https://sindresorhus.com',{attributes: {class: 'unicorn',}});document.body.appendChild(fragment);

API

linkifyUrlsToHtml(string, options?)

Returns an HTML string like 'Visit <a href="https://example.com">https://example.com</a>'.

string

Type: string

A string with URLs to linkify.

options

Type: object

attributes

Type: object

HTML attributes to add to the link.

value

Type: string | Function
Default: The URL

Set a custom HTML value for the link.

If it's a function, it will receive the URL as a string:

linkifyUrlsToHtml('See https://sindresorhus.com/foo',{value: url=>newURL(url).pathname});//=> 'See <a href="https://sindresorhus.com/foo">/foo</a>'

linkifyUrlsToDom(string, options?)

Returns a DocumentFragment ready to be appended in a DOM safely, like DocumentFragment(TextNode('Visit '), HTMLAnchorElement('https://example.com')).

This type only works in the browser.

options

See options above.

Related

About

Linkify URLs in a string

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages