Функции утилиты Marionette

Marionette предоставляет набор утилит/функций-помощников, которые используются для облегчения общих действий во всем фреймворке. Эти функции могут быть полезны тем, кто строит на основе Marionette, поскольку они предоставляют способ получить те же действия и соглашения из собственного кода.

Индекс документации

• extend
• Общие утилиты методов
• VERSION

extend

Функция extend Backbone — полезная утилита, используемая в различных местах в Marionette. Чтобы сделать использование этого метода более согласованным, extend Backbone был экспортирован extend. Это позволяет получить функциональность extend для вашего объекта, не определяя, хотите ли вы использовать Backbone.View или Backbone.Model или другой объект Backbone для извлечения метода.

import { extend } from 'backbone.marionette';

const Foo = function(){};

// use Marionette.extend to make Foo extendable, just like other
// Backbone and Marionette objects
Foo.extend = extend;

// Now Foo can be extended to create a new class, with methods
const Bar = Foo.extend({

  someMethod(){ ... }

  // ...
});

// Create an instance of Bar
const b = new Bar();

Пример работы

Общие утилиты методов

Эти общие утилиты доступны для всех классов Marionette и экспортированы, чтобы функциональность могла использоваться где-либо еще. Каждый метод имеет те же аргументы, что и в документации общих утилит, за исключением того, что целевой объект добавляется в качестве первого аргумента.

Например:

import { View, triggerMethod, getOption } from 'backbone.marionette';

const MyView = View.extend({
  initialize() {
    this.triggerMethod('foo', this.getOption('foo'));
  },
  onFoo() {
    console.log('bar');
  }
});

// logs "bar"
const myView = new MyView({ foo: 'bar' });

// Same as initialize, logs "bar"
triggerMethod(myView, 'foo', getOption(myView, 'foo'));

• triggerMethod
  • Срабатывает событие и соответствующий метод в целевом объекте.
• bindEvents
  • Этот метод используется для привязки «сущности» backbone к методам целевого объекта.
• unbindEvents
  • Этот метод можно использовать для отмены привязки обратных вызовов к событиям сущностей.
• bindRequests
  • Этот метод используется для привязки ответов backbone radio к методам целевого объекта.
• unbindRequests
  • Этот метод можно использовать для отмены привязки обработчика ответов радио к событиям сущностей.
• normalizeMethods
  • Получает хеш имен событий и функций/имен функций и возвращает тот же хеш с именами функций, замененными на ссылки на функции.
• getOption
  • Извлекает атрибут объекта либо непосредственно из объекта, либо из this.options объекта.
• mergeOptions
  • Удобная функция для извлечения определённых options и их непосредственного присоединения к экземпляру.

VERSION

Сохраняет ссылку на версию экземпляра Marionette. VERSION используется для перенаправления пользователей к правильному документу версии при возникновении ошибок.