注意事项
IMPORTANT
请仔细阅读此页内容,对于正确使用 SinleUI 非常重要。
- 由于框架使用了第三方依赖,在 APP 端运行 SinleUI 必须打包自定义基座后运行。
- SinleUI 推荐使用
px
作为基本长度单位。SinleUI 部分组件涉及布局计算,现阶段对于其他单位如rpx
、%
的支持并不太好(下期会改进)。因此,除非设置 css 或组件行内样式style
,否则不推荐在 SinleUI 组件中使用px
外的长度单位。 - SinleUI 推荐使用
ms
作为基本时长单位。SinleUI 部分组件涉及时长处理,默认以ms
作为单位。因此,除非设置 css 或组件行内样式style
,否则不推荐在 SinleUI 组件中使用ms
外的时长单位。 - SinleUI 框架内置字体体积较大,如不需要可自行删除(勿删 remixicon)
- 获取组件 Ref 实例时,如果是选项式 API,使用
this.$refs[xxxx]
获取即可。
如果是组合式 API,必须设置一个与组件ref
属性同名的、组件实例类型的响应式对象。例如:vue<template> <sn-modal ref="modalEle" title="标题" content="内容"></sn-modal> </template> <script setup> const modalEle = ref(null as SnModalComponentPublicInstance | null) </script>
- 调用组件的方法需要通过
ref
获取组件实例,且必须保证组件已渲染。 例如:vue<template> <sn-modal ref="modalEle" title="标题" content="内容"></sn-modal> </template> <script setup> const modalEle = ref(null as SnModalComponentPublicInstance | null) // onReady 可以保证 DOM 已渲染 onReady(()=>{ // 示例1 - 安全调用,组件未渲染也不会报错 modalEle.value?.open?.() // 示例2 - 显性判空,仅当组件已渲染时调用 if (modalEle.value != null) { modalEle.value!.close() } }) </script>