Framework7 - Refresh 刷新
说明
Refresh 这是一个特殊的组件,用于通过拉动来刷新(重新加载)页面内容。
以下代码显示了如何刷新页面内容 −
<div class = "page"> <!-- Page content should have additional "pull-to-refresh-content" class --> <div class = "page-content pull-to-refresh-content" data-ptr-distance = "55"> <!-- Default pull to refresh layer--> <div class = "pull-to-refresh-layer"> <div class = "preloader"></div> <div class = "pull-to-refresh-arrow"></div> </div> <!-- usual content below --> <div class = "list-block"> ... </div> </div>
以下类用于刷新 −
page-content − 它有一个额外的 pull-to-refresh-content 类,它是启用下拉刷新所必需的。
pull-to-refresh-layer − 它是一个隐藏层,用于下拉刷新视觉元素,它只是一个预加载器和一个箭头。
data-ptr-distance = "55" −这是附加属性,允许您设置自定义"下拉刷新"触发距离,其默认值为 44px。
下拉刷新事件
在"下拉刷新"中有一些 JavaScript 事件,下表给出了这些事件 −
S.No | 事件 &描述 | 目标 |
---|---|---|
1 | pullstart 每当您开始拉动以刷新内容时,它都会被触发。 |
拉动以刷新内容。 <div class = "pull-to-refresh-content"> |
2 | pullmove 当您拉动刷新内容时会触发该事件。 |
拉动刷新内容。 <div class="pull-to-refresh-content"> |
3 | pullend 每当您释放下拉刷新内容时,它都会被触发。 |
下拉刷新内容。 <div class="pull-to-refresh-content"> |
4 | refresh 下拉刷新进入"正在刷新"状态时,会触发该事件。 |
下拉刷新内容。 <div class="pull-to-refresh-content"> |
5 | refreshdone 刷新完成后,回到初始状态,会触发该事件。这将在调用 pullToRefreshDone 方法后完成。 |
下拉刷新内容。 <div class="pull-to-refresh-content"> |
有一些应用的方法可以与下拉刷新一起使用。
S.No | 应用的方法 &描述 |
---|---|
1 | myApp.pullToRefreshDone(ptrContent) 用于重置下拉刷新内容。 |
2 | myApp.pullToRefreshTrigger(ptrContent) 用于在指定的下拉刷新内容上触发刷新。 |
3 | myApp.destroyPullToRefresh(ptrContent) 用于在指定的上拉刷新时销毁/禁用下拉刷新下拉刷新内容。 |
4 | myApp.initPullToRefresh(ptrContent) 用于初始化/启用下拉刷新内容。 |
其中ptrContent用于HTMLElement或string来重置/触发或禁用/启用下拉刷新内容。
示例
以下示例演示了如何使用刷新组件来启动页面内容的刷新 −
<!DOCTYPE html> <html> <head> <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no, minimal-ui"> <meta name="apple-mobile-web-app-capable" content="yes"> <meta name="apple-mobile-web-app-status-bar-style" content="black"> <title>Pull To Refresh</title> <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/framework7/1.4.2/css/framework7.ios.min.css"> <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/framework7/1.4.2/css/framework7.ios.colors.min.css"> </head> <div class="views"> <div class="view view-main"> <div class="pages"> <div data-page="home" class="page navbar-fixed"> <div class="navbar"> <div class="navbar-inner"> <div class="left"> </div> <div class="center">Pull To Refresh</div> <div class="right"> </div> </div> </div> <div class="page-content pull-to-refresh-content"> <div class="pull-to-refresh-layer"> <div class="preloader"></div> <div class="pull-to-refresh-arrow"></div> </div> <div class="list-block media-list"> <ul> <li class="item-content"> <div class="item-media"><img src="/framework7/images/apple.png" width="44"></div> <div class="item-inner"> <div class="item-title-row"> <div class="item-title">apple</div> </div> </div> </li> <li class="item-content"> <div class="item-media"><img src="/framework7/images/froots_img.jpg" width="44"></div> <div class="item-inner"> <div class="item-title-row"> <div class="item-title">strawberry</div> </div> </div> </li> <li class="item-content"> <div class="item-media"><img src="/framework7/images/mango.jpg" width="44"></div> <div class="item-inner"> <div class="item-title-row"> <div class="item-title">Mango</div> </div> </div> </li> </ul> <div class="list-block-label"> <p>Just pull page down to let the magic happen.</p> </div> </div> </div> </div> </div> </div> </div> <script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/framework7/1.4.2/js/framework7.min.js"></script> <script> var myApp = new Framework7(); var $$ = Dom7; // Dummy Content var fruits = ['mango', 'orange', 'watermelon', 'banana']; // Pull to refresh content var ptrContent = $$('.pull-to-refresh-content'); // Add 'refresh' listener on it ptrContent.on('refresh', function (e) { // Emulate 2s loading setTimeout(function () { var picURL = 'images/Fruit.jpg' + Math.round(Math.random() * 100); var fruit = fruits[Math.floor(Math.random() * fruits.length)]; var itemHTML = '<li class="item-content">' + '<div class="item-media"><img src="/framework7/images/Fruit.jpg" width="44"/></div>' + '<div class="item-inner">' + '<div class="item-title-row">' + '<div class="item-title">' + fruit + '</div>' + '</div>' + '</div>' + '</li>'; // Prepend new list element ptrContent.find('ul').prepend(itemHTML); // When loading done, we need to reset it myApp.pullToRefreshDone(); }, 2000); }); </script> </html>
输出
让我们执行以下步骤来查看上述代码的工作原理 −
将上述 HTML 代码保存为服务器根文件夹中的 pull_to_refresh.html 文件。
以 http://localhost/pull_to_refresh.html 的形式打开此 HTML 文件,输出显示如下。
当用户下拉时,页面将刷新内容。