Framework7 - Aggiorna

Descrizione

È un componente speciale utilizzato per aggiornare (ricaricare) il contenuto della pagina tirandolo.

Il codice seguente mostra come aggiornare il contenuto della pagina:

<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>

Le seguenti classi vengono utilizzate nell'aggiornamento:

  • page-content- Ha una classe di contenuto pull-to-refresh aggiuntiva ed è necessario per abilitare il pull per l'aggiornamento.

  • pull-to-refresh-layer- È un livello nascosto, che viene utilizzato per aggiornare l'elemento visivo ed è solo un preloader e una freccia.

  • data-ptr-distance = "55" - Questo è un attributo aggiuntivo che ti consente di impostare la distanza di attivazione "pull to refresh" personalizzata e il suo valore predefinito è 44px.

Trascina per aggiornare gli eventi

In "Pull to Refresh" sono presenti alcuni eventi JavaScript, riportati nella tabella seguente:

S.No Descrizione dell'evento Bersaglio
1

pullstart

Verrà attivato ogni volta che inizi a tirare per aggiornare il contenuto.

Trascina per aggiornare il contenuto.

<div class = "pull-to-refresh-content">
2

pullmove

Viene attivato quando si esegue il pull per aggiornare il contenuto.

Trascina per aggiornare il contenuto.

<div class="pull-to-refresh-content">
3

pullend

Verrà attivato ogni volta che rilasci pull per aggiornare il contenuto.

Trascina per aggiornare il contenuto.

<div class="pull-to-refresh-content">
4

refresh

Questo evento verrà attivato quando il pull per l'aggiornamento entra nello stato "refreshing" .

Trascina per aggiornare il contenuto.

<div class="pull-to-refresh-content">
5

refreshdone

Verrà attivato dopo essere stato aggiornato e tornerà allo stato iniziale. Questo verrà fatto dopo aver chiamato il metodo pullToRefreshDone .

Trascina per aggiornare il contenuto.

<div class="pull-to-refresh-content">

Esistono metodi dell'app che possono essere utilizzati con Pull to Refresh.

S.No Metodi e descrizione dell'app
1

myApp.pullToRefreshDone(ptrContent)

Viene utilizzato per ripristinare il contenuto pull-to-refresh .
2

myApp.pullToRefreshTrigger(ptrContent)

Viene utilizzato per attivare l'aggiornamento al pull specificato per aggiornare il contenuto .
3

myApp.destroyPullToRefresh(ptrContent)

Viene utilizzato per distruggere / disabilitare il pull per aggiornare il pull specificato per aggiornare il contenuto .
4

myApp.initPullToRefresh(ptrContent)

Viene utilizzato per inizializzare / abilitare il pull per aggiornare il contenuto .

Dove ptrContent viene utilizzato per HTMLElement o stringa per eseguire il pull-to-refresh-content per reimpostare / attivare o disattivare / abilitare.

Esempio

L'esempio seguente mostra l'uso del componente di aggiornamento che avvia l'aggiornamento del contenuto di una pagina:

<!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>

Produzione

Eseguiamo i seguenti passaggi per vedere come funziona il codice sopra indicato:

  • Salva il codice HTML sopra indicato come pull_to_refresh.html file nella cartella principale del server.

  • Apri questo file HTML come http: //localhost/pull_to_refresh.html e l'output viene visualizzato come mostrato di seguito.

  • Quando l'utente tira giù, la pagina verrà aggiornata con i contenuti.