NSLayoutDimension:constraintEqualToAnchor() 方法
constraintEqualToAnchor() 方法创建一条约束:这个尺寸等于另一个尺寸乘以倍数再加上常数(这个尺寸 = other × multiplier + constant)。
它覆盖了 NSLayoutAnchor 上的同名方法,多了 multiplier。
语法
constraintEqualToAnchor(other[, { multiplier, constant }])参数
other
另一个 NSLayoutDimension:宽或高。宽和高是同一种类型,可以互相约束,同一个视图的高可以约束到它自己的宽。
options.multiplier
数,比例,没有单位。可省略,省略时是 1。
options.constant
数,单位 pt。可省略,省略时是 0。
两个都可以同时给:{ multiplier: 0.5, constant: -8 } 表示「一半再减 8 pt」。
返回值
新的 NSLayoutConstraint。它还没有激活,要用 NSLayoutConstraint.activateConstraints() 或 isActive 激活之后才参与布局。
异常
TypeError
other不是尺寸锚点:和NSLayoutAnchor.constraintEqualToAnchor()相同。multiplier或constant转不成有限数:multiplier must be a finite number, got "abc"(或constant …)。
示例
js
const parent = new UIView();
const cover = new UIView();
cover.translatesAutoresizingMaskIntoConstraints = false;
parent.addSubview(cover);
const ratio = cover.heightAnchor.constraintEqualToAnchor(cover.widthAnchor, { multiplier: 9 / 16 });
ratio.isActive = true;
console.log(ratio.multiplier);效果:cover 的高等于宽的 9/16。控制台输出 0.5625。multiplier 在屏幕上的效果未在模拟器验证。
对应的 iOS API
-[NSLayoutDimension constraintEqualToAnchor:multiplier:]、-[NSLayoutDimension constraintEqualToAnchor:multiplier:constant:] 和 -[NSLayoutAnchor constraintEqualToAnchor:constant:] 在 JS 里是同一个方法,multiplier:、constant: 写成 options 的键。