From 6a75a62b16db2c9fdbdee3a1a958b021aacf7215 Mon Sep 17 00:00:00 2001 From: Jeremy Ruston Date: Mon, 5 Aug 2013 20:19:43 +0100 Subject: [PATCH] Docs update --- editions/tw5.com/tiddlers/concepts/LazyLoading.tid | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 editions/tw5.com/tiddlers/concepts/LazyLoading.tid diff --git a/editions/tw5.com/tiddlers/concepts/LazyLoading.tid b/editions/tw5.com/tiddlers/concepts/LazyLoading.tid new file mode 100644 index 000000000..ca494aaf7 --- /dev/null +++ b/editions/tw5.com/tiddlers/concepts/LazyLoading.tid @@ -0,0 +1,6 @@ +title: LazyLoading +modified: 201308051412 + +TiddlyWiki5 currently only implements lazy loading when its running in the browser talking to a TiddlyWeb-compatible server. When it syncs, it first requests a "skinny" version of each tiddler (consisting of all the fields apart from the text field). An attempt to read those skinny tiddlers with `wiki.getTiddler()` returns just the skinny fields, but an attempt to read one using `wiki.getTiddlerText()` will trigger an asynchronous load of the full tiddler text, which in turn triggers a refresh cycle, updating the display to reflect the newly loaded tiddler. Widgets that loop through all tiddlers are fine; it's only if they trigger `wiki.getTiddlerText()` for a tiddler that it will get loaded. + +So, the browser-based search built into TiddlyWiki5 will only search the text of tiddlers that have been fully loaded. The expectation is that when lazy loading is used in a client-server configuration, then it's the server that really needs to handle search operations, because it's only the server that can "see" the text of all tiddlers. So, the plan is to integrate TW's built in search with TiddlyWeb's search API. The simplest approach is that any local search triggers an asynchronous server side search. The results of the search would be asynchronously loaded such that they would dynamically appear in the local search results.