mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-12-29 03:20:27 +00:00
100 lines
3.4 KiB
JavaScript
100 lines
3.4 KiB
JavaScript
/*\
|
|
title: js/macros/tiddler.js
|
|
|
|
The tiddler macros transcludes another macro into the tiddler being rendered.
|
|
|
|
Parameters:
|
|
target: the title of the tiddler to transclude
|
|
template: the title of the tiddler to use as a template for the transcluded tiddler
|
|
with: optional parameters to be substituted into the rendered tiddler
|
|
|
|
The simplest case is to just supply a target tiddler:
|
|
|
|
<<tiddler Foo>> or <<transclude target:Foo>>
|
|
|
|
This will render the tiddler Foo within the current tiddler. If the tiddler Foo includes
|
|
the view macro (or other macros that reference the fields of the current tiddler), then the
|
|
fields of the tiddler Foo will be accessed.
|
|
|
|
If you want to transclude the tiddler as a template, so that the fields referenced by the view
|
|
macro are those of the tiddler doing the transcluding, then you can instead specify the tiddler
|
|
as a template:
|
|
|
|
<<tiddler template:Foo>>
|
|
|
|
The effect is the same as the previous example: the text of the tiddler Foo is rendered. The
|
|
difference is that the view macro will access the fields of the tiddler doing the transcluding.
|
|
|
|
The `target` and `template` parameters may be combined:
|
|
|
|
<<tiddler target:Foo template:Bar>>
|
|
|
|
Here, the text of the tiddler `Bar` will be transcluded, with the macros within it accessing the fields
|
|
of the tiddler `Foo`.
|
|
|
|
Finally, the `with` parameter is used to substitute values for the special markers $1, $2, $3 etc. The
|
|
substitutions are performed on the tiddler whose text is being rendered: either the tiddler named in
|
|
the `template` parameter or, if that parameter is missing, the tiddler named in the `target` parameter.
|
|
|
|
\*/
|
|
(function(){
|
|
|
|
/*jslint node: true */
|
|
"use strict";
|
|
|
|
var Renderer = require("../Renderer.js").Renderer;
|
|
|
|
exports.macro = {
|
|
name: "tiddler",
|
|
types: ["text/html","text/plain"],
|
|
cascadeParams: true, // Cascade names of named parameters to following anonymous parameters
|
|
params: {
|
|
target: {byName: "default", type: "tiddler"},
|
|
template: {byName: true, type: "tiddler"},
|
|
"with": {byName: true, type: "text", dependentAll: true}
|
|
},
|
|
execute: function(macroNode,tiddler,store) {
|
|
var renderTitle = macroNode.params.target,
|
|
renderTemplate = macroNode.params.template,
|
|
content,
|
|
contentClone = [],
|
|
t,
|
|
parents = macroNode.parents.slice(0);
|
|
if(typeof renderTitle !== "string") {
|
|
renderTitle = tiddler.title;
|
|
}
|
|
if(typeof renderTemplate !== "string") {
|
|
renderTemplate = renderTitle;
|
|
}
|
|
if(parents.indexOf(renderTemplate) === -1) {
|
|
if("with" in macroNode.params) {
|
|
// Parameterised transclusion
|
|
var targetTiddler = store.getTiddler(renderTemplate),
|
|
text = targetTiddler.text;
|
|
var withTokens = [macroNode.params["with"]];
|
|
for(t=0; t<withTokens.length; t++) {
|
|
var placeholderRegExp = new RegExp("\\$"+(t+1),"mg");
|
|
text = text.replace(placeholderRegExp,withTokens[t]);
|
|
}
|
|
content = store.parseText(targetTiddler.type,text).tree;
|
|
} else {
|
|
// There's no parameterisation, so we can just render the target tiddler directly
|
|
var parseTree = store.parseTiddler(renderTemplate);
|
|
content = parseTree ? parseTree.tree : [];
|
|
}
|
|
} else {
|
|
content = [Renderer.TextNode("{{** Tiddler recursion error in <<tiddler>> macro **}}")];
|
|
}
|
|
parents.push(renderTemplate);
|
|
for(t=0; t<content.length; t++) {
|
|
contentClone.push(content[t].clone());
|
|
}
|
|
for(t=0; t<contentClone.length; t++) {
|
|
contentClone[t].execute(parents,store.getTiddler(renderTitle));
|
|
}
|
|
return contentClone;
|
|
}
|
|
};
|
|
|
|
})();
|