Google 地图 JavaScript API 反应收发器
[大
此库已存档 . 我们建议这个软件包的所有用户切换到新的@vis.gl/react-google-maps, (中文(简体) ), 它提供了组件和钩子的集合,可以配置 与此软件包完全兼容.见 迁移指南 关于如何从此软件包切换到
@vis.gl/react-google-maps。 。 。 .
说明
使用此库来包裝 Google Maps JavaScript API 的回放组件 .
import {Wrapper} from '@googlemaps/react-wrapper';
const MyApp = () => (
<Wrapper apiKey={'YOUR_API_KEY'}>
<MyMapComponent />
</Wrapper>
);
前面的例子不会使任何元素生效,除非Google Maps JavaScript API成功加载. 为了处理出错的案件和完成装载前的时间,建议提供渲染道具.
import {Wrapper, Status} from '@googlemaps/react-wrapper';
const render = status => {
switch (status) {
case Status.LOADING:
return <Spinner />;
case Status.FAILURE:
return <ErrorComponent />;
case Status.SUCCESS:
return <MyMapComponent />;
}
};
const MyApp = () => <Wrapper apiKey={'YOUR_API_KEY'} render={render} />;
在合并子女和制作道具时,儿童将获得成功,而成品道具将按其他状态值执行.
import {Wrapper, Status} from '@googlemaps/react-wrapper';
const render = (status: Status): ReactElement => {
if (status === Status.FAILURE) return <ErrorComponent />;
return <Spinner />;
};
const MyApp = () => (
<Wrapper apiKey={'YOUR_API_KEY'} render={render}>
<MyMapComponent />
</Wrapper>
);
@googlemaps/js-api-loader (英语)
此包装器使用 @googlemaps/js-api-loader (英语) 装入 Google 地图 JavaScript API。 这个库使用单通图案,不会试图多次加载库. 接受的所有选项 @googlemaps/js-api-loader (英语) 也可以作为包装器组件的道具.
MyMap 组件
以下片段显示了使用 useRef 财务报告和审定财务报表 useEffect 与Google地图的钩子.
function MyMapComponent({
center,
zoom,
}: {
center: google.maps.LatLngLiteral;
zoom: number;
}) {
const ref = useRef<HTMLDivElement>();
const [map, setMap] = useState<google.maps.Map | null>(null);
useEffect(() => {
const map = new google.maps.Map(ref.current, {center, zoom});
setMap(map);
return () => {
google.maps.event.clearInstanceListeners(map);
setMap(null);
};
}, []);
useEffect(() => {
if (!map) return;
// do something with the map instance
}, [map]);
return <div ref={ref} id="map" />;
}
实例
见 实例 用于附加使用模式的文件夹.
安装
通过 npm 作为软件包可用 @ googlemaps/ 反应- wrapper。 。 。 .
npm i @googlemaps/react-wrapper
或者说
yarn add @googlemaps/react-wrapper
对于TypeScript支持额外安装类型定义.
npm i -D @types/google.maps
或者说
yarn add -D @types/google.maps
文档
参考文件见此 链接。 。 。 .
支助
这个图书馆是社区支持的。 我们很适应 稳定与特点 我们想让你在上面 建立真正的生产应用程序的图书馆.
