Trabalhando com indicadores de progresso do tvOS no Xamarin
Este artigo aborda o design e o trabalho com indicadores de progresso dentro de um aplicativo Xamarin.tvOS.
Pode haver momentos em que seu aplicativo Xamarin.tvOS precise carregar novo conteúdo ou executar uma longa operação de processamento. Durante esses períodos, você deve apresentar um indicador de atividade ou uma barra de progresso para informar ao usuário que o aplicativo ainda está em execução e dar-lhe alguma indicação sobre a duração da tarefa que está sendo executada.
Sobre indicadores de atividade
Um indicador de atividade se apresenta como uma engrenagem giratória e é usado para representar uma tarefa de comprimento indeterminado. O indicador é apresentado quando a tarefa é iniciada e desaparece quando a tarefa é concluída.
A Apple tem as seguintes sugestões para trabalhar com indicadores de atividade:
- Sempre que possível, use barras de progresso em vez disso - Como um indicador de atividade não fornece ao usuário comentários sobre quanto tempo o processo que está sendo executado levará, sempre use uma barra de progresso se o comprimento for conhecido (por exemplo, quantos bytes baixar em um arquivo).
- Mantenha o indicador animado - Os usuários relacionam um indicador de atividade estacionário a um aplicativo parado, portanto, você deve sempre animar o indicador enquanto ele está sendo exibido.
- Descreva a tarefa que está sendo processada - Apenas exibir o indicador de atividade por si só não é suficiente, o usuário precisa ser informado sobre o processo no qual está esperando. Inclua um rótulo significativo (geralmente uma única frase completa) que defina claramente a tarefa.
Sobre barras de progresso
Uma barra de progresso é apresentada como uma linha que é preenchida com cores para indicar o estado e a duração de uma tarefa demorada. As barras de progresso devem sempre ser usadas quando o comprimento das tarefas é conhecido ou pode ser calculado.
A Apple tem as seguintes sugestões para trabalhar com barras de progresso:
- Relatar com precisão o progresso - As barras de progresso devem sempre apresentar uma representação precisa do tempo necessário para concluir uma tarefa. Nunca deturpe o tempo para fazer o aplicativo parecer ocupado.
- Use para durações bem definidas - As barras de progresso não devem apenas mostrar que uma tarefa longa está ocorrendo, mas fornecer ao usuário uma indicação de quanto da tarefa foi concluída e uma estimativa do tempo restante.
Indicadores de progresso e storyboards
A maneira mais fácil de trabalhar com um indicador de progresso em um aplicativo Xamarin.tvOS é adicioná-lo à interface do usuário do aplicativo usando o iOS Designer.
No Solution Pad, clique duas vezes no arquivo Main.storyboard e abra-o para edição.
Arraste um indicador de atividade da caixa de ferramentas e solte-o na exibição:
Na guia Widget do Bloco de Propriedades, você pode ajustar várias propriedades do indicador de atividade, como Estilo, Comportamento e Nome:
O Name determina o nome da propriedade que representa o indicador de atividade no código C#.
Arraste uma Vista de Progresso da Caixa de Ferramentas e solte-a na vista:
Na guia Widget do Gerenciador de propriedades, você pode ajustar várias propriedades do modo de exibição de progresso, como Estilo, Progresso (porcentagem concluída) e Nome:
O Name determina o nome da propriedade que representa o modo de exibição de progresso no código C#.
Salve suas alterações.
Para obter mais informações sobre como trabalhar com storyboards, consulte nosso Guia de Início Rápido Olá, tvOS.
Trabalhando com indicadores de atividade
Como dito acima, os indicadores de atividade devem ser mostrados quando seu aplicativo estiver executando um longo processo de duração indeterminada.
A qualquer momento, você pode ver se um indicador de atividade está sendo animado verificando sua IsAnimating
propriedade. Se a HidesWhenStopped
propriedade for true
, o indicador de atividade ficará automaticamente oculto quando sua animação for interrompida.
Você pode usar o seguinte código para iniciar a animação:
ActivityIndicator.StartAnimating();
E o seguinte irá parar a animação:
ActivityIndicator.StopAnimating();
Observação
Esses trechos de código pressupõem que o Nome do indicador de atividade foi definido como ActivityIndicator na guia Widget do iOS Designer.
Trabalhando com barras de progresso
Novamente, uma barra de progresso deve ser usada sempre que seu aplicativo estiver executando uma tarefa de longa execução de uma duração conhecida.
A Progress
propriedade é usada para definir a quantidade da tarefa que foi concluída de 0% a 100% (0,0 a 1,0). Use a ProgressTintColor
propriedade para definir a cor da barra de valor concluído e a TrackTintColor
propriedade para definir a cor do plano de fundo (valor não concluído).
Resumo
Este artigo abordou o design e o trabalho com indicadores de progresso dentro de um aplicativo Xamarin.tvOS.