TiddlyWiki5/editions/tw5.com/tiddlers/mechanisms/DraftMechanism.tid

title: DraftMechanism
modified: 201308201324
tags: Mechanisms

Tiddlers that have a `draft.of` field are treated as pending drafts of the tiddler specified in the field. Draft tiddlers should also have a `draft.title` field that specifies the title that will be given to the tiddler when it is saved.

Several features work in concert to give the desired behaviour for draft tiddlers:

* The ListWidget can optionally render draft tiddlers through a different template
* The NavigatorWidget incorporates handlers for the following events:
** `tm-new-tiddler` for creating a new tiddler in draft mode
** `tm-edit-tiddler` for moving a tiddler into edit mode 
** `tm-cancel-tiddler` for cancelling a tiddler out of edit mode
** `tm-save-tiddler` for saving a draft tiddler
* Draft tiddlers are automatically excluded from search operations
Docs updates 2013-08-20 14:18:15 +00:00			`title: DraftMechanism`
			`modified: 201308201324`
Add mechanisms to the reference docs 2014-09-11 19:12:25 +00:00			`tags: Mechanisms`
Docs updates 2013-08-20 14:18:15 +00:00
			Tiddlers that have a `draft.of` field are treated as pending drafts of the tiddler specified in the field. Draft tiddlers should also have a `draft.title` field that specifies the title that will be given to the tiddler when it is saved.

			`Several features work in concert to give the desired behaviour for draft tiddlers:`

			`* The ListWidget can optionally render draft tiddlers through a different template`
			`* The NavigatorWidget incorporates handlers for the following events:`
Rename "tw-" messages to "tm-" 2014-08-28 20:43:44 +00:00			** `tm-new-tiddler` for creating a new tiddler in draft mode
			** `tm-edit-tiddler` for moving a tiddler into edit mode
			** `tm-cancel-tiddler` for cancelling a tiddler out of edit mode
			** `tm-save-tiddler` for saving a draft tiddler
Docs updates 2013-08-20 14:18:15 +00:00			`* Draft tiddlers are automatically excluded from search operations`