документация extjs для декларативного синтаксиса

Question

Мне очень тяжело читать документацию по extjs. До сих пор я выполнил пару успешных проектов в extjs, но все еще не могу прочитать документацию. Кажется, он написан в императивном стиле, но все примеры предполагают декларативный синтаксис.

Например, если бы я добавил вкладку в TabPanel, я бы ожидал увидеть в документах функцию addTab, которая принимает имя вкладки и панель, как и большинство других библиотек пользовательского интерфейса, которые я использовал (например, Qt или Swing). Вместо этого я вижу функцию, подобную add, которая принимает словарь значений, который, кажется, не документирован в самих документах.

В примере в extjs 3 документа для TabPanel:

var tb = new Ext.Toolbar();
tb.render(document.body);  // toolbar is rendered
tb.add({text:'Button 1'}); // add multiple items (defaultType for Toolbar is 'button')
tb.add({text:'Button 2'});
tb.doLayout();             // refresh the layout

В этом примере, где задокументирован параметр text? Я видел примеры добавления поля items, которое я использовал ранее, но что, если я просто хочу добавить существующую панель? Я предполагаю, что это какое-то другое ключевое слово, верно? Где эти вещи документированы?

Answer 1

То, что вы предоставляете через add (), является конфигурацией компонента (или экземпляром компонента, если он у вас есть). «DefaultType is button» означает, что по умолчанию он будет обрабатывать ваши конфиги (которые вы передаете, чтобы добавить между {}) как конфиги кнопок, если вы не укажете что-то еще через атрибут xtype.

Так что в этом случае tb.add({text:'Button 1'});, чтобы узнать, что означает text, вам нужно взглянуть на документацию кнопки (раздел конфигурации)