这是一卷图库的开发者文档/教程。一卷图库内的图片均采用CC BY-NC-SA 4.0许可进行授权。
投稿QQ: 2399052066 (纸鹿)
在线预览(由Imgtg托管)
引入
在HTML中插入如下代码,随后便可以执行图库相关功能。
1 | <script src="https://thisis.host/monoroll/load.js" onload="//你的功能"></script> |
将需要执行的函数声明在MGLoad()中。
绑定要应用背景的元素
1 | MG.bgBind(ele) |
ele为DOM元素，如document.documentElement、document.getElementById("main")等。
绑定要应用背景的元素时，会自动给该元素设置背景居中、背景自适应缩放属性，如果不需要，请传入一个非真的值作为第二个参数，例如：MG.bgBind(ele, false)。
绑定要输出图片信息的元素
1 | MG.infoBind(ele) |
ele为DOM元素，如document.getElementById("bgInfo")等。被绑定的元素用于输出图片信息。
设置背景的几种方式
绑定应用背景的元素、要输出图片信息的元素后，就可以设置背景了。
根据索引位置（数组下标）设置
1 | MG.setBg(index) |
特别地，index为负时，索引会从末端倒数。
随机设置
1 | MG.setRandBg() |
函数的唯一参数alpha默认为1，表示随机是均匀的。它应该是大于零的实数，推荐范围在0.1 ~ 2，值越小则越倾向于较小的索引（老图），反之则越倾向于较大的索引（新图）。
通过图片唯一标识符（图片ID）设置
1 | MG.setBgByPicId(yyMMNN) |
参数yyMMNN是格式为yyMMNN的图片唯一标识符（图片ID），其中yy为两位数的年份，MM为两位数的月份，NN为月份内图片索引。例如，211101指2021年11月的第1张图片。
通过图片期数设置
1 | MG.setBgByIssue(yyMM) |
参数yyMM是格式为yyMM的图片期数（即图片ID前四位，格式参见上一项），这样会随机设置此期内的一张图片作为背景。
技术细节
点击加载样例