Миграция виджета с версий 2.0 до версии 3.0

Версия 3.0 виджета привносит много крупных изменений в код и логику работы самого виджета.

Отличия нового виджета

Основные концептуальные отличия от предыдущей версии:

• Использования JS API Яндекс.Карт 3.0
• Использование Reset CSS технологии
• Изменение логики работы строки поиска
• Изменение дизайна виджета
• Отказ от использования jQuery и сопутствующих ему плагинов в качестве внешних зависимостей
• Сборка кода виджета в виде umd модуля

Для корректной миграции с предыдущей версии необходимо использовать новый адрес подключения скрипта.

Tip

Подробнее можно прочитать на странице Установка 3.0

Было также изменено название базового класса виджета с ISDEKWidjet на CDEKWidget, соответственно к странице его надо подключать как

const widget = new window.CDEKWidget({ ... });

Помимо переименования класса, поменялись входные параметры виджета, а также добавились новые:

Было	Стало
link	root
apikey	apiKey
choose	canChoose
servicepath	servicePath
hidecash	hideFilters.have_cash
hidedress	hideFilters.is_dressing_room
hidedelt	hideDeliveryOptions
showLogs	debug
defaultCity	defaultLocation

Tip

С полным списком параметров можно ознакомиться на странице Настройка 3.0

Warning

Вместо одного параметра, прячущего всю доставку теперь указывается объект, позволяющий спрятать методы доставки по отдельности, а не только вместе

Помимо параметров, был изменен список событий, которые отдает виджет. Теперь их только три: onReady, onCalculate, onChoose.

Также были изменены названия методов, отвечающих за добавления груза к калькулятору для расчета.

Tip

Подробнее можно прочитать на странице Настройка 3.0

Было	Стало
cargo.add	addParcel
cargo.get	getParcels
cargo.reset	resetParcels

А вес посылки теперь указывается не в килограммах, а в граммах.