更新记录

0.0.1（2025-06-21） 下载此版本

基础版本

平台兼容性

uni-app

其他

scUi

配置步骤

1. 引入 scUi 主 JS 库

import App from "./App";
import { createSSRApp } from "vue";
import scUi from "@/uni_modules/sc-ui";

export function createApp() {
  const app = createSSRApp(App);
  app.use(scUi, {});
  return {
    app,
  };
}

4. 配置 easycom 组件模式

此配置需要在项目根目录的 pages.json 中进行。

// pages.json
{
  // 如果您是通过uni_modules形式引入 scUi，可以忽略此配置
  "easycom": {
    "^sc-(.*)": "@/uni_modules/sc-ui/components/sc-$1/sc-$1.vue"
  },
  // 此为本身已有的内容
  "pages": [
    // ......
  ]
}

全局样式的配置

app.use(scUi, {
    color: {
      col: '#007AFF',
      jbs: 'linear-gradient(blue, pink)'
    },
});

颜色值的使用

<sc-text color="primary"></sc-text> <sc-button bg-color="success"></sc-button>

工具库

uni.$sc.validate 验证

• isPureNumber: 判断一个字符串是否是纯数字
• isPhone: 判断一个字符串是否是手机号
• isEmail: 判断一个字符串是否是邮箱
• isIdCard: 判断一个字符串是否是身份证号
• isEmpty: 判断一个值是否为空
• isObject: 判断一个值是否为对象

uni.$sc.tools 工具

• px2rpx: 将 px 转换为 rpx
• rpx2px: 将 rpx 转换为 px
• addUnit: 添加单位
• getColor: 获取配置的颜色值
• removeObjectEmptyVal: 删除对象中的空值
• convertColor: 转换颜色值
• deepMerge: 深度合并对象
• deepClone: 深度克隆对象
• throttle: 节流函数
• debounce: 防抖函数

uni.$sc.sysInfo 获取设备信息

• sysInfo: 获取设备信息

基础组件

查阅相关文件注释