> tiddler.place
> where place can be title , text , tags
Nope.
'tiddler' is one variable
'place' is a completely separate variable
The 'tiddler' variable refers to a TiddlyWiki-defined data store
object
The 'place' variable refers to a browser-created DOM (Document Object
Model) element
Each of these objects contains several named 'properties'. For
example, the tiddler object has these properties:
title, text, tags, created, modified, modifier, fields
To refer to the value of an object property, you join the object and
property names with a "."
Thus, for a given tiddler:
tiddler.title = text for tiddler's title
tiddler.text = text for tiddler's source content (TW wiki syntax)
tiddler.tags = array of text, each one a tag value, referenced like
this:
tiddler.tags.length = number of tags in array
tiddler.tags[0] = text of first tag
tiddler.tags[1] = text of second tag
etc
tiddler.modifier = TW username of last person to edit tiddler
tiddler.created and tiddler.modified = date 'timestamp' numbers,
using format "YYYYMMDDhhmmssnnnn" (year, month, day, hour, minute,
second, millisecond)
tiddler.fields = another object within the tiddler. This object is
a container for any non-standard 'tiddler fields' (typically added to
the tiddler by using a custom EditTemplate definition or automatically
added/maintained by some plugin), referenced by
"tiddler.fields.somefieldname"
In comparison to the tiddler object, which is defined and created by
the TW core, DOM elements are the internal browser storage of the data
needed to layout and draw the current window contents (including
content currently scrolled from view).
In the context of TW macros, the 'place' DOM element object defines
the location into which the macro should generate it's output (if
any). For example, you can write a macro that renders wiki-formatted
results by invoking this TW core function:
wikify("wiki syntax goes here",place);
The first parameter is the tiddler source syntax that is parsed by the
wikify() 'engine', which generates DOM elements that are appended to
the current 'place' so that the browser will display them.
Once they are created, the DOM elements and their properties are all
managed by the browser itself when it renders content. You can
examine *and modify* many of these DOM object properties to affect
changes to the current display. One of the more useful properties of
most DOM objects is "style" (e.g., "place.style"). This property is
actually another object itself, containing properties that define the
CSS settings for that particular DOM element.
For example,
place.style.display
can be set to one of three values:
"none" (hides the element),
"inline" (flowed content, like text-wrapped words),
or "block" (linebreaks immediately before/after content -- i.e., a
separate paragraph)
Another good example of a CSS property you can change is:
place.style.color
which determines the color of the displayed text by setting it to
either a pre-defined color name, e.g.:
place.style.color="blue";
or using '#rgb' syntax to specify the desired color using hexadecimal
numbers, like this:
place.style.color="#AA33DD"
(where "AA" is the intensity of red, "33" is the intensity of
green, and "DD" is the intensity of blue to mix together to produce
the intended text color).
There are LOTS of properties associated with DOM elements (and LOTS
more associated with CSS 'style' objects), so any kind of
comprehensive overview of what you can do with these values is *way*
beyond the scope of this response. Nonetheless, I hope that the above
explanation has given you enough background info to help build a
better picture of how things work inside TW, and leaves you excited
and informed, rather than bewildered and intimidated.
enjoy,
-e
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"TiddlyWiki" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to
[email protected]
For more options, visit this group at
http://groups.google.com/group/tiddlywiki?hl=en
-~----------~----~----~----~------~----~------~--~---
