Orientação gerada a partir de informações públicas. Apenas para referência.
Liquid é uma ferramenta de interface do usuário de código aberto projetada para o Flutter que permite aos desenvolvedores criar aplicativos multiplataforma fluidos, dinâmicos e visualmente envolventes. Ele oferece uma coleção de widgets e componentes personalizáveis focados em animações suaves, layouts responsivos e padrões de design modernos. Construído com desempenho e experiência do desenvolvedor em mente, o Liquid aprimora o desenvolvimento de interfaces ao simplificar interações e transições complexas. A ferramenta é ideal para aplicativos que exigem interfaces expressivas e interativas com pouca quantidade de código boilerplate.
Casos de uso
Criando telas de inicialização animadas
Criando fluxos interativos de introdução
Designando painéis responsivos
Desenvolvendo interfaces baseadas em gestos
Implementando transições suaves entre estados
Principais recursos
Conjunto de widgets fluidos e adaptáveis
Ferramentas de animação embutidas
componentes de layout responsivo
Suporte a tema personalizável
Arquitetura leve e modular
Indicado para
Desenvolvedores Flutter em busca de padrões modernos de interface
Equipes construindo protótipos interativos
Aplicativos que exigem alto envolvimento visual
Projetos Flutter voltados para o frontend
Designers colaborando com desenvolvedores
Considerações
Pode exigir uma curva de aprendizado para novos usuários
Documentação limitada em comparação com pacotes maduros
Mais adequado para aplicativos que priorizam o acabamento visual em vez de layouts estáticos
Não recomendado para interfaces simples com apenas conteúdo
Depende da compatibilidade com versão estável do Flutter
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
Liquid
Build fast, responsive, cross platform apps with Liquid.
Liquid is an open source UI toolkit for developing cross platform apps in Flutter. Quickly create apps for Android, IOS, Web or Desktop with our powerful grid system, text processor, forms, extensive prebuilt components and dozens of utilities.
A builder that builds its childrens based on active breakpoints.
LResponsiveBuilder(
onXS: (context) => buildOnXS(context), // required
onSM: (context) => buildOnSM(context), // build only on SM breakpoint
onMD: (context) => buildOnMD(context), // build only on MD breakpoint
onLG: (context) => buildOnLG(context), // build only on LG breakpoint
onXL: (context) => buildOnXL(context), // build only on XL breakpoint
)
NOTE: LResponsiveBuilder will build onXS by default for other breakpoints if they are not defined.
NOTE: By default LResponsiveBuilder will use parents width to determine the active breakpoint.
To use screen width instead of parent width to determine breakpoint
LResponsiveBuilder(
... // builders
useMediaQuery: true, // this will make responsive builder to use screen width to build layout
)
Note: Responsive builder helps to build layout based on screen size but its too much work to build layout for 5 breakpoints. use Responisve Columns to build responsive layout in liquid.
Liquid comes with Rows (LRow) and Columns (LColumn) which helps to create a responsive grid thats layout their children according to active breakpoint.
Rows (LRow)
LRow is a responsive layout component in liquid that accepts a list of columns.
It can change its axis based on breakpoint by using axis property.
LRow(
columns: <LColumn>[
... //list of columns
]
)
LRow support maximum of 12 columns in fixedSize mode (default mode). i.e, if on a particular breakpoint the sum of all the column span is greater than 12 than mode will be changed to ratio.
LRow(
columns: <LColumn>[
LColumn( // first column
lg: 8, // span to 8 column space in lg
xl: 6, // span to 6 column space in xl
children: <Widget>[...]
),
LColumn( // second column
lg: 4, // span to 4 column space in lg
xl: 3, // span to 3 column space in xl
children: <Widget>[...]
),
]
)
LRow support 2 mode to render its columns.
fixedSize (columns will takes exact span space)
ratio (uses ratio/percentage to determine available space)
LRow(
mode: LGridMode.ratio
columns: <LColumn>[
LColumn( // first column
lg: 8, // takes ~53% space in lg
xl: 6, // takes ~50% space in xl
children: <Widget>[...]
),
LColumn( // second column
lg: 4, // takes ~26% space in lg
xl: 3, // takes ~25% space in xl
children: <Widget>[...]
),
LColumn( // third column
lg: 3, // takes ~26% space in lg
xl: 3, // takes ~25% space in xl
children: <Widget>[...]
),
]
)
Gutters
The space between columns is known as gutter
default: 5px
LRow(
gutter: 10.0, // add 10px space between columns
columns: <LColumn>[
... //list of columns
]
)
Margin
The space around the row
default: bottom margin equals togutter/2
NOTE: by default LRow is in horizontal axis except in xs breakpoint which is vertical. you can change this using axis property of LRow
Hiding a column on particular breakpoint
You can prevent a column from rendering on breakpoint by using visibility property of LColumn
LRow(
columns: <LColumn>[
LColumn( // first column
lg: 8, // span to 8 column space in lg
xl: 6, // span to 6 column space in xl
children: <Widget>[...]
),
LColumn( // second column
visibility: LBoxVisibility.belowXL(false),
xl: 3, // span to 6 column space in xl
children: <Widget>[...]
),
LColumn( // third column
lg: 4, // span to 4 column space in lg
xl: 3, // span to 3 column space in xl
children: <Widget>[...]
),
]
)
In above code, the second column will not render on XS, SM, MD and LG breakpoints.
Liquid comes with a container that can change its property based on breakpoint. properties like alignment, height, width, decoration, visibility, padding and margin.
Creates a widget that combines common painting, positioning, rendering and sizing widgets according to breakpoint.
LBox(
visibility: LBoxVisibility(
xs: false, // will not render child in XS breakpoint
sm: false, // will not render child in SM breakpoint
),
height: LBoxDimension( // height based on active breakpoint
xs: 250.0,
sm: 280.0,
md: 350.0,
lg: 450.0,
xl: 500.0,
),
padding: LBoxEdgeInsets( // padding based on active breakpoint
lg: EdgeInsets.all(10.0),
xl: EdgeInsets.all(20.0),
),
child: Image.network("https://source.unsplash.com/random/"), // child widget
)
To know the currently active breakpoint use MediaQuery
To know if a particular breakpoint is active use
MediaQuery.of(context).isXS // true if XS is activeMediaQuery.of(context).isSM // true if SM is activeMediaQuery.of(context).isMD // true if MD is activeMediaQuery.of(context).isLG // true if LG is activeMediaQuery.of(context).isXL // true if XL is active
To get active breakpoint use
MediaQuery.of(context).activeBreakpoint // active breakpoint