3.0.4 • Published 2 years ago

keepfit v3.0.4

Weekly downloads
-
License
ISC
Repository
-
Last release
2 years ago

KeepFit

指定一个DOM节点,使其按照 宽度/高度/两者 为基准的缩放方式,或按100px = 1rem的规则,来适应浏览器窗口尺寸。通常用于按照数据可视化大屏设计图进行的前端开发,针对不同尺寸和比例显示设备的自适应。

引用 - Install

ES5

<script src="keepfit.min.js"></script>

AMD

require(['keepfit'], (keepfit)=>{ /* code here */ })

CMD

const keepfit = require('./keepfit')

NPM

npm install keepfit

文档 - Document

keepfit(target, options);
参数类型描述
targetobjectdocument.bodyDOM元素节点
optionsobject{ size, mode, fit, align, lock }参数
options.modestring'scale', 'rem'默认: scale (v3)
options.sizearray[1920, 1080]设计图尺寸

Scale Mode

参数类型描述
options.fitstring'width', 'height', 'both'scale: 缩放基准
options.alignstring'center', 'top center'scale: 缩放中心点
options.lockstringtrue, false锁定屏幕方向 (v3)
options.px2remstring100兼容基于rem模式的缩放

Rem Mode

参数类型描述
options.px2remstring100100px = 1rem (不建议修改此值)

示例 - Use

// 缩放模式
keepfit(document.querySelector('#app'), {
    size: [1920, 1080],
    mode: 'scale',
    fit: 'both',
    align: 'center top'
});


// rem模式
// 100px = 1rem,窗口尺寸变化时会自动计算 html 的 font-size 值
keepfit(document.querySelector('#app'), {
    mode: 'rem',
    size: [1920, 1080]
});

注意 - Tips

  • 默认采用缩放模式,此时页面中CSS单位可放心使用px
  • 使用rem模式时,fitalign参数将被忽略,需要按照100px = 1rem规则编写css
  • 如有疑惑,请参考samples目录中的案例
3.0.4

2 years ago

3.0.3

2 years ago

3.0.2

2 years ago

3.0.1

2 years ago

2.0.3

2 years ago

2.0.4

2 years ago

2.0.2

2 years ago

3.0.0

2 years ago

2.0.1

2 years ago

2.0.0

2 years ago

1.0.2

3 years ago

1.0.1

3 years ago

1.0.0

3 years ago