MIP.util

  1. MIP.util
  2. window.MIP.util

描述

MIP.util 对象是工具库的入口文件，除了暴露了 fn dom 等其他的工具库外，本身还提供了 parseCacheUrl, makeCacheUrl 和 getOriginalUrl 函数

属性

fn

  • type: Object

    一些函数式的工具函数，参考工具

dom

  • type: Object

    DOM 相关的工具函数，参考DOM

event

  • type: Object

    事件代理工具函数，参考event

rect

  • type: Object

    DOM 位置相关的工具函数，参考rect

hash

  • type: Object

    hash 相关的工具，参考hash

platform

  • type: Object

    当前所处平台相关的工具，如浏览器和系统，参考platform

EventEmitter

  • type: EventEmitter

    EventEmitter 类，提供了 mixin 函数，参考EventEmitter

Gesture

  • type: Gesture

    手势相关的工具，参考Gesture

customStorage

naboo

  • type: Object

    动画库 Naboo，参考naboo

方法

css

  • 参数：
    • {Array.\|NodeList|HTMLElement} elements 需要设置的元素或者数组
    • {Object.|string} property 属性名，如果是 Object，则为属性和值的键值对 css(element, {left: 0, top: 0})
    • {string|number=} value 属性值

  • 返回值：

    {Array.\|HTMLElement|string}

    • 如果 elements 为数组，返回值为数组
    • 如果 elements 单个 HTMLElement，并且有属性值，返回值为 HTMLElement
    • 如果没有需要的属性值，返回值为该 HTMLElement 对应属性的值

  • 用法：

    设置或者获取元素对应属性的值

    1. let element = document.querySelector('#id')
    2. let elements = document.querySelectorAll('a')
    3. // 获取 #id 的 color 值
    4. MIP.util.css(element, 'color')
    5. // 设置 #id 的颜色为 #ccc
    6. MIP.util.css(element, 'color', '#ccc')
    7. // 设置 a 链接的颜色为 #ccc
    8. MIP.util.css(elements, 'color', '#ccc')
    9. // 设置 a 链接的颜色和字体大小
    10. MIP.util.css(elements, {color: '#ccc', 'font-size': '14px'})

jsonParse

  • 参数：
    • {string} jsonStr 需要转成 JSON 的字符串

  • 用法：

    可以将不符合标准 JSON 标准的字符串转为 JSON，当然需要是正确的 JSON 字符串

    1. // 返回值为 {a: 1, b: 2, c: 3}
    2. MIP.util.jsonParse('{a: 1, \'b\': 2, "c": 3}')

parseCacheUrl

  • 参数：
    • {string} url 源 URL

  • 返回值：

    {string} 处理后的 URL

  • 用法：

    把 Cache URL 处理为源 URL

    1. // 返回 https://www.mipengine.org/static/index.html
    2. MIP.util.parseCacheUrl('https://mipcache.bdstatic.com/c/www.mipengine.org/static/index.html')

makeCacheUrl

  • 参数：
    • {string} url 源 URL
    • {string} type URL 的类型，目前只有两种情况，img 或者为空
    • {boolean} containsHost 是否需要包含 host

  • 返回值：

    {string} 返回的 Cache URL

  • 用法：

    将一个 URL 处理为 Cache URL

    1. // 返回值为 /c/s/www.mipengine.com
    2. MIP.util.makeCacheUrl('https://www.mipengine.com')

    参考相关测试用例

isCacheUrl

  • 参数：
    • {string} url

  • 返回值：

    {boolean} 是否为 MIP Cache URL

  • 用法：

    判断链接是否为 MIP Cache URL

    1. // 返回 true
    2. MIP.util.isCacheUrl('http://www-mipengine-com.mipcdn.com/c/www.mipengine.com/docs/index.html')