CABasicAnimation:byValue 属性
byValue 属性是动画的变化量。
值
类型由 keyPath 决定,见能做动画的属性;或者 null。
- 可读,可写。
- 默认值是
null。 - 只给
fromValue和byValue时,终点是两者之和。只给byValue时,从属性的值变到属性的值加byValue。未在模拟器验证。 - 读出来的值:数是数;
CGPoint、CGSize、CGRect是对应的结构体;颜色是字符串;路径和图片是对象。 - 颜色读出来是字符串。随深浅色变化的颜色(如
'systemBlue')读出来是换算后的固定颜色,规则和图层上的颜色相同。 - 数必须写成数。字符串一律当作颜色,
'0.5'不会被当成 0.5。 - 写
null或undefined清掉这个值。
写错时
颜色写错时不抛异常:控制台输出一条警告,原来的值不变。
其他情况抛 TypeError:
- 还没有
keyPath:set keyPath before byValue; the value's type depends on it - 类型和
keyPath不对应:byValue does not fit keyPath "position" keyPath要颜色,给的不是:byValue for keyPath "strokeColor" needs a colorkeyPath要路径,给的不是:byValue for keyPath "path" needs a UIBezierPathkeyPath要图片,给的不是:byValue for keyPath "contents" needs a UIImage- 给的不是数、结构体、颜色、路径、图片中的任何一种:
byValue needs a number, a CGPoint / CGSize / CGRect, a color, a UIBezierPath, or a UIImage
示例
js
const grow = CABasicAnimation.animationWithKeyPath('cornerRadius');
grow.fromValue = 0;
grow.byValue = 10;
grow.duration = 0.4;
console.log(grow.byValue);效果:加到图层上之后,圆角在 0.4 秒里从 0 变到 10 pt。控制台输出 10。画面上的表现未在模拟器验证。
对应的 iOS API
CABasicAnimation.byValue。ObjC 里要包成 NSNumber、NSValue、CGColorRef、CGPathRef 的值,这里直接写数、结构体、颜色字符串、UIBezierPath。