Skip to content

SnAvatarParams

部分内置 sn-avatar 的组件可通过 SnAvatarParams 类型的 avatarConfig 属性配置参数

名称类型必填描述
modeString显示模式。可选值为 image | text | icon
imageModeString图片显示模式
sizeString尺寸大小
srcString图片路径
textString文本内容
iconString图标名称
iconSizeString图标大小
iconColorString图标颜色
shapeString形状。可选值:circle | square
textColorString文本颜色
bgColorString背景颜色
textSizeString文本大小
borderRadiusString圆角大小
enablePreviewBoolean是否启用图片预览

SnAvatarGroupItem

sn-avatar-groupdata 属性需要传入一个 SnAvatarGroupItem[] 类型的数组。

此对象只能传入数据,设置样式请直接通过 sn-avatar-group 的属性统一设置。

名称类型必填描述
modeString显示模式。可选值为 image | text | icon
imageModeString图片显示模式
srcString图片路径
textString文本内容
iconString图标名称

SnBadgeParams

部分内置 sn-badge 的组件可通过 SnBadgeParams 类型的 badgeConfig 属性配置参数

名称类型必填描述
valueNumber显示的值(仅number模式)
maxNumber最大值(仅number模式)
sizeString大小
offsetString偏移量,徽标的 transform
modeString模式。可选值:number
textString文本内容
showZeroBoolean是否显示0
textColorString文字颜色
bgColorString背景颜色

SnCountdownTime

sn-countdownchange 事件返回 SnCountdownTime 类型的时间数据

名称类型必填描述
dNumber
hNumber小时
mNumber分钟
sNumber
msNumber毫秒

SnDataItem

sn-picker-viewsn-selectsn-topbar 等数据组件的 data 属性需要传入一个 SnDataItem[] 的对象,组件事件触发时返回 SnDataItem 对象

名称类型必填描述
idString数据的唯一标识
textString数据显示文本(不一定必备,视组件具体要求)
iconString数据显示图标(不一定必备,视组件具体要求)
disabledBoolean是否禁用子项(不一定必备,视组件具体要求)

SnFormItemData内部使用

sn-form-item 内部注册组件数据类型

名称类型必填描述
fieldString子项名称
instanceComponentPublicInstance子项实例

SnEmptyColorConfig内部使用

sn-empty 内部传递组件参数数据类型

名称类型必填描述
themeColorString主题颜色
hairColorString头发颜色
clothesColorString衣服颜色
trousersColorString裤子颜色
shoesColorString鞋子颜色
itemColorString项目颜色
skinColorString皮肤颜色
elementColorString元素颜色

SnFormItemRule

sn-form-itemrule 属性需要传入一个 SnFormItemRule 类型的对象

名称类型必填描述
typeString字段类型。可选值:String | number | Boolean | integer | float | array | object | enum | url | email | qqnumber | chinese | abc | phone | landline | ipv6 | ipv4 | idcard | carnumber
requiredBoolean是否必填
messageString校验失败提示信息
patternRegexp正则校验规则
minNumber最小长度
maxNumber最大长度
lenNumber值的长度,同时设置 min、max 和 len 时,以 len 的值为准
enumArray<Any>值的枚举值,限制值只能为此枚举数组的子项。对于字符串枚举类型,这里的值应为字符串数组
transform(value: Any) => Any数据转换函数,校验前先执行此函数对原始数据进行处理
valid(value: Any) => String自定义校验函数,在默认的校验前先执行此函数。返回空文本串表示校验通过;返回其他字符串表示校验失败,且返回的字符串将作为校验失败的提示信息

SnFormItemVerifyResult内部使用

sn-form-item 内部单一项校验结果数据类型

名称类型必填描述
validBoolean子项校验是否通过
messageString子项校验失败的提示信息
fieldString子项的名称

SnFormValidResult

sn-formsubmit 方法需要传入一个 SnFormValidResult 类型的回调对象

名称类型必填描述
success() => void表单校验成功回调
fail(failResults: SnFormItemVerifyResult[]) => void表单校验失败回调,会将所有校验失败的子项的错误信息作为 failResults 数组参数

SnLoadmoreParams

部分内置 sn-loadmore 的组件可通过 SnLoadmoreParams 类型的 loadmoreConfig 属性配置参数

名称类型必填描述
loadmoreTextString加载更多时的文本
nomoreTextString没有更多内容时的文本
loadingTextString加载中的文本
textSizeString文本大小
textColorString文本颜色
iconSizeString图标大小
iconColorString图标颜色
lineColorString线条颜色
lineHeightString线条高度
dashedBoolean是否显示虚线
disabledBoolean是否禁用加载更多功能

SnMedia内部使用

sn-media 组件的传递选择的媒体文件数据

名称类型必填描述
fileAnyFile 对象
srcString选中文件临时路径
thumbString缩略图地址。视频类模式专用。
nameString文件 uuid,由组件内部随机生成
statusString媒体文件状态。可选值:uploaded | uploading | unuploaded | error

SnRefresherParams

部分内置 sn-refresher 的组件可通过 SnRefresherParams 类型的 refresherConfig 属性配置参数

名称类型必填描述
refreshTextString刷新时的文本
refreshingTextString正在刷新时的文本
textSizeString文本大小
textColorString文本颜色
iconString图标名称
iconSizeString图标大小
iconColorString图标颜色

SnScanParams

部分内置 sn-scan 的组件可通过 SnScanParams 类型的 scanConfig 属性配置参数

SnScanParams

名称类型必填描述
enableDingBoolean是否启用扫描成功提示声
showTorchBoolean是否启用手电筒
dingFileSrcString扫描成功提示音文件路径
scanTypeString扫描类型,可选值:barcode | qrcode | all
continuousBoolean是否连续扫描(即扫描成功后触发 scanned 事件 但不会触发 goin 事件)
scanOnlyOnceBoolean是否只扫描一次(同时设置 scanOnlyOncecontinuous,以 scanOnlyOnce 为准)
titleString扫描页面标题
initZoomScaleNumber初始缩放比例
continuousSleepNumber连续扫描间隔时间(单位 ms)
showAlbumBoolean是否显示相册按钮
showBackButtonBoolean是否显示返回按钮
showAniBoolean是否启用动画
enableZoomBoolean是否启用手势缩放

SnTabbarItem

sn-tabbar 组件的 data 属性需要传入一个 SnTabbarItem[] 类型的对象

名称类型必填描述
textString子项文本
iconString子项图标
imageString子项图片
activeTextString选中子项文本
activeIconString选中子项图标
activeImageString选中子项图片
interceptor() => Boolean拦截器方法,可以在此方法内鉴权。如果返回 false 则拦截跳转
badgeSnBadgeParams子项徽标配置

SnTabParams

sn-tabs 组件的 data 属性需要传入一个 SnTabParams[] 类型的对象

名称类型必填描述
idString子项标识符。组件事件将返回此 id
textString子项文本
iconString子项图标
disabledBoolean是否禁用子项
badgeConfigSnBadgeParams子项徽标配置

SnTimerTime

sn-timerchange 事件返回 SnTimerTime 类型的时间数据

名称类型必填描述
dNumber
hNumber
mNumber
sNumber
msNumber毫秒

SnToastParams

  • 部分内置 sn-toast 的组件可通过 SnToastParams 类型的 toastConfig 属性配置参数
  • sn-toast 组件的 configShow 方法需要传入一个 SnToastParams 类型的对象
名称类型必填描述
textString文本内容
bgColorString背景颜色
overlayBoolean是否显示透明遮罩层(防穿透)
positionString显示位置,可选值:top | center | bottom
durationNumber显示时长(单位 ms)
textColorString文本颜色
borderRadiusString圆角大小
paddingString内边距
iconString图标名称
iconColorString图标颜色
iconSizeString图标大小
loadingBoolean是否加载中(设置后 duration 失效,默认不会自动消失,可通过调用 close 方法关闭)
textLinesNumber文本行数
textAlignString文本对齐方式

SnWaterfallItem内部使用

sn-waterfallsn-waterfall-item 组件内部传递数据使用

名称类型必填描述
idString瀑布流子项的唯一标识符
topNumber瀑布流子项距离顶部的距离
leftNumber瀑布流子项距离左侧的距离
widthNumber瀑布流子项的宽度
heightNumber瀑布流子项的高度
nodeSnWaterfallItemComponentPublicInstance瀑布流子项对应的组件实例

SnActionsheetItem

sn-actionsheetactions 属性需要传入一个 SnActionsheetItem[] 类型的数组

名称类型必填描述
textString操作项文本内容
colorString操作项颜色
disabledBoolean是否禁用操作项

使用 MIT 协议