O padrão de interface do usuário de "deslizar para atualizar" é implementado totalmente no widget SwipeRefreshLayout
, que detecta o deslize vertical, exibe uma barra de progresso distinta e aciona métodos de retorno de chamada no app. Para ativar esse comportamento, adicione o widget ao arquivo de layout como pai de um ListView
ou GridView
e implemente o comportamento de atualização que é invocado quando o usuário desliza.
Esta lição mostra como adicionar o widget a um layout existente. Ela também mostra como adicionar uma ação de atualização à área flutuante da barra de ações, para que os usuários que não conseguem usar o gesto de deslizar possam acionar uma atualização manual com um dispositivo externo.
Adicionar o widget SwipeRefreshLayout
Para adicionar o widget de "deslizar para atualizar" a um app existente, adicione SwipeRefreshLayout
como pai de uma única ListView
ou GridView
. Lembre-se de que SwipeRefreshLayout
é compatível apenas com um único filho ListView
ou GridView
.
O exemplo a seguir demonstra como adicionar o widget SwipeRefreshLayout
a um arquivo de layout existente que contém um ListView
:
<android.support.v4.widget.SwipeRefreshLayout xmlns:android="http://schemas.android.com/apk/res/android" android:id="@+id/swiperefresh" android:layout_width="match_parent" android:layout_height="match_parent"> <ListView android:id="@android:id/list" android:layout_width="match_parent" android:layout_height="match_parent" /> </android.support.v4.widget.SwipeRefreshLayout>
Você também pode usar o widget SwipeRefreshLayout
com um ListFragment
. Se o layout contiver um ListView
com o código "@android:id/list"
, a funcionalidade de "deslizar para atualizar" será automaticamente compatível. No entanto, declarar explicitamente ListView
dessa maneira substitui a estrutura de visualização ListFragment
padrão. Se você quiser usar a estrutura de visualização padrão, será necessário modificar partes do comportamento SwipeRefreshLayout
e ListFragment
.
Adicionar uma ação de atualização à barra de ações
Adicione uma ação de atualização à barra de ações do app para garantir que os usuários que não conseguem usar o gesto de deslizar possam acionar uma atualização manual. Por exemplo, usuários com necessidades de acessibilidade podem acionar a barra de ações usando dispositivos externos, como teclados e botões direcionais.
Adicione a ação de atualização como um item de menu, e não como um botão, definindo o atributo android:showAsAction=never
. Se você exibir a ação como um botão, os usuários poderão presumir que a ação do botão de atualização é diferente da ação "deslizar para atualizar". Tornando a ação de atualização menos evidente na barra de ações, você pode incentivar os usuários a realizar atualizações manuais com o gesto de deslizar, ao mesmo tempo em que mantém a opção acessível em um local onde os usuários do botão direcional a procurariam.
O código a seguir mostra como adicionar a ação de "deslizar para atualizar" na área flutuante:
<menu xmlns:android="http://schemas.android.com/apk/res/android" > <item android:id="@+id/menu_refresh" android:showAsAction="never" android:title="@string/menu_refresh"/> </menu>