Labs/Ubiquity/Ubiquity 0.5 Author Tutorial: Difference between revisions

Labs/Ubiquity/Ubiquity 0.5 Author Tutorial (view source)

379 bytes removed , 29 August 2009

Removed an outdated note.

73

edits

@@ Line 880: / Line 880: @@
 A few notes:
-* The parser's callback function expects only one suggestion (not an array of suggestions), so it must be called one time for each suggestion, even if the noun type has multiple suggestions available at the same time (as in the Freebase example above). This is a bit different from the synchronous case, in which the <code>suggest</code> function is expected to return an array.
 * A noun type's <code>suggest</code> function typically returns an empty array when it intends to make asynchronous suggestions, but it can return one or more suggestions synchronously if it has them available.
 * Because the work being done to generate asynchronous suggestions is generally somewhat expensive, and because a noun type's <code>suggest</code> function may be called for every keystroke the user makes, you should probably consider implementing a delay before starting the work and/or caching the work at some level. Ubiquity currently leaves this up to each noun type individually.