Orientação gerada a partir de informações públicas. Apenas para referência.
Um pacote Flutter totalmente personalizável e fácil de usar para implementar elementos de bloqueio de interface em aplicativos. Ele oferece uma maneira simples de sobrepor conteúdo com indicadores de carregamento, barras de progresso ou widgets personalizados, garantindo que os usuários sejam informados durante operações assíncronas. Ideal para impedir interações durante o carregamento ou processamento de dados, suporta todas as principais plataformas, incluindo Android, iOS, Web, macOS, Windows e Linux. O pacote é leve e projetado para integração perfeita em projetos Flutter existentes.
Casos de uso
Bloqueando a IU durante o carregamento de dados
Mostrando sobreposições de carregamento personalizadas
Evitando interação do usuário durante tarefas assíncronas
Melhorando a UX com feedback visual
Implementando indicadores de atualização
Criando telas de carregamento modais
Principais recursos
Aparência totalmente personalizável
API simples para integração rápida
Suporta todas as plataformas do Flutter
Extensível para sobrepõe personalizadas
Leve e performático
Indicadores de carregamento e progresso embutidos
Indicado para
Desenvolvedores em busca de soluções rápidas de bloqueio de UI
Aplicativos que exigem estados de carregamento consistentes
Equipes focadas em melhorias de UX
Projetos com necessidades de plataforma cruzada
Desenvolvedores front-end usando Flutter
Aplicações com operações assíncronas frequentes
Considerações
Pode exigir estilos adicionais para designs complexos
Sobreposições personalizadas precisam de implementação manual
Temas internos limitados
Não otimizado para atualizações de alta frequência
Depende da estrutura correta da árvore de widget
Melhor usado com gerenciamento de estado adequado
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
uiblock
Easiest and simplest method to block/unblock ui for your flutter apps.
One line of code to block/unblock ui and stop user from navigating during loading or processing in your flutter apps. You could use it as a widget or directly as a global service/util.
Fully customizable
Android and IOS
Easy and Simple
No other dependencies
Well documented
Production ready
Installation
With null-safety
dependencies:
uiblock: ^2.0.1
Without null-safety
dependencies:
uiblock: 1.2.0
Getting Started
Add the dependency to your project and start using uiblock everywhere:
Import the package.
import'package:uiblock/uiblock.dart';
To block ui
// defaultUIBlock.block(context);
//OR// if using globalKeyUIBlock.block(_scaffoldGlobalKey.currentContext);
To unblock ui
// call unblock after blockui to dissmissUIBlock.unblock(context);
//OR// if using globalKeyUIBlock.unblock(_scaffoldGlobalKey.currentContext);
// easily create custom block ui bodyUIBlock.block(
_scaffoldGlobalKey.currentContext,
backgroundColor: Colors.green.withOpacity(0.5),
imageFilter: ImageFilter.blur(sigmaX: 5.0, sigmaY: 5.0),
childBuilder: (BuildContext context) {
// return your widget here
},
);
// Don't forget to call unblock after block :)
Creating custom block modal transitions (only applicable on static UIBlock.block)
// NOTE : only for on UIBlock.block as this uses Modal Barrier// widget block is inline widget replacement with loader widgetUIBlock.block(
//...// more code
customBuildBlockModalTransitions:
(context, animation, secondaryAnimation, child) {
returnRotationTransition(
turns: animation,
child: child,
);
},
// ...
);
Using with data return
// NOTE : canDissmissOnBack is alaways truevar result = awaitUIBlock.blockWithData(
_scaffoldGlobalKey.currentContext,
loadingTextWidget: Padding(
padding: constEdgeInsets.all(8.0),
child: FlatButton(
onPressed: () {
// unblock and return dataUIBlock.unblockWithData(context, "hello world");
},
child: Text(
'Press here to dissmiss with data. Back for null',
textAlign: TextAlign.center,
style: TextStyle(
color: Colors.white,
fontSize: 18.0,
fontWeight: FontWeight.w600,
),
),
),
),
);
print(result);
For more details have a look at the other examples.
Properties
Property
Type
Default
Note
context (required)
BuildContext
-
childBuilder
Function
-
customLoaderChild
Widget
-
loadingTextWidget
Widget
-
imageFilter
ImageFilter
-
backgroundColor
Color
Transparent
canDissmissOnBack
bool
false
safeAreaLeft
bool
true
Set as 'false' to disable 'Left' Safe Area
safeAreaTop
bool
true
Set as 'false' to disable 'Top' (usually status bar) Safe Area
safeAreaRight
bool
true
Set as 'false' to disable 'Right' Safe Area
safeAreaBottom
bool
true
Set as 'false' to disable 'Bottom' Safe Area
safeAreaMinimumPadding
EdgeInsets
EdgeInsets.zero
safeAreaMaintainBottomViewPadding
bool
false
isSlideTransitionDefault
bool
true
Toggle between slide or fade transition
buildBlockModalTransitions
Function
-
Use this to create custom transition other than fade/slide
Widget Properties
Property
Type
Default
builder
Function
you implement it
loadingStateFromFuture
Future Function()
your future function (APIs,etc)
loaderBuilder
Function
-
customLoaderChild
Widget
-
loadingTextWidget
Widget
-
offset
offset
-
barrierOpacity
double
0.4
barrierColor
Color
black45
canDismiss
bool
false
hideBuilderOnNullData
bool
false
Improve
Help me by reporting bugs, submit new ideas for features or anything else that you want to share.