Framework7 - Atualizar
Descrição
É um componente especial usado para atualizar (recarregar) o conteúdo da página puxando-o.
O código a seguir mostra como atualizar o conteúdo da página -
<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>As seguintes classes são usadas na atualização -
page-content- Tem uma classe adicional de pull-to-refresh-content e é necessária para permitir pull para atualizar.
pull-to-refresh-layer- É uma camada oculta, que é usada para puxar para atualizar o elemento visual e é apenas um pré-carregador e uma seta.
data-ptr-distance = "55" - Este é um atributo adicional que permite definir a distância de acionamento "puxar para atualizar" personalizada e seu valor padrão é 44px.
Puxe para atualizar eventos
Em 'Pull to Refresh', há alguns eventos JavaScript, que são fornecidos na tabela a seguir -
| S.Não | Descrição do Evento | Alvo |
|---|---|---|
| 1 | pullstart Ele será acionado sempre que você começar a puxar para atualizar o conteúdo. |
Puxe para atualizar o conteúdo. |
| 2 | pullmove Ele é acionado quando você está puxando para atualizar o conteúdo. |
Puxe para atualizar o conteúdo. |
| 3 | pullend Ele será acionado sempre que você soltar o pull para atualizar o conteúdo. |
Puxe para atualizar o conteúdo. |
| 4 | refresh Este evento será acionado quando o pull para atualizar entrar no estado "atualizando" . |
Puxe para atualizar o conteúdo. |
| 5 | refreshdone Ele será acionado após ser atualizado e voltar ao estado inicial. Isso será feito após chamar o método pullToRefreshDone . |
Puxe para atualizar o conteúdo. |
Existem métodos de aplicativos que podem ser usados com Pull to Refresh.
| S.Não | Métodos e descrição do aplicativo |
|---|---|
| 1 | myApp.pullToRefreshDone(ptrContent) É usado para redefinir o conteúdo puxar para atualizar . |
| 2 | myApp.pullToRefreshTrigger(ptrContent) É usado para acionar a atualização no pull especificado para atualizar o conteúdo . |
| 3 | myApp.destroyPullToRefresh(ptrContent) É usado para destruir / desativar o pull para atualizar no pull especificado para atualizar o conteúdo . |
| 4 | myApp.initPullToRefresh(ptrContent) É usado para inicializar / habilitar pull para atualizar o conteúdo . |
Onde ptrContent é usado para HTMLElement ou string para puxar para atualizar o conteúdo para redefinir / disparar ou desabilitar / habilitar.
Exemplo
O exemplo a seguir demonstra o uso do componente de atualização que inicia a atualização do conteúdo de uma página -
<!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>Resultado
Vamos realizar as seguintes etapas para ver como funciona o código fornecido acima -
Salve o código HTML fornecido acima como pull_to_refresh.html arquivo na pasta raiz do servidor.
Abra este arquivo HTML como http: //localhost/pull_to_refresh.html e a saída é exibida conforme mostrado abaixo.
Quando o usuário puxar para baixo, a página será atualizada com o conteúdo.