(Внимание, это черновая версия инструкции!)
_{Хотя другой и не предвидится...}

E4X в ближайшее время будет сначала отключен по умолчанию, а затем удален:

На данный момент в Nightly (Mozilla/5.0 (Windows NT 6.1; rv:18.0) Gecko/18.0 Firefox/18.0) E4X уже отключен для страниц:
javascript.options.xml.chrome = true
javascript.options.xml.content = false

Для проверки работоспособности кнопок надо установить Nightly и выставить обе настройки в false.

Обсуждение и подробности:
на этом форуме
на custombuttons.sf.net

Что перестанет работать:
1. Конструкции вида

var menu = <menupopup xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">
        ...
    </menupopup>;

var menu = cbu.makeXML(
    <menupopup xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">
        ...
    </menupopup>
);

Характерный признак – наличие в коде вызовов cbu.makeXML() или custombuttonsUtils.makeXML(). Или реализация аналога:

var elt = new DOMParser().parseFromString(xml.toXMLString(), "application/xml").documentElement;

То есть в коде таких кнопок обязательно есть makeXML() или toXMLString().

2. Конструкции вида

var str = <><![CDATA[
    ...
    ]]></>
    .toString();

var str = <![CDATA[
    ...
    ]]>
    .toString();

Характерный признак – наличие в коде "<![CDATA[" не внутри "строки" или 'строки'.

3. Нельзя будет работать с глобальным объектом XML – он будет удален.
Перестанут работать записи вида

XML.prettyPrinting = false;
XML.ignoreProcessingInstructions = false;

Характерный признак – наличие "XML.". Впрочем, с XML потом обычно надо что-то сделать, так что все равно будет еще и toXMLString().

4. Нельзя будет работать с xml-объектами.
Выглядит это так:

var xml = <menu />;
xml.@attr = "..."; // Установить атрибут
var val = xml.@attr; // Получить атрибут

Характерный признак – наличие ".@" (см. пример выше).

Исправление
Внимание, в данный момент в Custom Buttons нет API для преобразования строк в XUL-узлы, когда он будет добавлен, лучше использовать его.
Для примера приведен наиболее простой и короткий вариант, возможно, он не будет работать в некоторых сложных случаях.
1. Было:

var xul = <menupopup xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">
        ...
    </menupopup>;
var menu = cbu.makeXML(xul);

var menu = cbu.makeXML(
    <menupopup xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">
        ...
    </menupopup>
);

Стало:

var xul = '<menupopup xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">\n\
        ...\n\
    </menupopup>';
var menu = parseXULFromString(xul);

var menu = parseXULFromString('\
    <menupopup xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">\n\
        ...\n\
    </menupopup>'
);

Плюс надо добавить функцию:

function parseXULFromString(xul) {
    xul = xul.replace(/>\s+</g, "><");
    return new DOMParser().parseFromString(xul, "application/xml").documentElement;
}

То есть нужно привести код к строкам вида

var str = '\
    0123\
    456\
';

или

var str = '\
    0123\n\
    456\n\
';

Таким образом, нужно экранировать каждый перевод строки внутри ' ... ' или " ... ".
\n\ нужно для получения настоящего перевода строки. Это удобнее – при ошибках в коде в консоли ошибок будет указан нормальный номер строки.

При этом внутри строк при конвертировании из XML формата надо экранировать специальные символы:
\ -> \\
' -> \'
(и " -> \", если для создания строки используются двойные кавычки)

Далее E4X позволяет использовать выражения (в фигурных скобках):

var xul = <menupopup xmlns={xulns}>
        <menuitem label={getLabel()} />
    </menupopup>;

С ними немного сложнее. В общем случае нужно еще преобразовывать специальные XML/HTML-символы.
Было:

var xul = <menupopup xmlns={xulns}>
        <menuitem label={getLabel()} />
    </menupopup>;

Без преобразования:

var xul = '<menupopup xmlns="' + xulns + '">\n\
        <menuitem label="' + getLabel() + '" />\n\
    </menupopup>';

С преобразованием:

var xul = '<menupopup xmlns="' + encodeHTML(xulns) + '">\n\
        <menuitem label="' + encodeHTML(getLabel()) + '" />\n\
    </menupopup>';
function encodeHTML(s) {
    return String(s)
        .replace(/&/g, "&amp;")
        .replace(/</g, "&lt;")
        .replace(/>/g, "&gt;")
        .replace(/"/g, "&quot;");
}

И нужно иметь в виду, что при работе со строками будет другой приоритет выполнения операций:
Было:

<menuitem label={ a + b } />

Стало:

'<menuitem label="' + (a + b) + '" />'

или

'<menuitem label="' + encodeHTML(a + b) + '" />'

Для надежности лучше всегда конвертировать специальные символы.
Переводы строк в многострочных выражениях экранировать не надо.

2. Аналогично с CDATA, только тут не нужно парсить строку в DOM-дерево:
Было:

var str = <><![CDATA[
    123
    456
    789
    ]]></>
    .toString();

Стало:

var str = '\
    123\n\
    456\n\
    789';

3. Использование объекта XML надо просто удалить.
В основном, он нужен для удаления пробелов между тэгами и разрешения использования инструкций вида <? ... ?> вроде такой:

<?xml-stylesheet href="chrome://global/skin/" type="text/css"?>

В строках это не требуется, а пробелы должна будет удалять функция-парсер.

4. С атрибутами немного сложнее – нужно сначала откорректировать код, чтобы перед установкой/чтением атрибутов было конвертирование строки в DOM-узлы (в данном случае – вызов parseXULFromString()).
Было:

var node = <menu />;
node.@attr = "val";
...
var domNode = cbu.makeXML(node);

Стало:

var str = "<menu />"; // То есть str – сконвертированное в строку старое объявление node.
var node = parseXULFromString(str);
node.setAttribute("attr", val);
...
// Больше не требуется:
//var domNode = cbu.makeXML(node);

Было:

var node = <menu />;
var val = node.@attr;
...
var domNode = cbu.makeXML(node);

Стало:

var str = "<menu />";
var node = parseXULFromString(str);
var val = node.getAttribute("attr");
...
// Больше не требуется:
//var domNode = cbu.makeXML(node);

И, разумеется, в код должна быть добавлена функция parseXULFromString().

Автоматическое конвертирование:
Convert E4X
Установить | код для секции «код» кнопки
Надо нажать на кнопку, а затем кликнуть по другой кнопке или по открытому во вкладке *.js файлу.
Работа полученных после конвертирования кодов не гарантируется.

Отредактировано Infocatcher (27-06-2013 13:50:26)