TiddlyWiki5/core/modules/macros/link.js

/*\
title: $:/core/modules/macros/link.js
type: application/javascript
module-type: macro

Implements the link macro.

\*/
(function(){

/*jslint node: true, browser: true */
/*global $tw: false */
"use strict";

var isLinkExternal = function(to) {
	var externalRegExp = /(?:file|http|https|mailto|ftp|irc|news|data):[^\s'"]+(?:\/|\b)/i;
	return externalRegExp.test(to);
};

exports.info = {
	name: "link",
	params: {
		to: {byName: "default", type: "tiddler", skinny: true},
		space: {byName: true, type: "text"}
	},
	events: ["click"]
};

exports.handleEvent = function (event) {
	if(event.type === "click") {
		if(isLinkExternal(this.params.to)) {
			event.target.setAttribute("target","_blank");
			return true;
		} else {
			var navEvent = document.createEvent("Event");
			navEvent.initEvent("tw-navigate",true,true);
			navEvent.navigateTo = this.params.to;
			navEvent.navigateFrom = this;
			event.target.dispatchEvent(navEvent); 
			event.preventDefault();
			return false;
		}
	}
};

exports.executeMacro = function() {
	// Assemble the information about the link
	var linkInfo = {
		to: this.params.to,
		space: this.params.space
	};
	// Generate the default link characteristics
	linkInfo.isExternal = isLinkExternal(linkInfo.to);
	if(!linkInfo.isExternal) {
		linkInfo.isMissing = !this.wiki.tiddlerExists(linkInfo.to);
	}
	linkInfo.attributes = {
		href: linkInfo.to
	};
	if(!linkInfo.isExternal) {
		linkInfo.attributes.href = encodeURIComponent(linkInfo.to);
	}
	// Generate the default classes for the link
	linkInfo.attributes["class"] = ["tw-tiddlylink"];
	if(linkInfo.isExternal) {
		linkInfo.attributes["class"].push("tw-tiddlylink-external");
	} else {
		linkInfo.attributes["class"].push("tw-tiddlylink-internal");
		if(linkInfo.isMissing) {
			linkInfo.attributes["class"].push("tw-tiddlylink-missing");
		} else {
			linkInfo.attributes["class"].push("tw-tiddlylink-resolves");
		}
	}
	if(this.classes) {
		$tw.utils.pushTop(linkInfo.attributes["class"],this.classes);
	}
	// Create the link
	var child;
	if(linkInfo.suppressLink) {
		child = $tw.Tree.Element("span",{},this.content);
	} else { 
		child = $tw.Tree.Element("a",linkInfo.attributes,this.content);
	}
	child.execute(this.parents,this.tiddlerTitle);
	return child;
};

})();