Differences

This shows you the differences between two versions of the page.

--- dev:client_coding:changes_in_zotero_2.1_and_zotero_standalone [2011/07/24 22:19] – simon
+++ dev:client_coding:changes_in_zotero_2.1_and_zotero_standalone [2011/08/21 04:35] – simon
@@ Line 36: / Line 36: @@
 ===== Locate Engines =====
-Zotero 2.1b6 and later support extensible locate engines. For further details, see [[Creating Locate Engines using OpenSearch]].
+Zotero 2.1b6 and later support extensible locate engines. For further details, see [[dev:creating_locate_engines_using_opensearch|Creating Locate Engines using OpenSearch]].
 ====== Changes in Zotero 2.1.9 (not yet released) ======
@@ Line 47: / Line 47: @@
     * <code>Zotero.Utilities.xpath(element, xpath[, namespaces])</code> Accepts a DOM element, document, or array of elements or documents and evaluates an XPath, optionally interpreting namespace prefixes using a object whose keys correspond to namespace prefixes and whose values correspond to namespace URIs. The result is an array of nodes matching the XPath.
     * <code>Zotero.Utilities.xpathText(element, xpath[, namespaces[, delimiter]])</code> Behaves similarly to Zotero.Utilities.xpath, but the result is the textContent of all matching nodes, joined by a delimiter if more than one node matched. If no delimiter is specified, ", " is used.
-====== Changes in Zotero 2.2 ======
-  * Calling Zotero.done() and Zotero.wait() during translation is no longer necessary. Zotero.done() is still used to indicate item type in translators that implement asynchronous detection (currently only unAPI).
-====== Changes for Zotero Connectors ======
-===== Changes to translators =====
-Zotero Everywhere will soon allow translators to operate outside of Firefox/XULRunner. Legacy translators can still run inside Zotero Standalone, but will require that Zotero Standalone is running to operate. This will require the following code changes:
-  * Firefox-specific JavaScript, with the exception of "for each", must be avoided. This includes
-    * array comprehensions
-    * destructuring assignment
-    * several other features
-  * E4X functionality is not available. As of Zotero 2.1b6, Zotero also offers DOM XML interfaces to translators. Current trunk builds offer cross-browser utility functions for working with XPaths detailed above, which greatly simplify migration away from E4X.
-  * Zotero.Utilities.retrieveDocument() and Zotero.Utilities.retrieveSource() should be avoided. Zotero.Utilities.retrieveDocument() will throw an error outside of Firefox, whereas Zotero.Utilities.retrieveSource() will freeze the main thread and will not work across domains. Code should be rewritten to use Zotero.Utilities.processDocuments(), Zotero.Utilities.HTTP.doGet(), or Zotero.Utilities.HTTP.doPost(), which remain available in all environments.
-  * Translate#getTranslatorObject() should now be called with a callback function as an argument, which will receive the translator object when it is available. This is backwards compatible with Zotero 2.1b6 and later.
-    * In Chrome and Safari, the "exports" object is exposed to other translators, rather than the entire translator sandbox. Any variables or functions that need to be accessible to other translators should be properties or methods of this object. In Zotero 2.1.9 and later, Translate#getTranslatorObject() will always return the "exports" object if it has properties.
-  * Translators should not expect a return value from Translate#getTranslators(). Instead, they should register a "translators" handler, which will receive the list of translators as the second argument. This is backwards compatible with Zotero 1.0 and later.
-  * Zotero.selectItems() should now be called with a callback function as an argument, which will receive the list of selected items when it is available. Translators may still use Zotero.selectItems() synchronously, but this will require that the first part of the translator be executed twice. This is backwards compatible with Zotero 2.1b6 and later.