Tela Biblioteca

Composição visual da tela de Biblioteca. Para o comportamento e os dados por trás dela, ver Biblioteca; este documento cobre como isso é apresentado na interface.

Cabeçalho

  • Título "INKSHELF" — clicável para voltar direto à raiz quando o usuário está navegando dentro de uma subpasta, funcionando como um atalho adicional às breadcrumbs.
  • Contagem de itens da pasta atual. Quando um filtro diferente de "Todos" está ativo, o texto muda de cor de destaque e passa a indicar também o nome do filtro aplicado (ex.: "12 itens - Não lidos"), para que fique visualmente óbvio que a lista não é o total da pasta.
  • Ícone de busca, que leva para Busca.
  • Ícone de ordenação, com um menu de opções; muda de cor de destaque sempre que um modo diferente do padrão (nome A–Z) está selecionado.
  • Menu de opções (três pontos), com a ação de atualizar a biblioteca e a seleção dos quatro filtros — a mesma cor de destaque marca visualmente qual filtro está ativo.

Logo abaixo do cabeçalho ficam as breadcrumbs de navegação.

Estados de carregamento

Três estados visuais distintos, dependendo do que está acontecendo:

  • Inicialização: um esqueleto de carregamento (placeholders no formato de grade) enquanto o estado inicial da tela ainda não chegou.
  • Varredura sem conteúdo ainda: um indicador central de progresso com texto informando que a biblioteca está sendo escaneada — acontece tipicamente na primeira varredura de uma pasta grande.
  • Atualização em segundo plano: quando já existem itens na tela e uma nova varredura roda (rescan manual, por exemplo), aparece apenas uma barra fina de progresso no topo, sem esconder o conteúdo já carregado.

Estados vazios

Dois estados vazios diferentes, com mensagens diferentes:

  • Nenhuma pasta raiz configurada: convida o usuário a adicionar uma fonte, com um botão que abre o diálogo unificado "Adicionar pasta" — pasta local, servidor Komga ou servidor Kavita (ver Fontes Remotas).
  • Pasta ou filtro sem resultados: se a pasta atual está genuinamente vazia, uma mensagem; se o filtro ativo é que não encontrou nada (mas a pasta tem conteúdo), a mensagem menciona o nome do filtro especificamente, deixando claro que o problema é o filtro, não a pasta.

Menu de contexto

As ações de toque longo (ver Biblioteca) são apresentadas como uma folha inferior (bottom sheet), não um menu suspenso ancorado no item tocado.