mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-12-26 10:00:34 +00:00
89 lines
3.0 KiB
JavaScript
89 lines
3.0 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 utils = require("../Utils.js");
|
|
|
|
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", optional: true},
|
|
template: {byName: true, type: "tiddler", optional: true},
|
|
"with": {byName: true, type: "text", optional: true, dependentAll: true}
|
|
},
|
|
render: function(type,tiddler,store,params) {
|
|
var renderTitle = params.template,
|
|
renderAs = params.target;
|
|
// Slightly bewildering logic to sort out the optional parameters
|
|
if(renderAs === undefined) {
|
|
if(renderTitle === undefined) {
|
|
return "";
|
|
} else {
|
|
renderAs = tiddler.title;
|
|
}
|
|
} else {
|
|
if(renderTitle === undefined) {
|
|
renderTitle = renderAs;
|
|
}
|
|
}
|
|
if(params["with"]) {
|
|
// Parameterised transclusion
|
|
var targetTiddler = store.getTiddler(renderTitle),
|
|
text = targetTiddler.text;
|
|
var withTokens = [params["with"]];
|
|
for(var t=0; t<withTokens.length; t++) {
|
|
var placeholderRegExp = new RegExp("\\$"+(t+1),"mg");
|
|
text = text.replace(placeholderRegExp,withTokens[t]);
|
|
}
|
|
return store.renderText(targetTiddler.type,text,type,renderAs);
|
|
} else {
|
|
// There's no parameterisation, so we can just render the target tiddler directly
|
|
return store.renderTiddler(type,renderTitle,renderAs);
|
|
}
|
|
}
|
|
};
|
|
|
|
})();
|