全局配置

介绍

组件库提供全局配置方法，供开发者根据自己项目实际情况选择合适的尺寸单位。

使用方法

TIP

请在初始化组件库之后调用!!!

import { IBestSetUIGlobalConfig } from "@ibestservices/ibest-ui"

onWindowStageCreate(windowStage: window.WindowStage): void {
	windowStage.loadContent('pages/Index', (err, data) => {
		// 在此处初始化组件库!!!
		IBestInit(windowStage, this.context)
		// 请在初始化组件库之后调用!!!
		IBestSetUIGlobalConfig({
			unit: "lpx",
			fontUnit: "lpx"
		})
	})
}

IBestGlobalConfigType 数据类型

TIP

该类型为 IBestSetUIGlobalConfig 方法的参数类型, 后续还会加入更多属性配置.

参数	说明	类型	默认值
designWidth	标识页面设计基准宽度	number	720
unit	全局尺寸单位, 可选值 vp、px、lpx	string	vp
fontUnit	全局字体单位, 可选值 vp、px、lpx、fp	string	fp
fontNames 2.2.2	自定义字体名称, 配置后可在包含图标的组件上使用自定义图标, 例如IBestCell、IBestBadge等, 具体用法参考IBestIcon的使用自定义图标章节	string[]	[]
avatar	头像组件配置	IBestAvatarConfig	-

IBestAvatarConfig 数据类型

参数	说明	类型	默认值
defaultAvatar	默认头像地址	ResourceStr	''

具体表现

TIP

• 文档中未注明单位的尺寸都默认为 IBestSetUIGlobalConfig 方法设置的单位;
• 全局单位仅会影响组件库中传递的 number 类型的尺寸数值;
• 以下事例中, btnWidth 会自动拼接全局单位转化为 20vp, btnHeight 为字符串保持不变, btnFontSize 会自动拼接全局单位转化为 14fp.

import { IBestButton } from "@ibestservices/ibest-ui";

@Component
struct ButtonPage {
	build(){
		IBestButton({
			btnWidth: 20,
			btnHeight: "30vp",
			btnFontSize: 14
		})
	}
}