Skip to content

类型体系差异

旧版参考:旧 api/types/api.mdapi/types/components.mdapi/types/index.md

新版参考:E:\temp\docs\api\types.md

导入方式变化

旧版新版
框架本体类型从 @/uni_modules/sinle-ui 导入;组件专属类型从组件自身 interface.uts 导入(如 SnActionsheetItem 等)全部类型统一@/uni_modules/sinle-ui 重导出,不再要求从组件目录导入
旧版部分类型需手动 importas 处理(如 SnToastConfigsn-native 导入)新版编译器可自动推导,类型经插件入口统一导出

SnColorBase 差异

字段整体保持不变,仅 新增 shadow(阴影色)字段

旧版 transparent / page / front / dark / disabled / disabledText / disabledDark / disabledDarkText / line / lineDark / lineText / title / text / textLight + 五功能色 × 9 + toast

新版相同 + shadow

5 种功能色(primary/info/success/error/warning)× 亮/暗两套颜色集、每种含原色/Light/Dark + Active/Text 的结构完全保留,未变。

手势事件类型差异

类型变化
SnPointerEvent保留(type/x/y/event)
SnTouch保留(x/y/diffX/diffY/direction/id),旧版 direction 字段为独立 SnTouch 属性、含义为"手指移动方向",保持不变
SnTouchEvent保留
SnScaleEvent保留
SnRotateEvent不再单独导出,旋转事件在新版中由组件事件内联携带角度(以组件文档为准)
SnFlingEvent保留

全局弹窗配置类型差异

类型变化
SnShowToastConfig保留并扩展:新增 title 兼容字段(仅有 title 时当 text 用)、passThrough(点击穿透);余字段基本一致
SnShowModalConfig保留并扩展:新增 openAnimation / closeAnimationSnModalAnimationFn 自定义开合动画);新增 position 支持 left/right
SnShowActionsheetConfigactions 类型由旧 SnActionsheetItem[] 改为 SnDataItem[];新增 wrapStyle/wrapClasspanelStyle/panelClassitemStyle/itemBorder/itemHoverStyle 样式链字段;新增 openAnimation/closeAnimation
SnShowLoadingConfig新增(旧版仅有 showLoading 但未独立成文档类型)
SnToastParams新增(sn-toast 参数型轻提示配置)
SnModalAnimationFn新增(自定义动画函数类型)

废弃类型清理

旧版已标注废弃的类型在新版中全部移除

  • SnShareConfig(1.1.5 废弃,snu.share 移除)
  • SnChooseMediaOptions(1.1.7 废弃,snu.chooseMedia 移除)
  • SnPreviewImageLongPressActionsSnPreviewImageConfig(1.1.7 废弃,snu.previewImage 移除)
  • SnToastyConfig(旧 showToasty 参数类型)

权限类型

SnRequestSystemPermissionOptionsSnRequestMediaPermissionOptionsSnRequestMediaPermissionOptionsType 完全保留,现由 sinle-api 定义、sinle-ui 重导出。

新增类型(新版独有)

  • 通用数据项 SnDataItemSnTime(计时/倒计时事件返回)
  • 权限提示:SnPermTipConfigSnPermTipsStyleConfig
  • 消息与通知:SnMessageType/Level/Position/ParamsSnNotificationType/Level/Position/Params
  • 核心类型:SnStyle(完整风格对象)、SnColorBasesSnThemeModeSnFunctionalColorSnResolveTypeUseHoverOptionsSN_DEFAULT_STYLE_ID
  • 组件专属类型大量扩充(SnAvatarConfigSnTreeDataSnCalendar*SnRegion*SnFormItemRuleSnFooterLinkSnBarcodeFormatQrEncodeOptionsSnSignatureBrush 等),均随组件文档说明

使用 MIT 协议