设置颜色
这一篇讲怎么给视图、文字、图层设颜色:固定色、半透明、跟随浅色和深色模式的颜色、Asset Catalog 里的颜色,以及读出、比较、去掉颜色。颜色写成字符串,全部写法和规则在 UIColor 的参考页。
推荐的做法
把颜色集中定义成常量。 把 App 用到的颜色写在一个地方,其他地方只引用常量名:
// 全 App 的颜色只在这里写一次
const Colors = {
brand: '#5856D6',
danger: 'systemRed',
text: 'label',
cardBackground: 'light-dark(#ffffff, #1c1c1e)',
overlay: 'rgba(0, 0, 0, 0.4)',
};
const view = new UIView();
view.backgroundColor = Colors.brand;结果:视图的底色变成靛蓝色。
这样写有三个好处:
- 颜色字符串只出现一次。 写错的机会只有这一处。App 启动后看一遍控制台,没有
is not a valid color的警告,这些字符串就都是合法的。 - 常量名写错能被类型检查发现。 开着类型检查时,
Colors.brnad会报「属性不存在」。颜色字符串写错不会报,常量名写错会报。不开类型检查时,Colors.brnad是undefined,颜色被去掉且没有警告,所以建议开着类型检查。 - 同一个色值只有一种写法。 同一个色值用两种写法写入时,读出来的字符串会变成后写入的那一种,见读出来的字符串。集中定义之后不会遇到。
需要跟随浅色和深色模式的颜色,优先用语义色('label'、'systemBackground')。语义色由系统维护,在浅色、深色和「增强对比度」设置下都有合适的值。系统没有提供的品牌色用 light-dark() 写两个值。
asset(名字) 把色值放在 Xcode 的 Asset Catalog 里,可以为浅色、深色、高对比度分别配置。它适合手工维护 Xcode 工程的 App。用 @nacrejs/ios 的命令行工具生成工程的 App 目前没有添加颜色的途径:生成的 ios/ 目录每次都会重建,里面的 Asset Catalog 只有 App 图标。这种工程用上面的常量写法。
第一个例子
从空白 App 开始,在页面上从上到下放四个色块,分别用四种写法设置底色。
application.addEventListener('sceneconnect', (e) => {
// 建窗口和页面。每个 App 都要有这几行
const win = new UIWindow(e.scene);
const page = new UIViewController();
page.view.backgroundColor = 'systemBackground';
win.rootViewController = page;
win.makeKeyAndVisible();
// 1. 固定颜色:十六进制
const box1 = new UIView();
box1.frame = new CGRect(40, 100, 120, 80);
box1.backgroundColor = '#5856D6';
page.view.addSubview(box1);
// 2. 带透明度:红 255、绿 59、蓝 48,不透明度 50%
const box2 = new UIView();
box2.frame = new CGRect(40, 200, 120, 80);
box2.backgroundColor = 'rgb(255 59 48 / 50%)';
page.view.addSubview(box2);
// 3. 语义色:正文文字的颜色,跟随浅色和深色模式
const box3 = new UIView();
box3.frame = new CGRect(40, 300, 120, 80);
box3.backgroundColor = 'label';
page.view.addSubview(box3);
// 4. 自己指定两个颜色:浅色模式用绿色,深色模式用蓝色
const box4 = new UIView();
box4.frame = new CGRect(40, 400, 120, 80);
box4.backgroundColor = 'light-dark(#34c759, #0a84ff)';
page.view.addSubview(box4);
// 5. 读出来是写进去的那个字符串
console.log(box1.backgroundColor);
console.log(box4.backgroundColor);
});效果
- 页面上从上到下有四个 120 × 80 pt 的色块。pt 是 iOS 的长度单位,见单位。
- 第一个色块是靛蓝色。浅色模式和深色模式下相同。
- 第二个色块是半透明的红色,能透出页面的底色。浅色模式下页面底色是白色,色块看起来是浅红色。深色模式下页面底色是黑色,色块看起来是暗红色。
- 第三个色块在浅色模式下是黑色,在深色模式下是白色。
- 第四个色块在浅色模式下是绿色,在深色模式下是蓝色。
- 在系统设置里切换浅色和深色模式时,页面底色、第三个和第四个色块自动换色。不需要写任何代码。
- 控制台输出
#5856D6和light-dark(#34c759, #0a84ff)。
这段代码没有作为一个整体在模拟器运行过。「读出来是写进去的那个字符串」在验收用例里验证过。屏幕上各色块的实际颜色和切换模式时的变化未在模拟器验证。
在模拟器里切换浅色和深色模式:菜单 Features → Toggle Appearance。
下面的例子都沿用这里的 page、box1 和 box2。例子用的都是 backgroundColor,其他接受颜色的属性写法相同,列表见接受颜色的属性。
单独试某一节时,先写这几行:
const page = new UIViewController();
const box1 = new UIView();
box1.frame = new CGRect(40, 100, 120, 80);
page.view.addSubview(box1);
const box2 = new UIView();
box2.frame = new CGRect(40, 200, 120, 80);
page.view.addSubview(box2);写一个固定颜色
用十六进制或 rgb()。两种写法得到的颜色相同。
box1.backgroundColor = '#ff9500';
box2.backgroundColor = 'rgb(255, 149, 0)';效果:两个色块都变成橙色。浅色模式和深色模式下相同。屏幕上的颜色未在模拟器验证。
rgb() 里的三个数依次是红、绿、蓝,范围 0–255。十六进制的字母大写小写都可以,'#FF9500' 和 '#ff9500' 是同一个颜色。
也可以用表里的固定色名。颜色名区分大小写,要照表里的写法:
box1.backgroundColor = 'white';效果:色块变成白色。未在模拟器验证。
带透明度
十六进制在末尾加一组不透明度,00 是全透明,ff 是不透明。rgb() 加第四个数,范围 0–1,或者写成百分比。
box1.backgroundColor = '#ff000080'; // 末尾的 80 约等于 50%
box2.backgroundColor = 'rgba(255, 0, 0, 0.5)';效果:两个色块都变成半透明的红色,能看到后面的内容。未在模拟器验证。
rgb() 的空格写法把不透明度放在 / 后面:
box2.backgroundColor = 'rgb(255 0 0 / 50%)';效果:和上面相同。未在模拟器验证。
全透明写 'transparent'(和 CSS 一样),或者用颜色名 clear,或者赋 null,见去掉颜色。
颜色的不透明度只影响这一个颜色。要让整个视图连同它的子视图一起变透明,用视图的 alpha,见 UIView。
注意:只有十六进制和
rgb()能带透明度。给颜色名加透明度(比如半透明的systemBlue)目前做不到。
跟随深浅色模式:用语义色
iOS 有浅色和深色两种外观,由用户在系统设置里选择。语义色是系统预先配好的一组颜色,按用途命名,在两种外观下各有一个值。
page.view.backgroundColor = 'systemBackground'; // 页面底色
box1.backgroundColor = 'secondarySystemBackground'; // 放在页面底色上面的一层
box2.backgroundColor = 'separator'; // 分隔线效果:页面底色在浅色模式下是白色,在深色模式下是黑色。两个色块在两种模式下各显示系统为该用途配好的颜色。用户切换模式时自动换色。未在模拟器验证。
按用途选名字,不要按色值选。全部语义色和各自的用途见能用的颜色名。
跟随深浅色模式:自己指定两个颜色
用 light-dark(浅色模式的颜色, 深色模式的颜色)。
box1.backgroundColor = 'light-dark(#ffffff, #1c1c1e)';
box2.backgroundColor = 'light-dark(systemBackground, #000)';效果:box1 在浅色模式下是白色,在深色模式下是深灰色。box2 在浅色模式下是系统的页面底色,在深色模式下是黑色。用户切换模式时自动换色。屏幕上的颜色未在模拟器验证。
两个参数可以是这一页里的任何一种字符串写法。写了就生效,不需要另外声明 App 支持深色模式。
用 Asset Catalog 里的颜色
Asset Catalog 是 Xcode 工程里放图片和颜色的资源目录。在里面添加一个 Color Set(一个有名字的颜色),就可以按名字引用它。一个 Color Set 可以为浅色、深色、高对比度分别配置色值。
下面的例子假设已经在 Asset Catalog 里添加了名为 BrandBlue 的 Color Set。
box1.backgroundColor = 'asset(BrandBlue)';效果:色块显示 BrandBlue 在当前外观下配置的颜色。未在模拟器验证。
想让颜色在「增强对比度」设置下也换一个值,只能用这种写法。light-dark() 只区分浅色和深色。
注意:名字不存在时抛
TypeError,不是只打一条警告,见asset()的名字不存在时会抛。用之前先确认名字存在。
读出一个颜色
读出来的也是字符串。合法写入的字符串原样返回,不会被改写成另一种写法。
box1.backgroundColor = '#f00';
console.log(box1.backgroundColor);
box1.backgroundColor = 'rgba(255,0,0,.5)';
console.log(box1.backgroundColor);效果:控制台依次输出 #f00 和 rgba(255,0,0,.5)。大小写和空格都和写入时相同。
读出来的任何字符串都可以再赋回去。
有两种情况读出来的不是写入的字符串,见读出来的字符串。
比较两个颜色是否相同
直接比较读出来的字符串。
box1.backgroundColor = '#5856D6';
box2.backgroundColor = '#5856D6';
console.log(box1.backgroundColor === box2.backgroundColor);效果:控制台输出 true。
这种比较比的是写法,不是色值。同一个颜色用颜色名和十六进制各写一次,读出来是两个不同的字符串。目前没有按色值比较两个颜色的方法。
去掉颜色
box1.backgroundColor = null;
console.log(box1.backgroundColor);效果:色块变成透明,能看到后面的内容。控制台输出 null。屏幕上的变化未在模拟器验证。
写 undefined 和写 null 相同。有些属性写 null 的含义是恢复默认值,比如 UILabel 的 textColor,各属性的说明见各自的页面。
让图层的颜色跟随深浅色模式
图层(view.layer)上的颜色在写入时确定,之后不随外观变化。要跟随,在视图的 traitchange 事件里重新写一次:
box1.layer.borderWidth = 1;
box1.layer.borderColor = 'separator';
box1.addEventListener('traitchange', () => {
box1.layer.borderColor = 'separator';
});效果:色块有一条 1 pt 的边框。用户切换浅色和深色模式后,边框换成新外观下的分隔线颜色。这段代码未在模拟器验证;验收用例验证的是「在 traitchange 之后写入图层颜色,读出的是新外观下的色值」。