mapgl_2gis_web 0.0.1
mapgl_2gis_web: ^0.0.1 copied to clipboard
A high-performance Flutter Web wrapper for 2GIS MapGL JS API. Fully supports Dart 3 JS Interop and WASM.
mapgl_2gis_web #
A modern, high-performance Flutter Web wrapper for the 2GIS MapGL JS API (@2gis/mapgl). Fully built using the latest Dart 3 dart:js_interop and package:web, ensuring compatibility with WASM and canvaskit renderers.
⚠️ PROJECT UNDER ACTIVE DEVELOPMENT / ПРОЕКТ В РАЗРАБОТКЕ
EN: This package is currently under active development. The API is subject to change. Do not use in production yet.
RU: Пакет находится в процессе активной разработки и шлифовки кода. Интерфейсы могут меняться. Использовать в продакшене пока не рекомендуется.
Features #
- Zero-Bridge Performance: Uses Dart 3
extension typesover JS objects for zero runtime overhead. - Shadow DOM Ready: Designed specifically for Flutter Web's platform views architecture, avoiding common container identification bugs.
- Smart Resize Handling: Built-in debounced containment scaling to prevent map freezing on window resize.
- UX Optimized: Native support for loading overlays and static image previews while the heavy WebGL map instance boots up.
Installation #
Add this to your package's pubspec.yaml file:
dependencies:
mapgl_2gis_web: ^0.0.1-dev.1
Initial Setup #
Include the 2GIS MapGL JS API script in your web/index.html inside the <head> tag, or let the widget inject it automatically:
<script src="https://2gis.com"></script>
Basic Usage #
A complete, polished usage guide and documentation will be available with the stable 1.0.0 release.
// Stay tuned for the upcoming API preview!
License #
This project is licensed under the MIT License - see the LICENSE file for details.