logo

G

  • 教程
  • API
  • 示例
  • 插件
  • 所有产品antv logo arrow
  • 6.1.26
  • 画布
    • 简介
    • 初始化参数
    • 场景图能力与生命周期
    • 内置对象
    • 坐标系
    • 画布事件
    • OffscreenCanvas 和服务端渲染
    • CustomElementRegistry
    • 常见问题
  • 渲染器
    • 简介
    • Canvas 渲染器
    • Canvaskit 渲染器
    • SVG 渲染器
    • WebGL 渲染器
    • WebGPU 渲染器
    • 自定义渲染器
  • 相机
    • 简介
    • 相机参数
    • 相机动作
    • 相机动画
  • 事件
    • 简介
    • 事件对象
    • 手势和拖放
    • 常见问题
  • 动画
    • Web Animations API
    • Lottie 动画
  • 基础图形
    • 基础概念
    • DisplayObject
    • Group 图形分组
    • Text 文本
    • Circle 圆形
    • Ellipse 椭圆
    • Rect 矩形
    • Image 图片
    • Line 直线
    • Polygon 多边形
    • Polyline 折线
    • Path 路径
    • HTML 内容
  • 样式系统
    • 简介
    • 继承机制
    • CSS Typed OM
    • CSS Properties & Values API
    • CSS Layout API
    • Pattern
    • Gradient
  • 三维世界
    • 材质
    • 几何
    • 光源
    • Mesh
    • 雾
    • 交互
  • 内置对象
    • EventTarget
    • Node
    • Element
    • Document
    • MutationObserver
    • 工具方法
  • GPGPU
    • 简介
    • 编程模型
    • Kernel API
    • 经典 GPGPU 的实现原理
    • webgpu-graph
  • 声明式用法
    • 使用 Web Components
  • 开发调试工具
    • G 开发者工具
    • 内置的渲染统计信息
    • 第三方开发调试工具

Polygon 多边形

上一篇
Line 直线
下一篇
Polyline 折线

资源

Ant Design
Galacea Effects
Umi-React 应用开发框架
Dumi-组件/文档研发工具
ahooks-React Hooks 库

社区

体验科技专栏
seeconfSEE Conf-蚂蚁体验科技大会

帮助

GitHub
StackOverflow

more products更多产品

Ant DesignAnt Design-企业级 UI 设计语言
yuque语雀-知识创作与分享工具
EggEgg-企业级 Node 开发框架
kitchenKitchen-Sketch 工具集
GalaceanGalacean-互动图形解决方案
xtech蚂蚁体验科技
© Copyright 2025 Ant Group Co., Ltd..备案号:京ICP备15032932号-38

Loading...

可以参考 SVG 的 <polygon> 元素。

如下 示例 定义了一个多边形:

const polygon = new Polygon({
style: {
points: [
[0, 0],
[100, 0],
[100, 100],
[0, 100],
],
stroke: '#1890FF',
lineWidth: 2,
},
});

继承自

继承了 DisplayObject 的 样式属性。

anchor

默认值为 [0, 0]。详见 DisplayObject anchor

transformOrigin

默认值为 left top。详见 DisplayObject transformOrigin

lineWidth

默认值为 '1'。详见 DisplayObject lineWidth

miterLimit

默认值 4。详见 DisplayObject miterLimit

额外属性

points

支持以下两种写法:

  • [number, number][] 点数组
  • string 点之间使用空格分隔,形如:'100,10 250,150 200,110'

因此以下两种写法等价:

polygon.style.points = '100,10 250,150 200,110';
polygon.style.points = [
[100, 10],
[250, 150],
[200, 110],
];

https://developer.mozilla.org/zh-CN/docs/Web/SVG/Attribute/points

markerStart

可以参考 Polyline 的 markerStart 属性。

但和 Polyline 不同的是,由于多边形是闭合的,因此 “起始点” 和 “终止点” 的位置是完全重合的,由 points 中的第一个点决定。这也与 SVG 原生实现保持一致,下图展示了同时定义 markerStart 和 markerEnd 后的重合效果:

polygon end/start overlap

在该示例中,我们在多边形的“起始点”上放置了一个箭头:

polygon marker
const arrowMarker = new Path({
style: {
path: 'M 10,10 L -10,0 L 10,-10 Z',
stroke: '#1890FF',
anchor: '0.5 0.5',
transformOrigin: 'center',
},
});
polygon.style.markerStart = arrowMarker;

markerEnd

可以参考 Polyline 的 markerEnd 属性。

但和 Polyline 不同的是,由于多边形是闭合的,因此 “起始点” 和 “终止点” 的位置是完全重合的。“终止点” 由 points 中的第一个点决定。

在该示例中,我们在多边形的终止点上放置了一个图片:

polygon marker
const imageMarker = new Image({
style: {
width: 50,
height: 50,
anchor: [0.5, 0.5],
transformOrigin: 'center',
transform: 'rotate(90deg)',
src: 'https://gw.alipayobjects.com/mdn/rms_6ae20b/afts/img/A*N4ZMS7gHsUIAAAAAAAAAAABkARQnAQ',
},
});
polygon.style.markerEnd = imageMarker;

markerMid

可以参考 SVG 的同名属性。

在多边形除了 “起始点” / “终止点” 之外的每一个顶点上放置标记图形。

例如下图中在多边形上除首尾的每个顶点上都放置了一个 Circle:

const circleMarker = new Circle({
style: {
r: 10,
stroke: '#1890FF',
},
});
polygon.style.markerMid = circleMarker;
marker mid

markerStartOffset

可以参考 Polyline 的 markerStartOffset 属性。

沿多边形的第一个线段方向移动标记图形,同时会改变原始多边形的形状。

marker start offset
初始值适用元素是否可继承是否支持动画计算值
'0'-否是<length>

markerEndOffset

可以参考 Polyline 的 markerEndOffset 属性。

初始值适用元素是否可继承是否支持动画计算值
'0'-否是<length>