[模板开发] 必备 JS 工具库



  • AckyStack-JS-Utils

    AckyStackCMS 客户端模板会用到的 JS 工具,该工具封装了基于 Axios 的 get 以及 post 请求以及消息编码解码和密码加密等方法。该库能够让前端开发者更加流畅的定制自己的模板以及实现无需刷新页面即可完成前后端交互来增强用户体验

    项目地址:https://github.com/AckyStack/AckyStack-JS-Utils

    使用方法

    在页面中中引入 AckyStackUtils.js 文件即可调用

    • 支持 CDN 方式引用(推荐) https://cdn.jsdelivr.net/gh/AckyStack/AckyStack-JS-Utils/AckyStackUtils.min.js
    • 支持下载后本地引用

    调用对象名称:AckyUtils
    示例:

    const data = {a:'nmsl',b:'test'}
    
    AckyUtils.$post('/api/v1/xxxx',data).then(res=>{
        if (res['ret'] === 0) console.log("请求成功!!!")
    }).catch(reason=>{
        if (reason['ret']>0) console.log(`错误:${reason['msg']}`)
    })
    

    方法列表

    • $post(url,data) 发送 post 表单请求

      • @param url 请求目标 url
      • @param data 表单参数对象(js 对象)
      • @returns Axios 的 Promise
    • $get(url) 发送 get 请求

      • @param url 请求目标 url(自行拼接参数)
      • @returns Axios 的 Promise
    • $axiosInstance() 获取 Axios 实例对象(定制化请求时使用)

      • @returns Axios 对象
    • $resultMsgEncode(ret, title, description, actionTitle, actionUrl) 编码跨页面提示消息

      • @param ret (string)状态码 (支持值:success, error, warning, info)
      • @param title (string)消息标题
      • @param description(string)消息内容
      • @param actionTitle(string)操作名称
      • @param actionUrl(string)操作链接地址(如果操作是按钮的化可能需要此项)
      • @returns {string} 构建之后的 token,已进行 url encoding
    • $resultMsgDecode(token) 解码跨页面提示消息

      • @param token 消息令牌
      • @returns json 对象(参考构建消息令牌的方法)
    • $calcPassword(username, password) 加密用户密码

      • @param username 用户名(盐)
      • @param password 密码明文
      • @returns {string} 加密后md5字符串
    • $genRandomStr(t) 生成随机字符串 (位数越高越低重复率且 url 友好)

      • @param t 生成位数
      • @returns {string} 生成的随机字符串


合作伙伴

友情链接

Copytight © 2020 AckyStack & Fttft Studio. All rights reserved.