vue-yandex-maps - npm Package Versions

[2.0.0-rc.6]

Улучшения

• Немного улучшена скорость запуска карты
• Снижена вероятность краша карты при медленном интернете

Кластер

Добавлен новый параметр: zoomOnClusterClick! Как следует из названия, при клике на кластер произойдёт автоматический зум.

Из-за поведения Яндекса в зум встроена логика, высчитывающая область таким образом, чтобы маркеры в неё точно пропали, добавляя отступы для области на основе максимального расстояния между углами области.

По сути, пропс возвращает старое поведение кластеров при клике на них, но со своей реализацией. При нахождении багов или недочетов в логике - создавайте ишью!

Пропс принимает boolean или объект с параметрами duration (по умолчанию: 500) и easing.

И, даже если пропс не указан, при клике на кластер компонент теперь возвращает события trueBounds и updatedBounds ( точные и скорректированные координаты области), чтобы упростить свою реализацию этого функционала.

https://github.com/yandex-maps-unofficial/vue-yandex-maps/assets/10450717/bcf0b42c-50f8-4cbe-881c-55f9e74d5f56

[2.0.0-rc.5]

Breaking changes

• Вариации position маркера left и right теперь откидывают на 100% вместо 50%
• В кластере позиция маркеров теперь по умолчанию top-center left-center (то есть ровно по центру кружочка, которым обычно является маркер)
  • Вы можете изменить это поведение, передав position в clusterMarkerProps

Маркер

• Добавлены параметры containerAttrs, wrapperAttrs и zeroSizes в YandexMapMarker:
  • Теперь контейнер YandexMapMarker будет иметь width: 0 и height: 0 по умолчанию, если передан position. Отключить (или форсировать) это поведение можно настройкой zero-sizes (boolean/null (по умолчанию: null))
  • Перезаписать и добавить свои стили, классы и другие атрибуты вы можете, используя новый пропс containerAttrs и wrapperAttrs (при передаче в них style он должен быть объектом)
• Теперь маркер с 1 элементов разделился на 2: __ymap-marker (на него ставится width, height 0) и __ ymap-marker_wrapper (на него - translate и width fit-content, если есть translate (для корректной работы))
• Добавлены вариации position top-center и bottom-center, которые будут задавать translateY в 50% вместо 100%
• BREAKING: Вариации position left и right теперь откидывают на 100% вместо 50%
• Добавлены вариации left-center и right-center

Кластер

• Исправлен фатальный краш кластеров, при котором часть кластеров могла перестать отображаться
• clusterMarkerProps теперь принимает доп. параметры из YandexMapMarker
• Теперь кластеры центрируются автоматически (position top-center left-center)

Документация

• Добавлен подробный Migration Guide

Рефакторинг

• Изменена структура src/composables

Помогали в релизе

• @zomkd (Документация)

[2.0.0-rc.4]

Новые возможности

position в YandexMapMarker

В YandexMapMarker добавлен параметр position (вне settings). Разработчик может использовать значение top left-center, чтобы сделать поведение как в Картах 2.0.

Подробная документация по доступным значениям (для чего это свойство нужно) доступна в документации компонентов ( Компоненты -> Основные -> YandexMapMarker).

Типизация

• Добавлен и экспортирован тип YandexMapMarkerPosition

[2.0.0-rc.3]

Исправления ошибок

• Исправлен запуск в Vue 2

Улучшена обработка параметров

При работе на реальном проекте столкнулись с тем, что Яндекс очень скупо объяснял, что пошло не так, если вы не указали обязательный параметр в settings.

Чтобы исправить это, была улучшена документация и добавлена дополнительная обработка параметров компонентов:

Сделаны обязательными settings в компонентах

• YandexMapControls
• YandexMapFeatureDataSource
• YandexMapTileDataSource
• YandexMapLayer
• YandexMapDefaultMarker
• YandexMapMarker
• YandexMapFeature

Валидация будет проходить только на onMounted (перед подключением Яндекса) для случаев, когда настройки появляются позже, чем создаётся компонент.

Добавлена валидация обязательных параметров

• YandexMap: location (только изменён текст ошибки)
• YandexMapControls: position
• YandexMapFeatureDataSource: id
• YandexMapTileDataSource: id
• YandexMapLayer: type
• YandexMapDefaultMarker: coordinates
• YandexMapMarker: coordinates
• YandexMapFeature: geometry

Типизация

• Из типизации YandexMapControlButton убран text

[2.0.0-rc.1]

Версия перешла в состояние Release Candidate! Это значит, что библиотека:

• Полностью документирована, кроме Migration Guide
• Готова к тестированию на продуктиве
• Принимает тикеты с багами и пожеланиями
• Крупных breaking-изменений вноситься не будет

Просим принять максимальное участие в тестировании. Переход библиотеки в тэг latest планируется в январе-феврале.

Документация

• Добавлен базовый Migration Guide
• Раздел "О проекте" дополнен информацией о планируемых сроках перехода библиотеки в стабильность и отличиях от прошлых версий

[2.0.0-beta.10]

С этим релизом версия 2.0 подошла к статусу Release Candidate.

Библиотека стабильна, полностью документирована (кроме гайда миграции) и готова к работе и тестированию сообществом.

Новые возможности

• В кластер добавлен параметр clusterMarkerProps для изменения параметров маркера слота кластера.
• Добавлен и экспортирован тип YandexMapListenerSettings

Документация

• Добавлен раздел "Список компонентов"
• Документированы все компоненты 🎉

[2.0.0-beta.9]

• Теперь структура в DOM до отрисовки соответствует структуре после, включая width, height и прочее. Это решит, в том числе, проблемы отрисовки на SSR, когда карта визуально появлялась только после отрисовки, из-за чего вся страница прыгала

Т.е. до:

<div id="__app">
  <div class="__ymap_container" style="width:100%;height:100%;"></div>
</div>

После:

<div id="__app">
  <div class="__ymap" style="width:50dvw;height:75dvh;color:#000;position:relative;z-index:0;">
    <div class="__ymap_container" style="width:100%;height:100%;"></div>
    <div class="__ymap_slots" style="display:none;"></div>
  </div>
</div>

[2.0.0-beta.8]

Исправления ошибок

• Исправлена работа реактивности циферок кластеров
• Исправлен случайный фатальный краш при отрисовке кластеров
• Исправлена ошибка, при которой библиотека иногда могла не работать в Nuxt 3

Документация

• Завершена работа над секцией "Примеры". Добавлены последние примеры: Элементы управления и Хинты.