# sinmajs

**Repository Path**: sinma/sinmajs

## Basic Information

- **Project Name**: sinmajs
- **Description**: sinma.js 常用JS函数集合
- **Primary Language**: JavaScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: http://www.sinma.net/
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2023-01-06
- **Last Updated**: 2025-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# sinmajs

#### 介绍
sinma.js 常用的JavaScript工具函数集合 - 专为中文开发者设计的实用工具库

#### 版本历史
- **v0.1.0 (2025-08-23)** - 重大更新版本
  - 修复了关键bug（手机号正则、身份证验证、验证码倒计时等）
  - 统一了代码规范和函数命名
  - 添加了JSDoc注释，提升代码可读性
  - Vue.js版本采用UMD模块化，支持多种环境
  - 新增实用功能：邮箱验证、URL验证、防抖、节流、深度克隆等
  - 优化性能：缓存正则表达式，避免重复编译

#### 软件架构
本库提供四个版本，适用于不同开发场景：
- **javascript/** - 原生JavaScript版本（推荐）
- **jquery/** - jQuery兼容版本 
- **vuejs/** - Vue.js版本，支持UMD模块化
- **apicloud/** - APICloud版本（已停止维护）

[详细说明书](https://www.kancloud.cn/sinma/sinmajs/3151960)


#### 主要功能

**数据验证类**
- `isNumber()` / `isNumber2()` - 数字验证（两种方式）
- `isPhonenum()` / `isPhonenum1()` - 手机号验证（宽松/严格）
- `isTelnum()` / `isTelnum1()` - 座机号验证（宽松/严格）
- `isSfz()` / `isSfz1()` - 身份证验证（宽松/严格）
- `isEmail()` - 邮箱验证 ⭐新增
- `isUrl()` - URL验证 ⭐新增
- `isObj()` / `isEmpty()` - 对象和空值判断

**时间处理类**
- `getnowDatetime()` / `getnowDate()` - 获取当前时间/日期
- `getoldDate()` - 获取指定日期
- `turntime()` / `turntimemore()` - Unix时间戳转换
- `calculateAge()` - 计算年龄

**实用工具类**
- `suijishu()` - 生成随机数字或字母
- `cutmoney()` - 金额格式化（万、亿单位）
- `debounce()` / `throttle()` - 防抖和节流 ⭐新增
- `deepClone()` - 深度克隆对象 ⭐新增
- `GetQueryString()` - 获取URL参数
- `getBase64Image()` - 图片转Base64

**UI交互类**
- `yzmdjs()` - 验证码倒计时
- `tiaomiao()` - 实时显示时间
- `setOpacity()` - 设置透明度

#### 使用说明

**安装引用：**
```html
<!-- 原生JavaScript / jQuery版本 -->
<script src="javascript/sinma.js"></script>
<!-- 或 -->
<script src="jquery/sinma.js"></script>

<!-- Vue.js版本 -->
<script src="vuejs/sinma.js"></script>
<!-- 或通过模块导入 -->
<script>
const sinma = require('./vuejs/sinma.js');
// 或
import sinma from './vuejs/sinma.js';
</script>
```

**基本使用：**
```javascript
// 数据验证
sinma.isPhonenum('13812345678'); // true
sinma.isEmail('test@example.com'); // true
sinma.isSfz('身份证号码'); // 验证身份证

// 时间处理
sinma.getnowDatetime(); // "2025-08-23 14:30:25"
sinma.calculateAge('1990-01-01'); // 计算年龄

// 实用工具
sinma.cutmoney(12345678); // "1.23亿"
sinma.suijishu(6, 1); // 生成6位随机字符串

// 防抖节流
const debouncedFn = sinma.debounce(function() {
    console.log('防抖执行');
}, 300);
```

[详细说明书](https://www.kancloud.cn/sinma/sinmajs/3151960)

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2. [www.sinma.net](http://www.sinma.net/)
3. QQ:42033223  欢迎交流