UIView:accessibilityLabel 属性
accessibilityLabel 属性是读屏念的名字:说明这个元素是什么,比如「关闭」「搜索」「余额」。
读屏(VoiceOver,系统设置里叫「旁白」)是 iOS 自带的屏幕阅读器,见 isAccessibilityElement。
值
字符串,或者 null。
- 可读,可写。
UIView的默认值是null。- 写
null或undefined清掉,读到null。别的值按String()转:写5读到'5'。 UILabel没有设过它时,读屏开着时读到标签显示的文字,读屏关着时读到null(实测)。设过之后读到设的值,不再跟着文字(实测)。- 读屏停在一个元素上时,先念它的标签,再念值、特征和提示。这个顺序来自 Apple 的文档,未在真机验证。
- 没有变化事件:改它的只有 App 自己的代码。
UILabel没设过它时读到的文字是读的那一刻算出来的,跟着text变。
示例
一个只有图标、没有文字的按钮,读屏没有字可念,要给它一个标签:
js
const close = UIButton.buttonWithType('system');
close.setImage(UIImage.systemImageNamed('xmark'), { forState: ['normal'] });
close.accessibilityLabel = '关闭';
console.log(close.accessibilityLabel);效果:控制台输出 关闭。读屏停在这个按钮上时念「关闭」,再念它是按钮。读屏怎么念未在真机验证。
对应的 iOS API
accessibilityLabel。在 iOS 里它属于 UIAccessibility 协议,任何对象都有;JS 里只在 UIView 和它的子类上有。