7.1.3 • Published 4 months ago

@uiw/react-amap-text v7.1.3

Weekly downloads
-
License
MIT
Repository
github
Last release
4 months ago

Text 文本标注

Buy me a coffee npm version Downloads

点标记是用来标示某个位置点信息的一种地图要素,本章介绍如何在地图图面使用点标记。

import { Text } from '@uiw/react-amap';
// 或者单独安装使用
import { Text } from '@uiw/react-amap-text';

基本用法

import ReactDOM from 'react-dom';
import React, { useState, useRef } from 'react';
import { Map, APILoader, Text } from '@uiw/react-amap';

const Example = () => {
  const [show, setShow] = useState(true);
  return (
    <>
      <button onClick={() => setShow(!show)}>
        {show ? '隐藏' : '显示'}
      </button>
      <div style={{ width: '100%', height: '300px' }}>
        <Map zoom={13} center={[116.4, 39.92]}>
          <Text
            text="纯文本标记"
            anchor="center"
            draggable={true}
            cursor="pointer"
            angle={10}
            visible={show}
            style={{
              'padding': '.75rem 1.25rem',
              'margin-bottom': '1rem',
              'border-radius': '.25rem',
              'background-color': 'white',
              'width': '15rem',
              'border-width': 0,
              'box-shadow': '0 2px 6px 0 rgba(114, 124, 245, .5)',
              'text-align': 'center',
              'font-size': '20px',
              'color': 'blue'
            }}
            // title="北京市"
            position={new AMap.LngLat(116.396923,39.918203)}
          />
        </Map>
      </div>
    </>
  );
}

const Mount = () => (
  <APILoader akey="a7a90e05a37d3f6bf76d4a9032fc9129">
    <Example />
  </APILoader>
);

export default Mount;

通过 children 定义 text

定义 children 定义的 text props 将失效。

import ReactDOM from 'react-dom';
import React, { useState, useRef } from 'react';
import { Map, APILoader, Text } from '@uiw/react-amap';

const Example = () => {
  const [show, setShow] = useState(true);
  return (
    <>
      <button onClick={() => setShow(!show)}>
        {show ? '隐藏' : '显示'}
      </button>
      <div style={{ width: '100%', height: '300px' }}>
        <Map zoom={13} center={[116.4, 39.92]}>
          <Text
            text="纯文本标记2"
            anchor="center"
            draggable={true}
            cursor="pointer"
            className="test-text"
            angle={10}
            visible={show}
            style={{
              'padding': '.75rem 1.25rem',
              'margin-bottom': '1rem',
              'border-radius': '.25rem',
              'background-color': 'white',
              'width': '15rem',
              'border-width': 0,
              'box-shadow': '0 2px 6px 0 rgba(114, 124, 245, .5)',
              'text-align': 'center',
              'font-size': '20px',
              'color': 'blue'
            }}
            // title="北京市"
            position={new AMap.LngLat(116.396923,39.918203)}
          >
            <div style={{ color: 'red' }}>
              纯文本标记3
            </div>
          </Text>
        </Map>
      </div>
    </>
  );
}

const Mount = () => (
  <APILoader akey="a7a90e05a37d3f6bf76d4a9032fc9129">
    <Example />
  </APILoader>
);

export default Mount;

TypeScript 中 Ref 类型定义

由于 text 参数与返回的 text 冲突,定义类型参考如下实例

import ReactDOM from 'react-dom';
import React, { useEffect, useRef } from 'react';
import { Text, TextProps } from './index';

function Demo() {
  const textRef = useRef<Omit<TextProps, 'text'> & { text?: AMap.Text }>(null);
  useEffect(() => {
    if (textRef.current && textRef.current.text) {
      textRef.current.text.setStyle({});
    }
  }, []);
  return (
    <>
      <Text ref={textRef} text="test" />
      <Text
        ref={(instance) => {
          if (instance && instance.map && instance.text) {
            const bounds = instance.map?.getBounds()
            const txt = instance.text.getBounds();
          }
        }}
        text="test"
      />
    </>
  );
}

Props

更多参数设置

参数说明类型默认值
visible覆盖物是否可见。boolean-
text标记显示的文本内容。string-
children标记显示的文本内容,text 参数将失效。string-

事件

事件类型文档

参数说明类型
onDblClick鼠标左键双击事件(event: MapsEvent): void;
onRightClick鼠标右键单击事件(event: MapsEvent): void;
onMouseMove鼠标移动(event: MapsEvent): void;
onMouseOver鼠标移近点标记时触发事件(event: MapsEvent): void;
onMouseOut鼠标移出点标记时触发事件(event: MapsEvent): void;
onMouseDown鼠标在点标记上按下时触发事件(event: MapsEvent): void;
onMouseUp鼠标在点标记上按下后抬起时触发事件(event: MapsEvent): void;
onDragStart开始拖拽点标记时触发事件(event: MapsEvent): void;
onDragging鼠标拖拽移动点标记时触发事件(event: MapsEvent): void;
onDragEnd点标记拖拽移动结束触发事件(event: MapsEvent): void;
onClick鼠标左键单击事件(event: MapsEvent): void;
onMoving点标记在执行(obj: { passedPath:Array<LngLat> }): void;
onMoveEnd点标记执行moveTo动画结束时触发事件,也可以由moveAlong方法触发(): void;
onMoveAlong点标记执行moveAlong动画一次后触发事件(): void;
onTouchStart触摸开始时触发事件,仅适用移动设备(event: MapsEvent): void;
onTouchMove触摸移动进行中时触发事件,仅适用移动设备(event: MapsEvent): void;
onTouchEnd触摸结束时触发事件,仅适用移动设备(event: MapsEvent): void;
7.1.3

4 months ago

7.1.2

4 months ago

7.1.1

5 months ago

7.0.0

7 months ago

7.0.2

6 months ago

7.0.1

7 months ago

7.1.0

6 months ago

6.0.5

7 months ago

6.0.4

8 months ago

6.0.3

10 months ago

6.0.2

12 months ago

6.0.1

1 year ago

6.0.0

1 year ago

5.0.20

1 year ago

5.0.21

1 year ago

5.0.9

1 year ago

5.0.8

1 year ago

5.0.7

1 year ago

5.0.6

2 years ago

5.0.5

2 years ago

5.0.10

1 year ago

5.0.11

1 year ago

5.0.12

1 year ago

5.0.13

1 year ago

5.0.14

1 year ago

5.0.15

1 year ago

5.0.16

1 year ago

5.0.17

1 year ago

5.0.18

1 year ago

5.0.19

1 year ago

5.0.4

2 years ago

5.0.3

2 years ago

5.0.2

2 years ago

4.5.3

2 years ago

4.6.0

2 years ago

5.0.1

2 years ago

5.0.0

2 years ago

4.4.1

2 years ago

4.4.0

2 years ago

4.4.2

2 years ago

4.5.0

2 years ago

4.5.2

2 years ago

4.5.1

2 years ago

4.0.5

2 years ago

4.2.2

2 years ago

4.0.7

2 years ago

4.0.6

2 years ago

4.2.1

2 years ago

4.2.0

2 years ago

4.3.1

2 years ago

4.1.0

2 years ago

4.3.0

2 years ago

4.1.1

2 years ago

4.0.4

2 years ago

4.0.3

2 years ago

4.0.1

2 years ago

4.0.2

2 years ago

4.0.0

2 years ago

3.0.4

3 years ago

2.7.22

3 years ago

2.7.21

3 years ago

2.7.20

3 years ago

3.0.3

3 years ago

3.0.2

3 years ago

3.0.1

3 years ago

2.7.6

3 years ago

2.7.5

3 years ago

3.0.0

3 years ago

2.7.7

3 years ago

2.7.9

3 years ago

2.7.19

3 years ago

2.7.18

3 years ago

2.7.17

3 years ago

2.7.16

3 years ago

2.7.11

3 years ago

2.7.10

3 years ago

2.7.15

3 years ago

2.7.14

3 years ago

2.7.13

3 years ago

2.7.12

3 years ago

2.7.4

3 years ago

2.7.3

3 years ago

2.5.0

3 years ago

2.4.1

3 years ago

2.7.0

3 years ago

2.6.1

3 years ago

2.6.0

3 years ago

2.5.1

3 years ago

2.7.2

3 years ago

2.7.1

3 years ago

2.6.2

3 years ago

2.3.0

3 years ago

2.4.0

3 years ago

2.2.6

3 years ago

2.2.5

3 years ago

2.2.4

3 years ago

2.2.3

3 years ago

2.2.2

3 years ago

2.2.1

3 years ago

2.2.0

3 years ago

2.0.2

3 years ago

2.0.1

3 years ago

2.0.0

3 years ago