UNPKG

@uiw/react-amap-info-window

Version:

用于在地图上弹出一个详细信息展示窗体,地图上只允许同时展示 `1` 个信息窗体。

329 lines (295 loc) 16.5 kB
<div markdown="1"> <sup>使用 <a href="https://wangchujiang.com/#/app" target="_blank">我的应用</a> 也是一种 <a href="https://wangchujiang.com/#/sponsor" target="_blank">支持</a> 我的方式:</sup> <br> <a target="_blank" href="https://apps.apple.com/app/6758053530" title="Scap: Screenshot & Markup Edit for macOS"><img alt="Scap: Screenshot & Markup Edit" height="52" src="https://wangchujiang.com/appicon/scap.png"></a> <a target="_blank" href="https://apps.apple.com/app/6757317079" title="Screen Test for macOS"><img alt="Screen Test" height="52" src="https://wangchujiang.com/appicon/screen-test.png"></a> <a target="_blank" href="https://apps.apple.com/app/Deskmark/6755948110" title="Deskmark for macOS"><img alt="Deskmark" height="52" src="https://wangchujiang.com/appicon/deskmark.png"></a> <a target="_blank" href="https://apps.apple.com/app/Keyzer/6500434773" title="Keyzer for macOS"><img alt="Keyzer" height="52" src="https://wangchujiang.com/appicon/keyzer.png"></a> <a target="_blank" href="https://github.com/jaywcjlove/vidwall-hub" title="Vidwall Hub for macOS"><img alt="Vidwall Hub" height="52" src="https://wangchujiang.com/appicon/vidwall-hub.png"></a> <a target="_blank" href="https://apps.apple.com/app/VidCrop/6752624705" title="VidCrop for macOS"><img alt="VidCrop" height="52" src="https://wangchujiang.com/appicon/vidcrop.png"></a> <a target="_blank" href="https://apps.apple.com/app/Vidwall/6747587746" title="Vidwall for macOS"><img alt="Vidwall" height="52" src="https://wangchujiang.com/appicon/vidwall.png"></a> <a target="_blank" href="https://wangchujiang.com/mousio-hint/" title="Mousio Hint for macOS"><img alt="Mousio Hint" height="52" src="https://wangchujiang.com/appicon/mousio-hint.png"></a> <a target="_blank" href="https://apps.apple.com/app/6746747327" title="Mousio for macOS"><img alt="Mousio" height="52" src="https://wangchujiang.com/appicon/mousio.png"></a> <a target="_blank" href="https://apps.apple.com/app/6745227444" title="Musicer for macOS"><img alt="Musicer" height="52" src="https://wangchujiang.com/appicon/musicer.png"></a> <a target="_blank" href="https://apps.apple.com/app/6743841447" title="Audioer for macOS"><img alt="Audioer" height="52" src="https://wangchujiang.com/appicon/audioer.png"></a> <a target="_blank" href="https://apps.apple.com/app/6744690194" title="FileSentinel for macOS"><img alt="FileSentinel" height="52" src="https://wangchujiang.com/appicon/file-sentinel.png"></a> <a target="_blank" href="https://apps.apple.com/app/6743495172" title="FocusCursor for macOS"><img alt="FocusCursor" height="52" src="https://wangchujiang.com/appicon/focus-cursor.png"></a> <a target="_blank" href="https://apps.apple.com/app/6742680573" title="Videoer for macOS"><img alt="Videoer" height="52" src="https://wangchujiang.com/appicon/videoer.png"></a> <a target="_blank" href="https://apps.apple.com/app/6740425504" title="KeyClicker for macOS"><img alt="KeyClicker" height="52" src="https://wangchujiang.com/appicon/key-clicker.png"></a> <a target="_blank" href="https://apps.apple.com/app/6739052447" title="DayBar for macOS"><img alt="DayBar" height="52" src="https://wangchujiang.com/appicon/daybar.png"></a> <a target="_blank" href="https://apps.apple.com/app/6739444407" title="Iconed for macOS"><img alt="Iconed" height="52" src="https://wangchujiang.com/appicon/iconed.png"></a> <a target="_blank" href="https://apps.apple.com/app/6737160756" title="Menuist for macOS"><img alt="Menuist" height="52" src="https://wangchujiang.com/appicon/rightmenu-master.png"></a> <a target="_blank" href="https://apps.apple.com/app/6723903021" title="Paste Quick for macOS"><img alt="Quick RSS" height="52" src="https://wangchujiang.com/appicon/paste-quick.png"></a> <a target="_blank" href="https://apps.apple.com/app/6670696072?platform=mac" title="Quick RSS for macOS/iOS"><img alt="Quick RSS" height="52" src="https://wangchujiang.com/appicon/quick-rss.png"></a> <a target="_blank" href="https://apps.apple.com/app/6670167443" title="Web Serve for macOS"><img alt="Web Serve" height="52" src="https://wangchujiang.com/appicon/web-serve.png"></a> <a target="_blank" href="https://apps.apple.com/app/6503953628?platform=mac" title="Copybook Generator for macOS/iOS"><img alt="Copybook Generator" height="52" src="https://wangchujiang.com/appicon/copybook-generator.png"></a> <a target="_blank" href="https://apps.apple.com/app/6471227008?platform=mac" title="DevTutor for macOS/iOS"><img alt="DevTutor for SwiftUI" height="52" src="https://wangchujiang.com/appicon/devtutor.png"></a> <a target="_blank" href="https://apps.apple.com/app/6479819388?platform=mac" title="RegexMate for macOS/iOS"><img alt="RegexMate" height="52" src="https://wangchujiang.com/appicon/regex-mate.png"></a> <a target="_blank" href="https://apps.apple.com/app/6479194014?platform=mac" title="Time Passage for macOS/iOS"><img alt="Time Passage" height="52" src="https://wangchujiang.com/appicon/time-passage.png"></a> <a target="_blank" href="https://apps.apple.com/app/6478772538" title="IconizeFolder for macOS"><img alt="Iconize Folder" height="52" src="https://wangchujiang.com/appicon/iconize-folder.png"></a> <a target="_blank" href="https://apps.apple.com/app/6478511402?platform=mac" title="Textsound Saver for macOS/iOS"><img alt="Textsound Saver" height="52" src="https://wangchujiang.com/appicon/textsound-saver.png"></a> <a target="_blank" href="https://apps.apple.com/app/6476924627" title="Create Custom Symbols for macOS"><img alt="Create Custom Symbols" height="52" src="https://wangchujiang.com/appicon/create-custom-symbols.png"></a> <a target="_blank" href="https://apps.apple.com/app/6476452351" title="DevHub for macOS"><img alt="DevHub" height="52" src="https://wangchujiang.com/appicon/devhub.png"></a> <a target="_blank" href="https://apps.apple.com/app/6476400184" title="Resume Revise for macOS"><img alt="Resume Revise" height="52" src="https://wangchujiang.com/appicon/resume-revise.png"></a> <a target="_blank" href="https://apps.apple.com/app/6472593276" title="Palette Genius for macOS"><img alt="Palette Genius" height="52" src="https://wangchujiang.com/appicon/palette-genius.png"></a> <a target="_blank" href="https://apps.apple.com/app/6470879005" title="Symbol Scribe for macOS"><img alt="Symbol Scribe" height="52" src="https://wangchujiang.com/appicon/symbol-scribe.png"></a> </div> <hr> InfoWindow 信息窗体 === [![Buy me a coffee](https://img.shields.io/badge/Buy%20me%20a%20coffee-048754?logo=buymeacoffee)](https://jaywcjlove.github.io/#/sponsor) [![npm version](https://img.shields.io/npm/v/@uiw/react-amap-info-window.svg)](https://www.npmjs.com/package/@uiw/react-amap-info-window) [![Downloads](https://img.shields.io/npm/dm/@uiw/react-amap-info-window.svg?style=flat)](https://www.npmjs.com/package/@uiw/react-amap-info-window) 用于在地图上弹出一个详细信息展示窗体,地图上只允许同时展示 `1` 个信息窗体。 ```jsx import { InfoWindow } from '@uiw/react-amap'; // 或者单独安装使用 import { InfoWindow } from '@uiw/react-amap-info-window'; ``` ### 基本用法 ```jsx mdx:preview import ReactDOM from 'react-dom'; import React, { useState, useRef } from 'react'; import { Map, APILoader, InfoWindow } from '@uiw/react-amap'; const Example = () => { const [show, setShow] = useState(true); // 构建信息窗体中显示的内容 const info = []; info.push("<div class='input-card content-window-card'><div><img style=\"float:left;width:67px;height:16px;\" src=\" https://webapi.amap.com/images/autonavi.png \"/></div> "); info.push("<div style=\"padding:7px 0px 0px 0px;\"><h4>高德软件</h4>"); info.push("<p class='input-item'>电话 : 010-84107000 邮编 : 100102</p>"); info.push("<p class='input-item'>地址 :北京市朝阳区望京阜荣街10号首开广场4层</p></div></div>"); return ( <> <button onClick={() => setShow(!show)}> {show ? '隐藏' : '显示'} </button> <div style={{ width: '100%', height: '500px' }}> <Map zoom={14} center={[116.397637, 39.900001]}> <InfoWindow visible={show} content={info.join('')} // position={[116.397046, 39.915698]} onClose={(evn) => { console.log('evn', evn); }} /> </Map> </div> </> ); } const Mount = () => ( <APILoader akey="a7a90e05a37d3f6bf76d4a9032fc9129"> <Example /> </APILoader> ); export default Mount; ``` ### 支持 ReactNode 通过 `children` 支持 `React` 的方式展现内容,因为窗口信息内容通过 `content` 展示内容,它支持 `string/HTMLElement` 添加事件并不方便。 ```jsx mdx:preview import ReactDOM from 'react-dom'; import React, { useState, useRef } from 'react'; import { Map, APILoader, InfoWindow } from '@uiw/react-amap'; const Example = () => { const [show, setShow] = useState(true); const [num, setNum] = useState(1) return ( <> <button onClick={() => setShow(!show)}> {show ? '隐藏' : '显示'} </button> <div style={{ width: '100%', height: '500px' }}> <Map zoom={14} center={[116.397637, 39.900001]}> <InfoWindow visible={show} onClose={(evn) => { console.log('evn', evn); }} > <div style={{ display: 'flex', justifyContent: 'space-between', paddingBottom: 10 }}> <img height={16} src="https://webapi.amap.com/images/autonavi.png"/> <h2> <span style={{color: 'red'}}>{num}</span> - 高德软件 </h2> </div> <p>电话:010-84107000 邮编:100102</p> <p>地址:北京市朝阳区望京阜荣街10号首开广场4层</p> <button onClick={() => setNum(num + 1)}> 点击事件 + 1 ({num}) </button> </InfoWindow> </Map> </div> </> ); } const Mount = () => ( <APILoader akey="a7a90e05a37d3f6bf76d4a9032fc9129"> <Example /> </APILoader> ); export default Mount; ``` ### 设置信息窗体内容 ```jsx mdx:preview import ReactDOM from 'react-dom'; import React, { useState, useRef } from 'react'; import { Map, APILoader, InfoWindow } from '@uiw/react-amap'; const Example = () => { const [show, setShow] = useState(true); const [content, setContent] = useState('<div>高德软件</div>'); return ( <> <button onClick={() => setShow(!show)}> {show ? '隐藏' : '显示'} </button> <input type="text" value={content} onChange={(evn) => setContent(evn.target.value)}/> <div style={{ width: '100%', height: '500px' }}> <Map zoom={14} pitch={70} viewMode="3D" center={[116.397637, 39.900001]}> <InfoWindow visible={show} content={content} onClose={(evn) => { console.log('evn', evn); }} /> </Map> </div> </> ); } const Mount = () => ( <APILoader akey="a7a90e05a37d3f6bf76d4a9032fc9129"> <Example /> </APILoader> ); export default Mount; ``` ### 点标记点弹出信息窗体 ```jsx mdx:preview import ReactDOM from 'react-dom'; import React, { useState, useRef } from 'react'; import { Map, Marker, APILoader, InfoWindow } from '@uiw/react-amap'; const Example = () => { const [show, setShow] = useState(false); const [winPosition, setWinPosition] = useState(); const [content, setContent] = useState('<div>高德软件</div>'); return ( <> <input type="text" value={content} onChange={(evn) => setContent(evn.target.value)}/> <div style={{ width: '100%', height: '300px' }}> <Map zoom={14} center={[116.397637, 39.900001]}> <Marker title="北京市" position={new AMap.LngLat(116.405285,39.904989)} onClick={(evn) => { if (!show) { setWinPosition(new AMap.LngLat(116.405285,39.904989)); setShow(true); } else { setWinPosition(new AMap.LngLat(116.405285,39.904989)); } }} /> <Marker title="北京市" position={new AMap.LngLat(116.415285,39.905589)} onClick={(evn) => { if (!show) { setWinPosition(new AMap.LngLat(116.415285,39.905589)); setShow(true); } else { setWinPosition(new AMap.LngLat(116.415285,39.905589)); } }} /> {winPosition && ( <InfoWindow visible={show} position={winPosition} offset={{ x: 0, y: -10}} content={content} onClose={(evn) => { // console.log('evn2', evn, show); }} /> )} </Map> </div> </> ); } const Mount = () => ( <APILoader akey="a7a90e05a37d3f6bf76d4a9032fc9129"> <Example /> </APILoader> ); export default Mount; ``` ### 点标记点弹出信息窗体 Ref 实现 ```jsx mdx:preview import ReactDOM from 'react-dom'; import React, { useState, useRef } from 'react'; import { Map, Marker, APILoader, InfoWindow } from '@uiw/react-amap'; const Example = () => { const mapRef = useRef(); const winRef = useRef(); const [winPosition, setWinPosition] = useState(); const [content, setContent] = useState('<div>高德软件</div>'); return ( <> <input type="text" value={content} onChange={(evn) => setContent(evn.target.value)}/> <div style={{ width: '100%', height: '300px' }}> <Map ref={mapRef} zoom={14} center={[116.397637, 39.900001]}> <Marker title="北京市" position={new AMap.LngLat(116.405285,39.904989)} onClick={(evn) => { winRef.current.infoWindow.open(mapRef.current.map, new AMap.LngLat(116.405285,39.904989)) }} /> <Marker title="北京市" position={new AMap.LngLat(116.415285,39.905589)} onClick={(evn) => { winRef.current.infoWindow.open(mapRef.current.map, new AMap.LngLat(116.415285,39.905589)) }} /> <InfoWindow ref={winRef} offset={{ x: 0, y: -30}} content={content} /> </Map> </div> </> ); } const Mount = () => ( <APILoader akey="a7a90e05a37d3f6bf76d4a9032fc9129"> <Example /> </APILoader> ); export default Mount; ``` ### Props | 参数 | 说明 | 类型 | 默认值 | |--------- |-------- |--------- |-------- | | visible | 覆盖物是否可见。 | `boolean` | - | | position | 信息窗体显示基点位置,默认地图的中间 | `LngLat` | - | | content | 信息窗体尺寸(isCustom为 `true` 时,该属性无效) | `string/HTMLElement` | - | | **children** | 替代 `content`,支持 `ReactNode` | `ReactNode` | - | | offset | 信息窗体显示位置偏移量。默认基准点为信息窗体的底部中心(若设置了anchor,则以anchor值为基准点)。 | `Pixel` | - | | anchor | 信息窗体锚点 | `top-left`,`top-center`,`top-right`,`middle-left`,`center`,`middle-right`,`bottom-left`,`bottom-center`,`bottom-right` | `bottom-center` | | autoMove | 是否自动调整窗体到视野内(当信息窗体超出视野范围时,通过该属性设置是否自动平移地图,使信息窗体完全显示) | `boolean` | - | | size | 信息窗体显示基点位置,默认地图的中间 | `Size` | - | | closeWhenClickMap | 控制是否在鼠标点击地图后关闭信息窗体,默认 `false`,鼠标点击地图后不关闭信息窗体 | `boolean` | - | | avoid | `autoMove` 为 `true` 时,自动平移到视野内后的上右下左的避让宽度。默认值: `[20, 20, 20, 20]` | `Array<number>` | - | | isCustom | 是否自定义窗体。设为 `true` 时,信息窗体外框及内容完全按照 `content` 所设的值添加(默认为false,即在系统默认的信息窗体外框中显示 `content` 内容) | `boolean` | - | ### 事件 | 参数 | 说明 | 类型 | | ---- | ---- | ---- | | onOpen | 信息窗体打开之后触发事件 | `(opts: { type: string }): void;` | | onClose | 信息窗体关闭之后触发事件 | `(opts: { type: string }): void;` |