UIPageControl:setIndicatorImage() 方法
setIndicatorImage() 方法单独给某一页的点换一张图。其余的页不变。
语法
setIndicatorImage(image, { forPage })参数
image
UIImage,或者 null。null 去掉这一页单独设的图,回到默认。
options.forPage
第几页,从 0 数,必填。小数向零取整。必须小于 numberOfPages。
返回值
无(undefined)。
异常
TypeError
- 没有传
forPage:setIndicatorImage needs { forPage }。 - 页码越界或是负数:
setIndicatorImage: page 3 is out of range; expected 0 to 2(页数是 3 时)。一页都没有时是setIndicatorImage: page 0 is out of range; there are none。 image不是UIImage也不是null:setIndicatorImage needs a UIImage or null。
示例
js
const pages = new UIPageControl();
pages.numberOfPages = 3;
const arrow = UIImage.systemImageNamed('location.fill');
pages.setIndicatorImage(arrow, { forPage: 0 });
console.log(pages.indicatorImageForPage(0) === arrow);效果:输出 true。第 0 页的点是一个定位的箭头,其余的点不变。屏幕上的样子未在模拟器验证。
对应的 iOS API
-[UIPageControl setIndicatorImage:forPage:]。原生在页码越界时抛一个 JS 接不住的原生异常,这里抛 TypeError。