carousel.html 27 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733
  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta charset="utf-8">
  5. <title>镜像站@通用轮播组件文档 - Layui</title>
  6. <meta name="renderer" content="webkit">
  7. <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
  8. <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1">
  9. <meta name="apple-mobile-web-app-status-bar-style" content="black">
  10. <meta name="apple-mobile-web-app-capable" content="yes">
  11. <meta name="format-detection" content="telephone=no">
  12. <script>
  13. ;!function(){self!==parent&&(location.href="http://www.baidu.com/")}();
  14. </script>
  15. <link rel="stylesheet" href="/public/layui/dist/css/layui.css" tppabs="http://res.layui.com/layui/dist/css/layui.css?t=1632428048355" media="all">
  16. <link rel="stylesheet" href="/public/static/css/global.css" tppabs="http://res.layui.com/static/css/global.css?t=1632428048355-19" media="all">
  17. </head>
  18. <body>
  19. <div class="layui-header header header-doc" autumn>
  20. <div class="layui-container">
  21. <a class="logo" href="../../index.html" tppabs="http://www.layui.com/">
  22. <img src="/public/static/images/layui/logo.png" tppabs="http://res.layui.com/static/images/layui/logo.png" alt="layui">
  23. </a>
  24. <div class="layui-form layui-hide-xs component" lay-filter="LAY-site-header-component"></div>
  25. <div class="layui-hide-xs site-notice"></div>
  26. <ul class="layui-nav" id="LAY_NAV_TOP">
  27. <li class="layui-nav-item layui-this">
  28. <a href="../index.html" tppabs="http://www.layui.com/doc/">文档</a>
  29. </li>
  30. <li class="layui-nav-item ">
  31. <a href="../../demo/index.html" tppabs="http://www.layui.com/demo/">示例</a>
  32. </li>
  33. <li class="layui-nav-item">
  34. <a href="javascript:;">
  35. <!--<span class="layui-badge-dot" style="left:0; right: auto; margin: -4px 0 0 5px;"></span>-->
  36. 周边
  37. </a>
  38. <dl class="layui-nav-child layui-nav-child-c">
  39. <dd class="layui-hide-sm layui-show-xs" lay-unselect>
  40. <a href="https://gitee.com/sentsin/layui/issues" target="_blank" rel="nofollow">问题反馈</a>
  41. <hr>
  42. </dd>
  43. <dd lay-unselect><a href="../../alone.html" tppabs="http://www.layui.com/alone.html" target="_blank" lay-unselect>独立组件</a></dd>
  44. <dd lay-unselect><a href="../../../fly.layui.com/extend/index.html" target="_blank">扩展组件</a></dd>
  45. </dl>
  46. </li>
  47. <li class="layui-nav-item layui-hide-xs">
  48. <a href="http://gitee.com/sentsin/layui/issues" target="_blank" rel="nofollow">反馈</a>
  49. </li>
  50. </ul>
  51. </div>
  52. </div>
  53. <!-- 让IE8/9支持媒体查询,从而兼容栅格 -->
  54. <!--[if lt IE 9]>
  55. <script src="../../../other/html5shiv/r29/html5.min.js" tppabs="https://cdn.staticfile.org/html5shiv/r29/html5.min.js"></script>
  56. <script src="../../../other/respond.js/1.4.2/respond.min.js" tppabs="https://cdn.staticfile.org/respond.js/1.4.2/respond.min.js"></script>
  57. <![endif]-->
  58. <ul class="site-dir">
  59. <li><a href="#use"><cite>快速使用</cite></a></li>
  60. <li><a href="#options"><cite>基础参数选项</cite></a></li>
  61. <li><a href="#onchange"><cite>切换事件</cite></a></li>
  62. <li><a href="#reload"><cite>重置轮播</cite></a></li>
  63. </ul>
  64. <div class="layui-container layui-row">
  65. <div class="layui-col-md3">
  66. <div class="layui-panel site-menu">
  67. <ul class="layui-menu layui-menu-lg">
  68. <li class="layui-menu-item-group" lay-options="{type: 'group', isAllowSpread: true}">
  69. <div class="layui-menu-body-title">
  70. 基础说明
  71. </div>
  72. <hr>
  73. <ul>
  74. <li class="">
  75. <div class="layui-menu-body-title">
  76. <a href="../index.html" tppabs="http://www.layui.com/doc/">
  77. <span>开始使用 </span>
  78. <span class="layui-font-12 layui-font-gray">Getting Started</span>
  79. </a>
  80. </div>
  81. </li>
  82. <li class="">
  83. <div class="layui-menu-body-title">
  84. <a href="../base/infrastructure.html" tppabs="http://www.layui.com/doc/base/infrastructure.html">
  85. <span>底层方法 </span>
  86. <span class="layui-font-12 layui-font-gray">基础支撑</span>
  87. </a>
  88. </div>
  89. </li>
  90. <li class="">
  91. <div class="layui-menu-body-title">
  92. <a href="../base/element.html" tppabs="http://www.layui.com/doc/base/element.html">
  93. <span>页面元素 </span>
  94. <span class="layui-font-12 layui-font-gray">规范 公共类 属性</span>
  95. </a>
  96. </div>
  97. </li>
  98. <li class="">
  99. <div class="layui-menu-body-title">
  100. <a href="../base/modules.html" tppabs="http://www.layui.com/doc/base/modules.html">
  101. <span>模块规范 </span>
  102. <span class="layui-font-12 layui-font-gray">使用 扩展</span>
  103. </a>
  104. </div>
  105. </li>
  106. <li class="">
  107. <div class="layui-menu-body-title">
  108. <a href="../base/faq.html" tppabs="http://www.layui.com/doc/base/faq.html">
  109. <span>常见问题 </span>
  110. <span class="layui-font-12 layui-font-gray">FAQ</span>
  111. </a>
  112. </div>
  113. </li>
  114. <li class="">
  115. <div class="layui-menu-body-title">
  116. <a href="../base/changelog.html" tppabs="http://www.layui.com/doc/base/changelog.html">
  117. <span>更新日志 </span>
  118. <span class="layui-font-12 layui-font-gray">changelog</span>
  119. <span class="layui-badge-dot"></span>
  120. </a>
  121. </div>
  122. </li>
  123. </ul>
  124. </li>
  125. <li class="layui-menu-item-group" lay-options="{type: 'group', isAllowSpread: true}">
  126. <div class="layui-menu-body-title">
  127. 页面元素
  128. </div>
  129. <hr>
  130. <ul>
  131. <li class="">
  132. <div class="layui-menu-body-title">
  133. <a href="../element/layout.html" tppabs="http://www.layui.com/doc/element/layout.html">
  134. <span>布局 </span>
  135. <span class="layui-font-12 layui-font-gray">栅格 后台管理布局</span>
  136. </a>
  137. </div>
  138. </li>
  139. <li class="">
  140. <div class="layui-menu-body-title">
  141. <a href="../element/color.html" tppabs="http://www.layui.com/doc/element/color.html">
  142. <span>颜色 </span>
  143. <span class="layui-font-12 layui-font-gray">主色调 颜色搭配</span>
  144. </a>
  145. </div>
  146. </li>
  147. <li class="">
  148. <div class="layui-menu-body-title">
  149. <a href="../element/icon.html" tppabs="http://www.layui.com/doc/element/icon.html">
  150. <span>图标 </span>
  151. <span class="layui-font-12 layui-font-gray">iconfont 字体图标</span>
  152. </a>
  153. </div>
  154. </li>
  155. <li class="">
  156. <div class="layui-menu-body-title">
  157. <a href="../element/anim.html" tppabs="http://www.layui.com/doc/element/anim.html">
  158. <span>动画 </span>
  159. <span class="layui-font-12 layui-font-gray">内置 CSS3 动画</span>
  160. </a>
  161. </div>
  162. </li>
  163. <li class="">
  164. <div class="layui-menu-body-title">
  165. <a href="../element/button.html" tppabs="http://www.layui.com/doc/element/button.html">
  166. <span>按钮 </span>
  167. <span class="layui-font-12 layui-font-gray">button</span>
  168. </a>
  169. </div>
  170. </li>
  171. <li class="">
  172. <div class="layui-menu-body-title">
  173. <a href="../element/form.html" tppabs="http://www.layui.com/doc/element/form.html">
  174. <span>表单 </span>
  175. <span class="layui-font-12 layui-font-gray">form 元素集合</span>
  176. </a>
  177. </div>
  178. </li>
  179. <li class="">
  180. <div class="layui-menu-body-title">
  181. <a href="../element/nav.html" tppabs="http://www.layui.com/doc/element/nav.html">
  182. <span>导航 </span>
  183. <span class="layui-font-12 layui-font-gray">nav 面包屑</span>
  184. </a>
  185. </div>
  186. </li>
  187. <li class="">
  188. <div class="layui-menu-body-title">
  189. <a href="../element/menu.html" tppabs="http://www.layui.com/doc/element/menu.html">
  190. <span>菜单 </span>
  191. <span class="layui-font-12 layui-font-gray">menu 基础菜单</span>
  192. <span class="layui-badge-dot"></span>
  193. </a>
  194. </div>
  195. </li>
  196. <li class="">
  197. <div class="layui-menu-body-title">
  198. <a href="../element/tab.html" tppabs="http://www.layui.com/doc/element/tab.html">
  199. <span>选项卡 </span>
  200. <span class="layui-font-12 layui-font-gray">Tabs 切换</span>
  201. </a>
  202. </div>
  203. </li>
  204. <li class="">
  205. <div class="layui-menu-body-title">
  206. <a href="../element/progress.html" tppabs="http://www.layui.com/doc/element/progress.html">
  207. <span>进度条 </span>
  208. <span class="layui-font-12 layui-font-gray">progress</span>
  209. </a>
  210. </div>
  211. </li>
  212. <li class="">
  213. <div class="layui-menu-body-title">
  214. <a href="../element/panel.html" tppabs="http://www.layui.com/doc/element/panel.html">
  215. <span>面板 </span>
  216. <span class="layui-font-12 layui-font-gray">panel 卡片 折叠</span>
  217. </a>
  218. </div>
  219. </li>
  220. <li class="">
  221. <div class="layui-menu-body-title">
  222. <a href="../element/table.html" tppabs="http://www.layui.com/doc/element/table.html">
  223. <span>表格 </span>
  224. <span class="layui-font-12 layui-font-gray">静态 table</span>
  225. </a>
  226. </div>
  227. </li>
  228. <li class="">
  229. <div class="layui-menu-body-title">
  230. <a href="../element/badge.html" tppabs="http://www.layui.com/doc/element/badge.html">
  231. <span>徽章 </span>
  232. <span class="layui-font-12 layui-font-gray">小圆点 小边框</span>
  233. </a>
  234. </div>
  235. </li>
  236. <li class="">
  237. <div class="layui-menu-body-title">
  238. <a href="../element/timeline.html" tppabs="http://www.layui.com/doc/element/timeline.html">
  239. <span>时间线 </span>
  240. <span class="layui-font-12 layui-font-gray">timeline</span>
  241. </a>
  242. </div>
  243. </li>
  244. <li class="">
  245. <div class="layui-menu-body-title">
  246. <a href="../element/auxiliar.html" tppabs="http://www.layui.com/doc/element/auxiliar.html">
  247. <span>辅助 </span>
  248. <span class="layui-font-12 layui-font-gray">引用 字段集 横线等</span>
  249. </a>
  250. </div>
  251. </li>
  252. </ul>
  253. </li>
  254. <li class="layui-menu-item-group" lay-options="{type: 'group', isAllowSpread: true}">
  255. <div class="layui-menu-body-title">
  256. 内置模块
  257. </div>
  258. <hr>
  259. <ul>
  260. <li class="">
  261. <div class="layui-menu-body-title">
  262. <a href="layer.html" tppabs="http://www.layui.com/doc/modules/layer.html">
  263. <span>弹出层 </span>
  264. <span class="layui-font-12 layui-font-gray">layer</span>
  265. </a>
  266. </div>
  267. </li>
  268. <li class="">
  269. <div class="layui-menu-body-title">
  270. <a href="laydate.html" tppabs="http://www.layui.com/doc/modules/laydate.html">
  271. <span>日期与时间选择 </span>
  272. <span class="layui-font-12 layui-font-gray">laydate</span>
  273. </a>
  274. </div>
  275. </li>
  276. <li class="">
  277. <div class="layui-menu-body-title">
  278. <a href="laypage.html" tppabs="http://www.layui.com/doc/modules/laypage.html">
  279. <span>分页 </span>
  280. <span class="layui-font-12 layui-font-gray">laypage</span>
  281. </a>
  282. </div>
  283. </li>
  284. <li class="">
  285. <div class="layui-menu-body-title">
  286. <a href="laytpl.html" tppabs="http://www.layui.com/doc/modules/laytpl.html">
  287. <span>模板引擎 </span>
  288. <span class="layui-font-12 layui-font-gray">laytpl</span>
  289. </a>
  290. </div>
  291. </li>
  292. <li class="">
  293. <div class="layui-menu-body-title">
  294. <a href="table.html" tppabs="http://www.layui.com/doc/modules/table.html">
  295. <span>数据表格 </span>
  296. <span class="layui-font-12 layui-font-gray">table</span>
  297. </a>
  298. </div>
  299. </li>
  300. <li class="">
  301. <div class="layui-menu-body-title">
  302. <a href="form.html" tppabs="http://www.layui.com/doc/modules/form.html">
  303. <span>表单 </span>
  304. <span class="layui-font-12 layui-font-gray">form</span>
  305. </a>
  306. </div>
  307. </li>
  308. <li class="">
  309. <div class="layui-menu-body-title">
  310. <a href="upload.html" tppabs="http://www.layui.com/doc/modules/upload.html">
  311. <span>文件上传 </span>
  312. <span class="layui-font-12 layui-font-gray">upload</span>
  313. </a>
  314. </div>
  315. </li>
  316. <li class="">
  317. <div class="layui-menu-body-title">
  318. <a href="dropdown.html" tppabs="http://www.layui.com/doc/modules/dropdown.html">
  319. <span>下拉菜单 </span>
  320. <span class="layui-font-12 layui-font-gray">dropdown</span>
  321. <span class="layui-badge-dot"></span>
  322. </a>
  323. </div>
  324. </li>
  325. <li class="">
  326. <div class="layui-menu-body-title">
  327. <a href="transfer.html" tppabs="http://www.layui.com/doc/modules/transfer.html">
  328. <span>穿梭框 </span>
  329. <span class="layui-font-12 layui-font-gray">transfer</span>
  330. </a>
  331. </div>
  332. </li>
  333. <li class="">
  334. <div class="layui-menu-body-title">
  335. <a href="tree.html" tppabs="http://www.layui.com/doc/modules/tree.html">
  336. <span>树形组件 </span>
  337. <span class="layui-font-12 layui-font-gray">tree</span>
  338. </a>
  339. </div>
  340. </li>
  341. <li class="">
  342. <div class="layui-menu-body-title">
  343. <a href="colorpicker.html" tppabs="http://www.layui.com/doc/modules/colorpicker.html">
  344. <span>颜色选择器 </span>
  345. <span class="layui-font-12 layui-font-gray">colorpicker</span>
  346. </a>
  347. </div>
  348. </li>
  349. <li class="">
  350. <div class="layui-menu-body-title">
  351. <a href="element.html" tppabs="http://www.layui.com/doc/modules/element.html">
  352. <span>常用元素操作 </span>
  353. <span class="layui-font-12 layui-font-gray">element</span>
  354. </a>
  355. </div>
  356. </li>
  357. <li class="">
  358. <div class="layui-menu-body-title">
  359. <a href="slider.html" tppabs="http://www.layui.com/doc/modules/slider.html">
  360. <span>滑块 </span>
  361. <span class="layui-font-12 layui-font-gray">slider</span>
  362. </a>
  363. </div>
  364. </li>
  365. <li class="">
  366. <div class="layui-menu-body-title">
  367. <a href="rate.html" tppabs="http://www.layui.com/doc/modules/rate.html">
  368. <span>评分 </span>
  369. <span class="layui-font-12 layui-font-gray">rate</span>
  370. </a>
  371. </div>
  372. </li>
  373. <li class="layui-menu-item-checked2">
  374. <div class="layui-menu-body-title">
  375. <a href="carousel.html" tppabs="http://www.layui.com/doc/modules/carousel.html">
  376. <span>轮播 </span>
  377. <span class="layui-font-12 layui-font-gray">carousel</span>
  378. </a>
  379. </div>
  380. </li>
  381. <li class="">
  382. <div class="layui-menu-body-title">
  383. <a href="layedit.html" tppabs="http://www.layui.com/doc/modules/layedit.html">
  384. <span>富文本编辑器 </span>
  385. <span class="layui-font-12 layui-font-gray">layedit</span>
  386. </a>
  387. </div>
  388. </li>
  389. <li class="">
  390. <div class="layui-menu-body-title">
  391. <a href="flow.html" tppabs="http://www.layui.com/doc/modules/flow.html">
  392. <span>流加载 </span>
  393. <span class="layui-font-12 layui-font-gray">flow</span>
  394. </a>
  395. </div>
  396. </li>
  397. <li class="">
  398. <div class="layui-menu-body-title">
  399. <a href="util.html" tppabs="http://www.layui.com/doc/modules/util.html">
  400. <span>工具组件 </span>
  401. <span class="layui-font-12 layui-font-gray">util</span>
  402. </a>
  403. </div>
  404. </li>
  405. <li class="">
  406. <div class="layui-menu-body-title">
  407. <a href="code.html" tppabs="http://www.layui.com/doc/modules/code.html">
  408. <span>代码高亮显示 </span>
  409. <span class="layui-font-12 layui-font-gray">code</span>
  410. </a>
  411. </div>
  412. </li>
  413. </ul>
  414. </li>
  415. </ul>
  416. </div>
  417. <div class="layui-hide-v"> - </div>
  418. </div>
  419. <div class="layui-col-md9 site-content">
  420. <h1 class="site-h1"><i class="layui-icon">&#xe634;</i> 通用轮播组件文档 - layui.carousel</h1>
  421. <blockquote class="layui-elem-quote">
  422. carousel 是 layui 2.0 版本中新增的全新模块,主要适用于跑马灯/轮播等交互场景。它并非单纯地为焦点图而生,准确地说,它可以满足任何类型内容的轮播式切换操作,更可以胜任 FullPage (全屏上下轮播)的需求,简洁而不失强劲,灵活而优雅。
  423. </blockquote>
  424. <blockquote class="layui-elem-quote">
  425. <p>模块加载名称:<em>carousel</em></p>
  426. </blockquote>
  427. <fieldset class="layui-elem-field layui-field-title site-title">
  428. <legend><a name="use">快速使用</a></legend>
  429. </fieldset>
  430. <div class="site-text">
  431. <p>如下是几个常用的轮播示例,其中背景色是为了区分条目单独加的,在layui框架中并不会包含。条目区域可以放上文字列表、图片等任意内容</p>
  432. </div>
  433. <style>
  434. /* 为了区分效果 */
  435. div[carousel-item]>*{text-align: center; line-height: 280px; color: #fff;}
  436. div[carousel-item]>*:nth-child(2n){background-color: #5FB878;}
  437. div[carousel-item]>*:nth-child(2n+1){background-color: #009688;}
  438. #test2 div[carousel-item]>*{line-height: 120px;}
  439. </style>
  440. <div class="layui-carousel" id="test1">
  441. <div carousel-item>
  442. <div>条目1</div>
  443. <div>条目2</div>
  444. <div>条目3</div>
  445. <div>条目4</div>
  446. <div>条目5</div>
  447. </div>
  448. </div>
  449. <div class="site-text">
  450. <p></p>
  451. <pre class="layui-code" lay-title="对应的代码">
  452. &lt;!DOCTYPE html&gt;
  453. &lt;html&gt;
  454. &lt;head&gt;
  455. &lt;meta charset=&quot;utf-8&quot;&gt;
  456. &lt;title&gt;carousel模块快速使用&lt;/title&gt;
  457. &lt;link rel=&quot;stylesheet&quot; href=&quot;/static/build/layui.css&quot; media=&quot;all&quot;&gt;
  458. &lt;/head&gt;
  459. &lt;body&gt;
  460. &lt;div class=&quot;layui-carousel&quot; id=&quot;test1&quot;&gt;
  461. &lt;div carousel-item&gt;
  462. &lt;div&gt;条目1&lt;/div&gt;
  463. &lt;div&gt;条目2&lt;/div&gt;
  464. &lt;div&gt;条目3&lt;/div&gt;
  465. &lt;div&gt;条目4&lt;/div&gt;
  466. &lt;div&gt;条目5&lt;/div&gt;
  467. &lt;/div&gt;
  468. &lt;/div&gt;
  469. &lt;!-- 条目中可以是任意内容,如:&lt;img src=""&gt; --&gt;
  470. &lt;script src=&quot;/static/build/layui.js&quot;&gt;&lt;/script&gt;
  471. &lt;script&gt;
  472. layui.use(&#x27;carousel&#x27;, function(){
  473. var carousel = layui.carousel;
  474. //建造实例
  475. carousel.render({
  476. elem: '#test1'
  477. ,width: '100%' //设置容器宽度
  478. ,arrow: 'always' //始终显示箭头
  479. //,anim: 'updown' //切换动画方式
  480. });
  481. });
  482. &lt;/script&gt;
  483. &lt;/body&gt;
  484. &lt;/html&gt;</pre>
  485. <p>
  486. 在HTML结构中,只需要简单地注意这两项:
  487. <br>1) 外层元素的 <em>class="layui-carousel"</em> 用来标识为一个轮播容器
  488. <br>2) 内层元素的属性 <em>carousel-item</em> 用来标识条目
  489. </p>
  490. <p>而 <em>id</em> 则用于carousel模块建造实例的元素指向,剩下的工作,就是按照你的实际需求,给方法设置不同的基础参数了。</p>
  491. </div>
  492. <fieldset class="layui-elem-field layui-field-title site-title">
  493. <legend><a name="options">基础参数选项</a></legend>
  494. </fieldset>
  495. <div class="site-text">
  496. <p>通过核心方法:<em>carousel.render(options)</em> 来对轮播设置基础参数,也可以通过方法:<em>carousel.set(options)</em> 来设定全局基础参数.</p>
  497. </div>
  498. <table class="layui-table">
  499. <colgroup>
  500. <col width="120">
  501. <col>
  502. <col width="120">
  503. <col width="200">
  504. </colgroup>
  505. <thead>
  506. <tr>
  507. <th>可选项</th>
  508. <th>说明</th>
  509. <th>类型</th>
  510. <th>默认值</th>
  511. </tr>
  512. </thead>
  513. <tbody>
  514. <tr>
  515. <td>elem</td>
  516. <td>指向容器选择器,如:elem: '#id'。也可以是DOM对象</td>
  517. <td>string/object</td>
  518. <td>无</td>
  519. </tr>
  520. <tr>
  521. <td>width</td>
  522. <td>设定轮播容器宽度,支持像素和百分比</td>
  523. <td>string</td>
  524. <td>'600px'</td>
  525. </tr>
  526. <tr>
  527. <td>height</td>
  528. <td>设定轮播容器高度,支持像素和百分比</td>
  529. <td>string</td>
  530. <td>'280px'</td>
  531. </tr>
  532. <tr>
  533. <td>full</td>
  534. <td>是否全屏轮播</td>
  535. <td>boolean</td>
  536. <td>false</td>
  537. </tr>
  538. <tr>
  539. <td>anim</td>
  540. <td class="layui-text">
  541. 轮播切换动画方式,可选值为:
  542. <ul>
  543. <li>default(左右切换)</li>
  544. <li>updown(上下切换)</li>
  545. <li>fade(渐隐渐显切换)</li>
  546. </ul>
  547. </td>
  548. <td>string</td>
  549. <td>'default'</td>
  550. </tr>
  551. <tr>
  552. <td>autoplay</td>
  553. <td>是否自动切换</td>
  554. <td>boolean</td>
  555. <td>true</td>
  556. </tr>
  557. <tr>
  558. <td>interval</td>
  559. <td>自动切换的时间间隔,单位:ms(毫秒),不能低于800</td>
  560. <td>number</td>
  561. <td>3000</td>
  562. </tr>
  563. <tr>
  564. <td>index</td>
  565. <td>初始开始的条目索引</td>
  566. <td>number</td>
  567. <td>0</td>
  568. </tr>
  569. <tr>
  570. <td>arrow</td>
  571. <td class="layui-text">
  572. 切换箭头默认显示状态,可选值为:
  573. <ul>
  574. <li>hover(悬停显示)</li>
  575. <li>always(始终显示)</li>
  576. <li>none(始终不显示)</li>
  577. </ul>
  578. </td>
  579. <td>string</td>
  580. <td>'hover'</td>
  581. </tr>
  582. <tr>
  583. <td>indicator</td>
  584. <td class="layui-text">
  585. 指示器位置,可选值为:
  586. <ul>
  587. <li>inside(容器内部)</li>
  588. <li>outside(容器外部)</li>
  589. <li>none(不显示)</li>
  590. </ul>
  591. <br>注意:如果设定了 <em>anim:'updown'</em>,该参数将无效
  592. </td>
  593. <td>string</td>
  594. <td>'inside'</td>
  595. </tr>
  596. <tr>
  597. <td>trigger</td>
  598. <td class="layui-text">
  599. 指示器的触发事件
  600. </td>
  601. <td>string</td>
  602. <td>'click'</td>
  603. </tr>
  604. </tbody>
  605. </table>
  606. <fieldset class="layui-elem-field layui-field-title site-title">
  607. <legend><a name="onchange">切换事件</a></legend>
  608. </fieldset>
  609. <div class="site-text">
  610. <p>轮播的每一次切换时触发,回调函数返回一个object参数,携带的成员如下:</p>
  611. <pre class="layui-code">
  612. var carousel = layui.carousel;
  613. //触发轮播切换事件
  614. carousel.on('change(test1)', function(obj){ //test1来源于对应HTML容器的 <em>lay-filter="test1"</em> 属性值
  615. console.log(obj.index); //当前条目的索引
  616. console.log(obj.prevIndex); //上一个条目的索引
  617. console.log(obj.item); //当前条目的元素对象
  618. });
  619. </pre>
  620. </div>
  621. <fieldset class="layui-elem-field layui-field-title site-title">
  622. <legend><a name="reload">重置轮播</a></legend>
  623. </fieldset>
  624. <div class="site-text">
  625. <p>事实上,在执行 <em>carousel.render(options)</em> 方法时,有返回一个当前实例的对象。该对象包含了用于操作当前轮播的一些属性和方法。</p>
  626. <pre class="layui-code">
  627. var ins = carousel.render(options);
  628. //重置轮播
  629. ins.reload(options);
  630. </pre>
  631. </div>
  632. <fieldset class="layui-elem-field layui-field-title site-title">
  633. <legend><a name="docend">结语</a></legend>
  634. </fieldset>
  635. <div class="site-text">
  636. <p>由于轮播的使用非常简单,所以本篇不做过于详细的讲解,核心在于基础参数选项的设置。你也可以前往示例页面进行更为直观的了解。</p>
  637. </div>
  638. <div class="layui-elem-quote">
  639. <p>layui - 在每一个细节中,用心与你沟通</p>
  640. </div>
  641. </div>
  642. </div>
  643. <div class="layui-footer footer footer-doc">
  644. <p>
  645. Copyright &copy; 2021 <a href="../../index.html" tppabs="http://www.layui.com/">「本站仅为 layui 文档保留的镜像站点,与官方无关」</a> MIT Licensed</p>
  646. <p>
  647. <a href="../../about/disclaimer.html" tppabs="http://www.layui.com/about/disclaimer.html" target="_blank">免责声明</a>
  648. <a href="../../about/relatedlinks.html" tppabs="http://www.layui.com/about/relatedlinks.html" target="_blank">友链</a>
  649. <a href="javascript:;" site-event="weixinmp">公众号</a>
  650. </p>
  651. </div>
  652. <script>
  653. window.global = {
  654. pageType: 'doc'
  655. ,preview: function(){
  656. var preview = document.getElementById('LAY_preview');
  657. return preview ? preview.innerHTML : '';
  658. }()
  659. };
  660. </script>
  661. <div class="site-tree-mobile layui-hide">
  662. <i class="layui-icon layui-icon-spread-left"></i>
  663. </div>
  664. <div class="site-mobile-shade"></div>
  665. <script src="/public/layui/dist/layui.js" tppabs="http://res.layui.com/layui/dist/layui.js?t=1632428048355" charset="utf-8"></script>
  666. <script>
  667. layui.config({
  668. base: '/public/static/lay/modules/layui/'
  669. ,version: '1632428048355'
  670. }).use('global');
  671. </script>
  672. <script>
  673. layui.use('carousel', function(){
  674. var carousel = layui.carousel;
  675. //建造实例
  676. carousel.render({
  677. elem: '#test1'
  678. ,width: '100%'
  679. ,arrow: 'always'
  680. });
  681. });
  682. </script>
  683. </body>
  684. </html>