2011-12-13 12:30:09 +00:00
|
|
|
/*\
|
|
|
|
title: js/Tiddler.js
|
2011-11-22 14:29:29 +00:00
|
|
|
|
|
|
|
Tiddlers are an immutable dictionary of name:value pairs called fields. Values can be a string, an array
|
2011-12-05 16:50:25 +00:00
|
|
|
of strings, or a date. The only field that is required is the `title` field, but useful tiddlers also
|
|
|
|
have a `text` field, and some of the standard fields `modified`, `modifier`, `created`, `creator`,
|
|
|
|
`tags` and `type`.
|
2011-11-22 14:29:29 +00:00
|
|
|
|
|
|
|
Hardcoded in the system is the knowledge that the 'tags' field is a string array, and that the 'modified'
|
|
|
|
and 'created' fields are dates. All other fields are strings.
|
|
|
|
|
|
|
|
The Tiddler object exposes the following API
|
|
|
|
|
2011-11-30 18:39:39 +00:00
|
|
|
new Tiddler(src) - create a Tiddler given a hashmap of field values or a tiddler to clone
|
|
|
|
new Tiddler(src1,src2) - create a Tiddler with the union of the fields from the
|
|
|
|
sources, with the rightmost taking priority
|
2011-12-05 16:50:25 +00:00
|
|
|
Tiddler.fields - hashmap of tiddler fields, OK for read-only access
|
2011-11-22 14:29:29 +00:00
|
|
|
|
2011-11-30 18:39:39 +00:00
|
|
|
The hashmap(s) can specify the "modified" and "created" fields as strings in YYYYMMDDHHMMSSMMM
|
|
|
|
format or as JavaScript date objects. The "tags" field can be given as a JavaScript array of strings or
|
|
|
|
as a TiddlyWiki quoted string (eg, "one [[two three]]").
|
|
|
|
|
2011-12-13 12:30:09 +00:00
|
|
|
\*/
|
|
|
|
(function(){
|
2011-11-22 14:29:29 +00:00
|
|
|
|
2011-12-09 16:34:02 +00:00
|
|
|
/*jslint node: true */
|
2011-11-30 17:27:00 +00:00
|
|
|
"use strict";
|
|
|
|
|
2011-11-30 19:35:01 +00:00
|
|
|
var utils = require("./Utils.js"),
|
2011-12-05 16:50:25 +00:00
|
|
|
ArgParser = require("./ArgParser.js").ArgParser,
|
|
|
|
WikiTextParser = require("./WikiTextParser.js").WikiTextParser;
|
2011-11-30 19:35:01 +00:00
|
|
|
|
2011-11-22 14:29:29 +00:00
|
|
|
var Tiddler = function(/* tiddler,fields */) {
|
|
|
|
this.fields = {};
|
2011-11-30 18:39:39 +00:00
|
|
|
for(var c=0; c<arguments.length; c++) {
|
|
|
|
var arg = arguments[c],
|
|
|
|
src = null;
|
|
|
|
if(arg instanceof Tiddler) {
|
|
|
|
src = arg.fields;
|
|
|
|
} else {
|
|
|
|
src = arg;
|
|
|
|
}
|
|
|
|
for(var t in src) {
|
2011-12-05 16:50:25 +00:00
|
|
|
var f = this.parseTiddlerField(t,src[t]);
|
2011-11-30 18:39:39 +00:00
|
|
|
if(f !== null) {
|
|
|
|
this.fields[t] = f;
|
|
|
|
}
|
2011-11-22 14:29:29 +00:00
|
|
|
}
|
|
|
|
}
|
2011-11-30 18:39:39 +00:00
|
|
|
};
|
|
|
|
|
2011-12-13 12:30:09 +00:00
|
|
|
Tiddler.standardFields = {
|
|
|
|
title: { type: "string"},
|
|
|
|
modifier: { type: "string"},
|
|
|
|
modified: { type: "date"},
|
|
|
|
creator: { type: "string"},
|
|
|
|
created: { type: "date"},
|
|
|
|
tags: { type: "tags"},
|
|
|
|
type: { type: "string"},
|
|
|
|
text: { type: "string"}
|
|
|
|
}
|
|
|
|
|
|
|
|
Tiddler.isStandardField = function(name) {
|
|
|
|
return name in Tiddler.standardFields;
|
|
|
|
};
|
|
|
|
|
2011-12-08 16:19:19 +00:00
|
|
|
Tiddler.prototype.hasTag = function(tag) {
|
|
|
|
if(this.tags) {
|
|
|
|
for(var t=0; t<this.tags.length; t++) {
|
|
|
|
if(this.tags[t] === tag) {
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return false;
|
|
|
|
};
|
|
|
|
|
2011-12-05 16:50:25 +00:00
|
|
|
Tiddler.prototype.parseTiddlerField = function(name,value) {
|
|
|
|
var type = Tiddler.specialTiddlerFields[name];
|
2011-11-30 18:39:39 +00:00
|
|
|
if(type) {
|
2011-12-05 16:50:25 +00:00
|
|
|
return Tiddler.specialTiddlerFieldParsers[type](value);
|
2011-11-30 18:39:39 +00:00
|
|
|
} else if (typeof value === "string") {
|
|
|
|
return value;
|
|
|
|
} else {
|
|
|
|
return null;
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
|
|
|
// These are the non-string fields
|
2011-12-05 16:50:25 +00:00
|
|
|
Tiddler.specialTiddlerFields = {
|
2011-11-30 18:39:39 +00:00
|
|
|
"created": "date",
|
|
|
|
"modified": "date",
|
|
|
|
"tags": "array"
|
|
|
|
};
|
|
|
|
|
2011-12-05 16:50:25 +00:00
|
|
|
Tiddler.specialTiddlerFieldParsers = {
|
2011-11-30 18:39:39 +00:00
|
|
|
date: function(value) {
|
|
|
|
if(typeof value === "string") {
|
|
|
|
return utils.convertFromYYYYMMDDHHMMSSMMM(value);
|
|
|
|
} else if (value instanceof Date) {
|
|
|
|
return value;
|
|
|
|
} else {
|
|
|
|
return null;
|
|
|
|
}
|
|
|
|
},
|
|
|
|
array: function(value) {
|
|
|
|
if(typeof value === "string") {
|
|
|
|
var parser = new ArgParser(value,{noNames: true});
|
|
|
|
return parser.getValuesByName("","");
|
|
|
|
} else if (value instanceof Array) {
|
|
|
|
var result = [];
|
|
|
|
for(var t=0; t<value.length; t++) {
|
|
|
|
if(typeof value[t] === "string") {
|
|
|
|
result.push(value[t]);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return result;
|
|
|
|
} else {
|
|
|
|
return null;
|
|
|
|
}
|
2011-11-22 14:29:29 +00:00
|
|
|
}
|
2011-11-30 18:39:39 +00:00
|
|
|
};
|
2011-11-22 14:29:29 +00:00
|
|
|
|
|
|
|
exports.Tiddler = Tiddler;
|
2011-12-12 10:52:04 +00:00
|
|
|
|
|
|
|
})();
|