Skip to content

CAShapeLayer ​

CAShapeLayer 表示形状图层:把一条路径(UIBezierPath)画出来。它先填充路径围出的区域,再沿路径描边。折线图、饼图、进度环都用它画。

它是一个图层,和别的子图层一样要自己设 frame,再加到某个视图的图层下面。它不按路径调整自己的大小:路径里的坐标是图层自己坐标系里的点,原点是图层的左上角。

注意:fillColor 默认是不透明的黑色,strokeColor 默认是 null。只要一条线时,要把 fillColor 设成 null、给 strokeColor 一个颜色。

CAShapeLayer 不派发事件。它的属性只会被 App 的代码修改,所以没有变化通知。

继承关系:EventTarget → NSObject → CALayer → CAShapeLayer

怎么画折线、扇形、进度环、虚线,见指南用图层画圆角、阴影、渐变和形状。

构造函数 ​

CAShapeLayer()

创建一个形状图层。大小是 0 × 0 pt,没有路径。

实例属性 ​

还继承 CALayer 的属性,常用的是 frame、masksToBounds。

属性说明
path要画的路径

填充:

属性说明
fillColor填充颜色
fillRule哪些区域算在路径内部

描边:

属性说明
strokeColor线的颜色
lineWidth线宽
lineCap线两端的形状
lineJoin拐角的形状
miterLimit尖角的长度上限
strokeStart描边从路径的哪里开始
strokeEnd描边到路径的哪里结束
lineDashPattern虚线的画法
lineDashPhase虚线从图案的哪里开始画

实例方法 ​

CAShapeLayer 没有自己的方法。还继承 CALayer 的方法。

示例 ​

一条折线 ​

js
const card = new UIView();
card.frame = new CGRect(20, 100, 300, 160);

const path = new UIBezierPath();
path.moveToPoint(new CGPoint(24, 120));
path.addLineToPoint(new CGPoint(96, 60));
path.addLineToPoint(new CGPoint(168, 96));

const line = new CAShapeLayer();
line.path = path;
line.fillColor = null;
line.strokeColor = 'systemBlue';
line.lineWidth = 3;
line.frame = card.bounds;
card.layer.addSublayer(line);

效果:卡片上出现一条 3 pt 粗的蓝色折线,共两段。

对应的 iOS API ​

ObjCJS
[CAShapeLayer layer]new CAShapeLayer()
shape.path = path.CGPathshape.path = path
shape.fillColor = UIColor.clearColor.CGColorshape.fillColor = null
shape.fillRule = kCAFillRuleEvenOddshape.fillRule = 'evenOdd'
shape.lineCap = kCALineCapRoundshape.lineCap = 'round'
shape.lineJoin = kCALineJoinBevelshape.lineJoin = 'bevel'
shape.lineDashPattern = @[@4, @2]shape.lineDashPattern = [4, 2]

参见 ​