mxgraph中mxStencil使用教程
目录
官方文档：https://jgraph.github.io/mxgraph/docs/js-api/files/shape/mxStencil-js.html
<!--基本结构-->
<shapes>
<shape name="linearrow" h="1" w="4" aspect="variable" strokewidth="inherit">
<!--连接点-->
<connections>
<constraint x="0.5" y="0" perimeter="1" name="A" />
<constraint x="0.5" y="1" perimeter="1" name="B" />
</connections>
<!--背景-->
<background>
</background>
<!--前景-->
<foreground>
</foreground>
</shape>
</shapes>Shapes
相当于一个集合，里面可以包含多个shape图形
shape
一个shape相当于一个图形，相关参数：
参数
解释
类型
值
name
图形名称
string
自定义
w
图形宽度
string
自定义，默认值为100
h
图形高度
string
自定义，默认值为100
aspect
图形比率
string
1.variable（默认值）表示调整大小图形会以比率缩放，缩放使图形宽高会改变 2.fixed（固定）图形默认比率大小不能改变，缩放不会改变图形的宽高
strokewidth
线条
string
默认值为1。"inherit"表示线条宽度仅在缩放时更改，而不是在调整大小时更改。如果使用数值，则在缩放和调整大小时都会改变线条宽度。这个参数要在后面每个线段前面加上strokewidth标签赋值配合使用才能有效果
注意：mxStencil中图形的坐标不是按照普通x，y相对于原点来的，这里x、y坐标是以整个页面的左上角为原点，到图形的左上角的距离。
connections
连接点是用于和其他图形建立连接的点，图下蓝色的小X
连接点的定义方式：
参数
解释
值
perimeter
周长
0表示由x、y指定的连接点，1表示使连接点的位置从形状左上角，通过x、y到与形状周长相交的点
x、y
连接点的位置
周长为0时，x、y是相对坐标最大值为1。周长为0时，由图形坐标点出发经过x、y坐标最后与边框相交
name
连接点的名称
形状上端口的唯一标识符
实验参数perimeter="0"的设置原理， 设置 两个连接点
<constraint x="0" y="0.5" perimeter="0" name="!" />
<constraint x="1" y="0.5" perimeter="0" name="!" />以图形左上角为原点，(0,0)是左上角，(0,0.5)左边中心，(1,0.5)是右边界的中心，值可能小于0或大于1，以定位在形状外部。
实验参数perimeter="1"的设置原理，设置x=2.5，y=3.7,已知图形的宽为5.7，高为7.5，那么x、y所处的位置就是红色方框标记，也就是改图形的中心点，两点连成一条线，由图形坐标点出发经过x、y坐标最后与边框相交的就是连接点的位置。
background
背景只能描绘轮廓（path），如果有填充图形颜色，或者阴影部分只能放置前景中。
背景只能包含：笔划（一条条的线）、矩形、圆矩形或椭圆元素。不能包括图像、文本或包含形状
Move：用于绘制一个起点
line：用于描述终点，Move和line表示连成一条线，line的一直使用表示笔划不中断
<path>
<move x="0" y="10" />
<line x="10" y="10" />
</path>
<path>
<move x="2.79999999999991" y="0.700000000000114" />
<line x="0.699999999999886" y="6.81676937119846E-14" />
<line x="0.7" y="6.81676937119846E-14" />
<line x="0.7" y="1.40000000000016" />
<line x="0.699999999999886" y="1.40000000000016" />
<line x="2.79999999999991" y="0.700000000000114" />
<close />
</path>close：把起点和终点连起来闭合，常见于弧线，封闭图形里面
arc：
<path>
<move x="x1" y="y1" />
<arc rx="0.7" ry="0.7" x-axis-rotation="" large-arc-flag="" sweep-flag="" x="x2" y="y2" />
</path>x1、y1:起点
x2、y2:终点
rx、ry：中心点
x-axis-rotation：图形旋转角度（0~360）
sweep-flag：弧线方向 0表示逆时针 1表示顺时针
large-arc-flag：起点和终点连成一条线做这个线的中垂线，根据中心点，就有四段弧
这里要讲的参数是large-arc-flag（角度大小） 和sweep-flag（弧线方向），large-arc-flag决定弧线是大于还是小于180度，0表示小角度弧，1表示大角度弧。sweep-flag表示弧线的方向，0表示从起点到终点沿逆时针画弧，1表示从起点到终点沿顺时针画弧。下面的例子展示了这四种情况。
![]()
quad：二次贝塞尔曲线
curve：三次贝塞尔曲线
foreground
前景可以包含：封闭路径、文字等等
文字：
- str：需要显示的文本字符串。
- x、y：文本元素的十进制位置（x，y），必需。
- align：文本元素的水平对齐，可以是“left”、“center”或“right”。可选，默认为“左”。
- valign：文本元素的垂直对齐，可以是“top”、“middle”或“bottom”。可选，默认为“top”。
- localized：0或1，如果是1，“str”实际上包含一个键，用于从mxResources中获取值。可选，默认值为mxStencil.defaultLocalized。
- 垂直：0或1，如果为1，则垂直渲染标签（旋转90度）。可选，默认值为0。
- 旋转角度：单位为度（0到360）。旋转文本的角度。可选，默认值为0。
- 对齐形状：或1，如果0，则在设置文本旋转时忽略形状的旋转。可选，默认值为1。
其他样式
在当前状态中更改颜色的元素都采用哈希前缀的十六进制颜色代码（“ffae80”）
strokecolor，这将设置在发出笔划或圆角命令时图形路径将呈现的颜色。
fillcolor，这将设置在发出“填充”或“圆角笔划”命令时，闭合路径内部将呈现的颜色。
fontcolor，这设置了在绘制文本时字体渲染的颜色。
alpha定义了在1.0和0.0之间使用的完全不透明透明度程度，而完全透明时使用的透明度等级。
fillalpha定义了在1.0和0.0之间使用的完全不透明填充透明度的程度，以及完全透明的0.0。
Strokeapha定义了在1.0之间使用的完全不透明笔划透明度的程度，以及为完全透明而使用的0.0之间的笔划透明度。
strokewidth定义通过抚摸渲染的图形图元的整数厚度。使用fixed=“1”按原样应用该值，而不必缩放。
dashed 为“1”，表示启用破折号，“0”表示禁用。启用虚线时，当前的划线图案（由dashpattern定义）将用于笔划。dashpattern是一个间隔的“开，关”长度序列，定义绘制笔划的距离，dashpattern可以设置虚线的样式。例如：
![]()
字体样式：
- fontsize，整数，
- fontstyle，一个粗体（1）、斜体（2）和下划线（4）的ORed位模式，即粗体下划线为“5”
- fontfamily是一个字符串，定义要使用的字体
在foreground前景中绘制一段路径path，在path前面加上fillcolor用于表示封闭路径的颜色，最后在path后面加上fillstroke表示这是填充笔画。
<foreground>
<!--渲染图形路径的颜色-->
<strokecolor color="#ffffff" />
<!--填充的颜色-->
<fillcolor color="#000000" />
<path>
<move x="0.61" y="1.69937846768753" />
<arc rx="1.78938082222999" ry="1.78938082222999" x-axis-rotation="0" large-arc-flag="0" sweep-flag="1" x="4.19" y="1.69937846768753" />
</path>
<fillstroke />
</foreground>
<path>
<move x="4.79999999999988" y="4.0998037856843" />
<line x="2.4" y="5.26937846768752" />
<line x="2.92038760422274" y="5.52297520382388" />
<line x="4.79999999999988" y="6.43895314969076" />
<line x="4.79999999999988" y="4.0998037856843" />
<close />
</path>
<background>
<!--渲染图形路径的颜色-->
<strokecolor color="#ffff00" />
<!--渲染线的宽度-->
<strokewidth width="0" />
<!--设置线的样式-->
<dashed dashed="0" />
<path>
<move x="1.04" y="2.1" />
<line x="1.04" y="3.59" />
</path>
<stroke/>
</background>
<shape aspect="variable" h="92" name="4 Point Star" strokewidth="inherit" w="92">
<connections>
<constraint name="N" perimeter="0" x="0.5" y="0"/>
<constraint name="S" perimeter="0" x="0.5" y="1"/>
<constraint name="W" perimeter="0" x="0" y="0.5"/>
<constraint name="E" perimeter="0" x="1" y="0.5"/>
</connections>
<background>
<path>
<move x="46" y="0"/>
<line x="56" y="36"/>
<line x="92" y="46"/>
<line x="56" y="56"/>
<line x="46" y="92"/>
<line x="36" y="56"/>
<line x="0" y="46"/>
<line x="36" y="36"/>
<close/>
</path>
</background>
<foreground>
<fillstroke/>
</foreground>
</shape>
<shape name="jcontvvncwd" h="6.46937846768753" w="4.8" aspect="variable" strokewidth="inherit">
<connections>
<constraint x="0" y="0.74" perimeter="1" name="!" />
<constraint x="1" y="0.74" perimeter="1" name="!" />
</connections>
<background>
<strokecolor color="#ffff00" />
<strokewidth width="0" />
<dashed dashed="0" />
<path>
<move x="0" y="6.46937846768753" />
<line x="4.8" y="4.06937846768753" />
</path>
<stroke />
<strokecolor color="#ffff00" />
<strokewidth width="0" />
<dashed dashed="0" />
<path>
<move x="4.8" y="6.46937846768753" />
<line x="0" y="4.06937846768753" />
</path>
<stroke />
<strokecolor color="#ffff00" />
<strokewidth width="0.0200080032012812" />
<dashed dashed="0" />
<path>
<move x="0" y="4.06937846768753" />
<line x="0" y="6.46937846768753" />
</path>
<stroke />
<strokecolor color="#ffff00" />
<strokewidth width="0.0200080032012812" />
<dashed dashed="0" />
<path>
<move x="0" y="4.06937846768753" />
<line x="4.8" y="4.06937846768753" />
</path>
<stroke />
<strokecolor color="#ffff00" />
<strokewidth width="0.0200080032012812" />
<dashed dashed="0" />
<path>
<move x="4.8" y="4.06937846768753" />
<line x="4.8" y="6.46937846768753" />
</path>
<stroke />
<strokecolor color="#ffff00" />
<strokewidth width="0.0200080032012812" />
<dashed dashed="0" />
<path>
<move x="0" y="6.46937846768753" />
<line x="4.8" y="6.46937846768753" />
</path>
<stroke />
<strokecolor color="#ffff00" />
<strokewidth width="0.0200080032012812" />
<dashed dashed="0" />
<path>
<move x="0" y="6.46937846768753" />
<line x="4.8" y="4.06937846768753" />
</path>
<stroke />
<strokecolor color="#ffff00" />
<strokewidth width="0.0200080032012812" />
<dashed dashed="0" />
<path>
<move x="4.8" y="4.06937846768753" />
<line x="4.8" y="6.46937846768753" />
</path>
<stroke />
<strokecolor color="#ffff00" />
<strokewidth width="0.0200080032012812" />
<dashed dashed="0" />
<path>
<move x="4.8" y="6.46937846768753" />
<line x="0" y="4.06937846768753" />
</path>
<stroke />
<strokecolor color="#ffff00" />
<strokewidth width="0.0200080032012812" />
<dashed dashed="0" />
<path>
<move x="0.61" y="1.69937846768753" />
<line x="2.4" y="1.69937846768753" />
</path>
<stroke />
<strokecolor color="#ffff00" />
<strokewidth width="0.0200080032012812" />
<dashed dashed="0" />
<path>
<move x="2.4" y="1.69937846768753" />
<line x="4.19" y="1.69937846768753" />
</path>
<stroke />
<strokecolor color="#ffff00" />
<strokewidth width="0.0200080032012812" />
<dashed dashed="0" />
<path>
<move x="2.4" y="1.69937846768753" />
<line x="2.4" y="5.26937846768753" />
</path>
<stroke />
<strokecolor color="#ffff00" />
<strokewidth width="0" />
<dashed dashed="0" />
<path>
<move x="4.8" y="4.09937846768753" />
<line x="4.8" y="6.43937846768753" />
</path>
<stroke />
<strokecolor color="#ffff00" />
<strokewidth width="0" />
<dashed dashed="0" />
<path>
<move x="0" y="4.09937846768753" />
<line x="0" y="6.43937846768753" />
</path>
<stroke />
<strokecolor color="#ffff00" />
<strokewidth width="0" />
<dashed dashed="0" />
<path>
<move x="0" y="4.09937846768753" />
<line x="2.92" y="5.51937846768753" />
</path>
<stroke />
<strokecolor color="#ffff00" />
<strokewidth width="0" />
<dashed dashed="0" />
<path>
<move x="4.8" y="4.09937846768753" />
<line x="1.88" y="5.51937846768753" />
</path>
<stroke />
<strokecolor color="#ffff00" />
<strokewidth width="0" />
<dashed dashed="0" />
<path>
<move x="2.92" y="5.51937846768753" />
<line x="4.8" y="6.43937846768753" />
</path>
<stroke />
<strokecolor color="#ffff00" />
<strokewidth width="0" />
<dashed dashed="0" />
<path>
<move x="1.88" y="5.51937846768753" />
<line x="0" y="6.43937846768753" />
</path>
<stroke />
</background>
<foreground>
<strokecolor color="#ffffff" />
<fillcolor color="#000000" />
<path>
<move x="0.61" y="1.69937846768753" />
<arc rx="1.78938082222999" ry="1.78938082222999" x-axis-rotation="0" large-arc-flag="0" sweep-flag="1" x="4.19" y="1.69937846768753" />
</path>
<fillstroke />
<insert x="2.4" y="5.26937846768753">
</insert>
<fillcolor color="#ffff00" />
<path>
<move x="1.17239551400417E-13" y="4.0998037856843" />
<line x="1.17239551400417E-13" y="6.43895314969076" />
<line x="1.87961239577726" y="5.52297520382388" />
<line x="2.4" y="5.26937846768752" />
<line x="1.17239551400417E-13" y="4.0998037856843" />
<close />
</path>
<fill />
<fillcolor color="#ffff00" />
<path>
<move x="4.79999999999988" y="4.0998037856843" />
<line x="2.4" y="5.26937846768752" />
<line x="2.92038760422274" y="5.52297520382388" />
<line x="4.79999999999988" y="6.43895314969076" />
<line x="4.79999999999988" y="4.0998037856843" />
<close />
</path>
<fill />
</foreground>
</shape>
手机扫一扫
移动阅读更方便
你可能感兴趣的文章