更新时间:2019-12-17 23:47:57
依赖
jQuery (1.8.0 或以上版本)
兼容
Chrome, Firefox, Edge, Safari, IE9+
引入 jQuery 和 HappyImage 文件
<script src="jquery.min.js"></script> <script src="happyimage.min.js"></script>
使用
// 创建 $( selector ).HappyImage( options ); // 销毁 $( selector ).destroyHappyImage(); // 异步控制 HappyImage( selector, index );
示例
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>HappyImage</title>
<style>
#target { width:700px;height:300px;overflow:hidden;position:relative; }
#target img { position:absolute;top:0;left:0;width:100%;height:100%; }
</style>
</head>
<body>
<div id="target">
<div>
<div><img src="1.jpg"></div>
<div><img src="2.jpg"></div>
<div><img src="3.jpg"></div>
<div><img src="4.jpg"></div>
</div>
</div>
<script src="jquery.min.js"></script>
<script src="HappyImage.min.js"></script>
<script>
$( "#target" ).HappyImage();
</script>
</body>
</html>配置
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| width | 容器宽度,可通过 css 设置,可以是 px 或 百分比 | Number / String / null | null |
| height | 容器高度,可通过 css 设置,可以是 px 或 百分比 | Number / String / null | null |
| effect | 轮播图切换效果,可选值:fade / slide | String | slide |
| duration | 轮播图切换动画的过渡时长,单位:ms | Number | 700 |
| defaultIndex | 默认索引 | Number | 0 |
| arrow | 箭头切换器。true 表示使用内置的箭头;false 则不显示箭头;如果传入数组(2个元素)表示使用自定义元素,如:[ "#prev", "#next" ] | Boolean / Array | true |
| dot | 圆点切换器。true 表示使用内置的圆点;false 则不显示圆点;如果传入字符串选择器表示使用自定义圆点控制器,此选择器对应的元素的子元素就是圆点,如:"#dot-wrapper" | Boolean / String | true |
| arrowHoverShow | 当鼠标悬浮在目标元素上时,才显示箭头切换器(只对内置箭头有效) | Boolean | false |
| dotAlign | 圆点切换器的对齐方式,可选值:left / center / right | String | center |
| autoplay | 自动播放的时间间隔,单位:ms,设置为 0 则关闭自动播放功能 | Number | 0 |
| onChange | 轮播图切换时执行的回调函数,参数是当前图片的索引 | Function | 空函数 |