显示文字
这一篇讲怎么用 UILabel 显示文字:标题、多行说明、放不下时截断或缩小、量出文字需要多大、阴影。每个属性的细节在 UILabel 的参考页。字体和颜色的写法分别见设置字体和设置颜色,一段里混用几种样式见显示带样式的文字。
推荐的做法
用约束定位标签,不约束高度。 标签按文字、字体和行数算出自己需要多大。只约束位置,文字变长、字号变大、换了语言,标签的大小都自动调整。用
frame定位时要自己量、自己写宽高,文字变了还要重新量。多行文字:左右两边用约束确定宽度,
numberOfLines设成0,不约束高度。 标签的宽度由约束确定,高度随文字的行数增长。文字放不下时按内容选处理方式:
处理方式 写法 适合 截断 默认行为 标题、名字。只占一行,放不下的内容可以不显示 换行 numberOfLines = 0,或者一个大于 1 的数正文、说明。内容要完整显示 缩小字号 adjustsFontSizeToFitWidth = true金额、数字。只占一行,并且内容必须完整显示 内容需要完整显示的用换行;只是标识性的内容用截断;缩小字号只用在很短的单行文字上,因为缩小之后同一个页面上的字号不再一致。
第一个标签
从空白 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 title = new UILabel();
title.text = 'Hello, Nacre';
// 2. 设字体、颜色、对齐
title.font = UIFont.systemFontOfSize(34, { weight: 'bold' }); // 34 pt,粗体
title.textColor = 'label';
title.textAlignment = 'center';
// 3. 创建说明文字,最多显示两行
const body = new UILabel();
body.text = '这是一段刻意写得很长的说明文字,用来演示多行排版、行数限制和' +
'尾部截断。两行放不下的部分不显示,第二行的末尾是省略号。';
body.font = UIFont.systemFontOfSize(15);
body.textColor = 'secondaryLabel';
body.numberOfLines = 2;
// 4. 放到页面上。只约束位置和左右边距,不约束高度
title.translatesAutoresizingMaskIntoConstraints = false;
body.translatesAutoresizingMaskIntoConstraints = false;
page.view.addSubview(title);
page.view.addSubview(body);
const safe = page.view.safeAreaLayoutGuide;
NSLayoutConstraint.activateConstraints([
title.topAnchor.constraintEqualToAnchor(safe.topAnchor, { constant: 16 }),
title.leadingAnchor.constraintEqualToAnchor(safe.leadingAnchor, { constant: 24 }),
title.trailingAnchor.constraintEqualToAnchor(safe.trailingAnchor, { constant: -24 }),
body.topAnchor.constraintEqualToAnchor(title.bottomAnchor, { constant: 12 }),
body.leadingAnchor.constraintEqualToAnchor(safe.leadingAnchor, { constant: 24 }),
body.trailingAnchor.constraintEqualToAnchor(safe.trailingAnchor, { constant: -24 }),
]);
});效果
- 屏幕上方、状态栏下面 16 pt 的位置,出现一行粗体的大字「Hello, Nacre」,水平居中。
- 标题下面 12 pt 的位置是一段灰色的小字,左右各离屏幕边缘 24 pt。
- 说明文字排成两行。第二行的末尾是「…」,后面的文字不显示。
- 两个标签的高度都没有写。标题的高度等于一行文字的高度,说明文字的高度等于两行文字的高度。
- 深色模式下,文字颜色自动换成浅色。
这段代码没有作为一个整体在模拟器运行过。其中用到的每个 API 都在验收用例里运行过。
四步分别是:创建并设文字、设外观、设行数、放到页面上。safe 是安全区的 layout guide,表示屏幕上不被刘海、状态栏和底部横条遮挡的那块区域,见 UIView。约束的写法见 Auto Layout。
下面的例子都沿用这里的 title、body、page 和 safe。单独试某一节时,先写这几行:
const page = new UIViewController();
const title = new UILabel();
const body = new UILabel();
page.view.addSubview(title);
page.view.addSubview(body);
const safe = page.view.safeAreaLayoutGuide;改文字
title.text = '新的标题';效果:标签显示的文字立刻换成「新的标题」。用约束定位时,标签的大小跟着新文字重新计算,不需要手动刷新布局。大小自动变化这一点未在模拟器验证。
写 null 清空文字:
title.text = null;效果:标签不显示任何文字。未在模拟器验证。
text 接受任何值,不是字符串的值按 String() 转成字符串:title.text = 5 显示「5」。
注意:标签显示过富文本(写过
attributedText)之后再写text,文字换成新的,但原来富文本里的样式会留着。这种标签要改内容就继续写attributedText。
改字体、字号和粗细
字体是一个 UIFont 对象,字号和粗细都在创建它时确定。UIFont 不能修改,要换字号或粗细,创建一个新的再赋值。
title.font = UIFont.systemFontOfSize(20, { weight: 'semibold' });效果:文字变成 20 pt、半粗体的系统字体。
等宽字体:
title.font = UIFont.monospacedSystemFontOfSize(20, { weight: 'medium' });效果:每个字符占相同的宽度,适合显示数字和代码。
其他字体的写法见设置字体。
改颜色
title.textColor = '#FF3B30';效果:文字变成红色。
颜色写成字符串。可以用 '#RRGGBB',也可以用 'systemRed'、'label' 这类系统颜色名。系统颜色名会随深色模式自动变化。读出来的也是字符串:
title.textColor = '#336699';
console.log(title.textColor);效果:控制台输出 #336699。
颜色写错时不抛异常,只在控制台输出一条警告,文字保持原来的颜色。全部写法见设置颜色。
对齐
title.textAlignment = 'center';效果:文字在标签的宽度内水平居中。
对齐是在标签自己的宽度内进行的。标签的宽度刚好等于文字宽度时,几种对齐看起来没有差别。上面的例子里标题的左右两边都有约束,标签比文字宽,居中才看得出来。取值见 textAlignment。
显示多行文字
这是多行文字的推荐写法:左右两边用约束确定宽度,行数设成不限,不约束高度。
const para = new UILabel();
para.text = '一段比较长的文字,一行放不下。标签的宽度由左右两条约束确定,' +
'文字在这个宽度内换行,标签的高度等于全部行的总高度。';
para.numberOfLines = 0;
para.translatesAutoresizingMaskIntoConstraints = false;
page.view.addSubview(para);
NSLayoutConstraint.activateConstraints([
para.topAnchor.constraintEqualToAnchor(body.bottomAnchor, { constant: 12 }),
para.leadingAnchor.constraintEqualToAnchor(safe.leadingAnchor, { constant: 24 }),
para.trailingAnchor.constraintEqualToAnchor(safe.trailingAnchor, { constant: -24 }),
]);效果:说明文字下面 12 pt 的位置出现这段文字,左右各离屏幕边缘 24 pt。文字全部显示,需要几行就排几行。标签的高度随行数增长。这段代码未在模拟器验证。
numberOfLines 是最多显示几行,默认是 1。0 的含义是「不限」,不是「零行」。
文字只显示一行的原因
一段很长的文字只显示出一行,通常是以下原因之一:
| 原因 | 处理 |
|---|---|
没有改 numberOfLines。它是 1 时文字不换行 | 设成 0 或大于 1 的数 |
| 没有确定宽度。标签的宽度没有被约束确定时,固有尺寸按「全部文字排成一行」计算(未在模拟器验证),文字不会换行 | 约束左右两边,或者设 preferredMaxLayoutWidth |
| 约束了高度。高度被约束之后,放不下的行不显示 | 去掉高度约束 |
限制最多显示几行
body.numberOfLines = 3;效果:文字在标签的宽度内自动换行,最多显示 3 行。3 行放不下时,第 3 行的末尾显示「…」。文字不足 3 行时,有几行显示几行。
放不下时换一种截断方式
lineBreakMode 决定放不下的文字怎么处理。默认在末尾显示省略号。
body.numberOfLines = 1;
body.lineBreakMode = 'byTruncatingMiddle';效果:文字只显示一行。开头和结尾保留,中间的部分换成「…」。适合显示文件名、地址这类两端都有信息的内容。未在模拟器验证。
不要省略号,直接截掉:
body.lineBreakMode = 'byClipping';效果:放不下的部分不显示,没有省略号。未在模拟器验证。
文字太长时自动缩小
单行文字放不下时,可以让标签缩小字号,而不是截断。
title.numberOfLines = 1;
title.adjustsFontSizeToFitWidth = true;
title.minimumScaleFactor = 0.5;效果:文字放得下时按原字号显示。放不下时字号自动缩小,直到整行放得下,最小缩到原字号的一半。缩到一半仍然放不下,再按 lineBreakMode 截断。未在模拟器验证。
title.font 读出来的仍然是原来的字体,不反映缩小后的字号。未在模拟器验证。
把 minimumScaleFactor 明确设成一个大于 0 的值,给缩小设一个下限。
量出文字需要多大
标签可以算出自己显示全部文字需要多大。结果是同步返回的,不是回调,也不是 Promise。
const heading = new UILabel();
heading.text = 'Hello, Nacre';
heading.font = UIFont.systemFontOfSize(34, { weight: 'bold' });
const size = heading.intrinsicContentSize;
console.log(size.width, size.height);效果:控制台输出文字的宽和高,单位是 pt。这段文字和字体实测是宽 188.33、高 40.67。
intrinsicContentSize 是固有尺寸:不限制宽度时,文字需要多大。要问「宽度最多这么多时需要多大」,用 sizeThatFits():
const need = body.sizeThatFits(new CGSize(300, 9999));
console.log(need.width, need.height);效果:控制台输出 body 在宽度不超过 300 pt 时需要的宽和高。结果受 numberOfLines 限制。
这两个成员都不改变标签。标签不需要先加到页面上,新建之后就可以量。
用 frame 定位时让标签刚好容纳文字
不用约束、直接写 frame 时,标签不会自己变大。新建的标签宽高是 0,屏幕上看不到文字。先量,再写 frame:
const note = new UILabel();
note.text = '共 3 条';
const fit = note.intrinsicContentSize;
note.frame = new CGRect(24, 300, fit.width, fit.height);
page.view.addSubview(note);效果:距屏幕左边 24 pt、距顶部 300 pt 的位置出现「共 3 条」,标签的大小刚好等于文字的大小。
note.sizeToFit() 一步完成「量出大小并改成这个大小」,位置不变。
之后改了 text 或 font,标签的大小不会跟着变,要重新量一次再写 frame。
多行文字用 frame 定位时算高度
多行文字的高度取决于宽度:同一段文字,宽度大时行数少,宽度小时行数多。所以要先确定宽度,再问高度。
const width = page.view.bounds.width - 48; // 左右各留 24 pt
const block = new UILabel();
block.text = '一段比较长的文字,一行放不下,需要按给定的宽度换行之后才知道有多高。';
block.numberOfLines = 0;
const blockSize = block.sizeThatFits(new CGSize(width, 9999));
block.frame = new CGRect(24, 340, width, blockSize.height);
page.view.addSubview(block);效果:文字在 width 的宽度内换行,全部显示。标签的高度刚好等于这些行的总高度。
sizeThatFits() 的高度给一个很大的数,表示高度不设上限。
多行文字配合约束时指定换行宽度
只约束了位置、没有约束宽度的多行标签,用 preferredMaxLayoutWidth 告诉它按多宽换行。
body.numberOfLines = 0;
body.preferredMaxLayoutWidth = 320;
console.log(body.intrinsicContentSize.height);效果:控制台输出文字按 320 pt 的宽度换行后的总高度。未在模拟器验证。
标签的宽度已经被约束确定时,一般不需要设这个属性,系统按约束得到的宽度换行。
加文字阴影
title.shadowColor = 'rgba(0,0,0,.25)';
title.shadowOffset = new CGSize(0, 2);效果:每个字的正下方 2 pt 处多出一份同样形状的、半透明黑色的文字。阴影的边缘是清晰的,没有模糊。未在模拟器验证。
文字阴影没有模糊半径。要边缘模糊的阴影,用图层的阴影属性,见用图层画圆角、阴影、渐变和形状。
让文字显示成不可用的样子
title.isEnabled = false;效果:文字变淡,表示这项内容当前不可用。设回 true 恢复。未在模拟器验证。
临时换一种文字颜色
highlightedTextColor 是标签处于高亮状态时的文字颜色。高亮状态由 isHighlighted 控制,系统不会自动切换它。
title.highlightedTextColor = 'systemYellow';
title.isHighlighted = true;效果:文字变成黄色。把 isHighlighted 设回 false,文字恢复成 textColor 的颜色。未在模拟器验证。
跟随系统文字大小
标签的字号由 font 决定,font 不变字号就不变。用户在系统设置里调大文字后,标签不会自动变。要跟随,用 UIFont 的文本样式取字体,并在系统设置变化时重新赋值,写法见设置字体。
深色模式下的文字颜色
默认的文字颜色是语义色 label,浅色模式下是黑色,深色模式下是白色,自动切换。自己设颜色时用语义色或 light-dark(),同样自动切换,见设置颜色。
让标签响应点按
标签的 isUserInteractionEnabled 默认是 false,触摸会落到它后面的视图上。要响应点按,把它设成 true 再加一个手势识别器,见手势识别器。需要按下时有反馈的,用 UIButton。
让文字垂直靠上
标签比文字高时,文字在标签内垂直居中,没有垂直对齐的属性(未在模拟器验证)。不约束高度时标签的高度等于文字的高度,不存在这个问题。