- Notifications
You must be signed in to change notification settings - Fork38
A super powerful Stack, build flexible layouts with constraints. Similar to ConstraintLayout for Android and AutoLayout for iOS. But the code implementation is much more efficient, it has O(n) layout time complexity and no linear equation solving is required.
License
hackware1993/Flutter_ConstraintLayout
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
I have developed the world's fastest general purpose sorting algorithm, which is on average 3times faster than Quicksort and up to 20 times faster,ChenSort
A super powerful Stack, build flexible layouts with constraints. Similar to ConstraintLayout forAndroid and AutoLayout for iOS. But the code implementation is much more efficient, it has O(n)layout time complexity and no linear equation solving is required.
It surpasses traditional nested writing in terms of performance, flexibility, development speed,and maintainability. It pretty much negates the O(2n) layout algorithm of Intrinsic Measurement.
It is a layout and a more modern general layout framework.
No matter how complex the layout is and how deep the constraints are, it has almost the sameperformance as a single Flex or Stack. When facing complex layouts, it provides better performance,flexibility, and a very flat code hierarchy than Flex and Stack. Say no to 'nested hell'.
In short, once you use it, you can't go back.
Improving "nested hell" is one of my original intentions for developing Flutter ConstraintLayout,but I don't advocate the ultimate pursuit of one level of nesting, which is unnecessary. So featureslike chains are already well supported by Flex itself, so ConstraintLayout will not actively supportit.
ViewFlutter Web Online Example
Flutter ConstraintLayout has extremely high layout performance. It does not require linearequations to solve. At any time, each child element will only be laid out once. When its own widthor height is set to wrapContent, some child elements may calculate the offset twice. The layoutprocess of ConstraintLayout consists of the following three steps:
- Constraint calculation
- Layout
- Draw
The performance of layout and drawing is almost equivalent to a single Flex or Stack, and theperformance of constraint calculation is roughly 0.01 milliseconds (layout of general complexity, 20child elements). Constraints are only recalculated after they have changed.
ConstraintLayout itself can be arbitrarily nested without performance issues, each child element inthe render tree is only laid out once, and the time complexity is O(n) instead of O(2n) or worse.
A smaller Widget tree leads to less build time and a smaller Element tree. A very flat layoutstructure results in a smaller RenderObject tree and less rendering time. One thing most people tendto overlook is that complex nesting can cause build times to sometimes exceed render times.
It is recommended to use ConstraintLayout at the top level. For extremely complex layout(onethousand child elements, two thousand constraints), layout and drawing total time within 5milliseconds(debug mode on Windows 10,release mode take less time), the frame rate can be easilyreached 200 fps.
If not necessary, try to be relative to the parent layout, so that you can define less id. Or userelative id.
Warning:For layout performance considerations, constraints are always one-way, and there should be no twochild elements directly or indirectly restrain each other(for example, the right side of A isconstrained to the left side of B, and the left side of B is in turn constrained to A right). Eachconstraint should describe exactly where the child elements are located. Although constraints canonly be one-way, you can still better handle things that were previously (Android ConstraintLayout)two-way constraints, such as chains(not yet supported, please use with Flex).
- build flexible layouts with constraints
- left
- toLeft
- toCenter(with bias, the default value is 0.5)
- toRight
- right
- toLeft
- toCenter(with bias, the default value is 0.5)
- toRight
- top
- toTop
- toCenter(with bias, the default value is 0.5)
- toBottom
- bottom
- toTop
- toCenter(with bias, the default value is 0.5)
- toBottom
- baseline
- toTop
- toCenter(with bias, the default value is 0.5)
- toBaseline
- toBottom
- left
- margin and goneMargin(when the visibility of the dependent element is gone or the actual size ofone side is 0, the goneMargin will take effect, otherwise the margin will take effect, even ifits own visibility is gone)
- clickPadding(quickly expand the click area of child elements without changing their actual size.This means that you can completely follow the layout of the UI prototype without having to thinkabout the click area of the element. This also means that the click area can be shared betweenchild elements without increasing nesting. Sometimes it may be necessary to combine with e-index)
- visibility control
- visible
- invisible
- gone(sometimes it may be better to use a conditional expression to keep the element frombeing created)
- constraint integrity hint
- bias(when there are constraints left and right or top and bottom, horizontalBias and verticalBiascan be used to adjust the offset. The default value is 0.5, which means centering)
- z-index(drawing order, default is child index)
- translate、rotate
- percentage layout(when size is set to matchConstraint, the percentage layout will take effect,the default percentage is 1 (100%). The relevant properties are widthPercent, heightPercent,widthPercentageAnchor, heightPercentageAnchor)
- guideline
- constraints and widgets separation
- barrier
- dimension ratio
- widthHeightRatio: 1 / 3,
- ratioBaseOnWidth: true, (the default value is null, which means automatic inference. The sizeof the undetermined side will be calculated using the determined side based on the aspectratio. The undetermined side must be matchConstraint, and the determined side can bematchParent, fixed size(>=0), matchConstraint)
- relative id(if an id is defined for a child element, it cannot be referenced using a relativeid)
- rId(3) represents the 3th child element, and so on
- rId(-1) represents the last child element
- rId(-2) represents the penultimate child element, and so on
- sId(-1) represents the previous sibling element, and so on
- sId(1) represents the next sibling element, and so on
- wrapper constraints
- topLeftTo
- topCenterTo
- topRightTo
- centerLeftTo
- centerTo
- centerRightTo
- bottomLeftTo
- bottomCenterTo
- bottomRightTo
- centerHorizontalTo
- centerVerticalTo
- outTopLeftTo
- outTopCenterTo
- outTopRightTo
- outCenterLeftTo
- outCenterRightTo
- outBottomLeftTo
- outBottomCenterTo
- outBottomRightTo
- centerTopLeftTo
- centerTopCenterTo
- centerTopRightTo
- centerCenterLeftTo
- centerCenterRightTo
- centerBottomLeftTo
- centerBottomCenterTo
- centerBottomRightTo
- staggered grid、grid、list(list is a special staggered grid, grid is also a special staggeredgrid)
- circle position
- pinned position
- arbitrary position
- e-index(event dispatch order, default is z-index)
- the size of child widgets can be set to:
- fixed size(>=0)
- matchParent
- wrapContent(default, minimum and maximum supported)
- matchConstraint
- the size of itself can be set to:
- fixed size(>=0)
- matchParent(default)
- wrapContent(minimum and maximum are temporarily not supported)
- layout debugging
- showHelperWidgets
- showClickArea
- showZIndex
- showChildDepth
- debugPrintConstraints
- showLayoutPerformanceOverlay
- open grammar gives you more flexibility to organize child elements, solving the problem of usingonly limited expressions in the children list
classOpenGrammarExampleextendsStatelessWidget {constOpenGrammarExample({Key? key}):super(key: key);@overrideWidgetbuild(BuildContext context) {returnScaffold( body:ConstraintLayout().open(() {if (DateTime .now() .millisecond%2==0) {Container( color:Colors.red, ).applyConstraint( size:200, centerTo: parent, ); }else {Container( color:Colors.yellow, ).applyConstraint( size:200, centerTo: parent, ); }for (int i=0; i<5; i++) {Row().open(() {for (int j=0; j<10; j++) {Text("$i x $j").enter();constSizedBox( width:20, ).enter(); } }).applyConstraint( height:100, left: parent.left.margin(100), top: i==0? parent.top:sId(-1).bottom, ); }int i=0;while (i<100) {Text("$i").applyConstraint( left: parent.left, top: i==0? parent.top:sId(-1).bottom, ); i++; } }), ); }}
Follow-up development plan:
- chain
- constraints visualization
- provides a visual editor to create layouts by dragging and dropping
- automatically convert design drafts into code
- more…
Subscribe to my WeChat official account to get the latest news of ConstraintLayout(Full Guide, BestPractices, Principle Analysis). Follow-up will also share some high-quality, unique, and thoughtfulFlutter technical articles.
Currently, I am developing a new declarative UI framework weiV(pronounced the same as wave) forAndroid based on the View system. It has the following advantages:
- Declarative UI writing doubles the efficiency of native development
- Meets or exceeds the performance of the View system
- I ported my Flutter ConstraintLayout to Android, relying on its advanced layout algorithm,without introducing Intrinsic Measurement, so that the child elements in the View tree willonly be laid out once in any case, making arbitrary nesting does not cause performanceissues. Even if each level in the View tree is a mix of wrap_content and match_parent
- xml will be discarded
- All your existing View system experience will be retained
- All existing UI components will be reused
- It is written in Kotlin but supports Java friendly
- At present, the initial support for real-time effective dynamization has begun. You can issue JS,use JS to write page logic, and generate JSON describing the Widget tree and pass it to thenative, and the native uses a non-reflection method to convert it into a real Widget tree andrender. I might consider implementing a declarative API in JS later
- In the future, the same stateful hot reload as Flutter will be implemented
The sample code is as follows:
classWeiVCounterKotlinActivity :WeiVActivity() {privatevar count=0privateval maxCount=10privateval minCount=0overridefunbuild()=WeiV {Flex { it.orientation=FlexDirection.VERTICALButton(text="Add count", enable= count< maxCount, onClick= { setState { count++ } })Button(text="Sub count", enable= count> minCount, onClick= { setState { count-- } })Text(text="count =$count") } }}
No one wants to overturn their past experience with the View system, Compose's design is toobad.
Subscribe to my WeChat official account to get the latest news of weiV.
Support platform:
- Android
- iOS
- Mac
- Windows
- Linux
- Web
Null-safety
dependencies:flutter_constraintlayout:git:url:'https://github.com/hackware1993/Flutter-ConstraintLayout.git'ref:'v1.7.0-stable'
dependencies:flutter_constraintlayout:^1.7.0-stable
import'package:flutter_constraintlayout/flutter_constraintlayout.dart';
ExampleFlutter Web Online Example
classSummaryExampleStateextendsState<SummaryExample> {double x=0;double y=0;ConstraintId box0=ConstraintId('box0');ConstraintId box1=ConstraintId('box1');ConstraintId box2=ConstraintId('box2');ConstraintId box3=ConstraintId('box3');ConstraintId box4=ConstraintId('box4');ConstraintId box5=ConstraintId('box5');ConstraintId box6=ConstraintId('box6');ConstraintId box7=ConstraintId('box7');ConstraintId box8=ConstraintId('box8');ConstraintId box9=ConstraintId('box9');ConstraintId box10=ConstraintId('box10');ConstraintId box11=ConstraintId('box11');ConstraintId barrier=ConstraintId('barrier');@overrideWidgetbuild(BuildContext context) {returnScaffold( appBar:constCustomAppBar( title:'Summary', codePath:'example/summary.dart', ), backgroundColor:Colors.black, body:ConstraintLayout(// Constraints can be separated from widgets childConstraints: [Constraint( id: box0, size:200, bottomLeftTo: parent, zIndex:20, ) ], children: [Container( color:Colors.redAccent, alignment:Alignment.center, child:constText('box0'), ).applyConstraintId( id: box0,// Constraints can be separated from widgets ),Container( color:Colors.redAccent, alignment:Alignment.center, child:constText('box1'), ).apply( constraint:Constraint(// Constraints set with widgets id: box1, width:200, height:100, topRightTo: parent, ), ),Container( color:Colors.blue, alignment:Alignment.center, child:constText('box2'), ).applyConstraint(// Constraints set with widgets easy way id: box2, size: matchConstraint, centerHorizontalTo: box3, top: box3.bottom, bottom: parent.bottom, ),Container( color:Colors.orange, width:200, height:150, alignment:Alignment.center, child:constText('box3'), ).applyConstraint( id: box3, right: box1.left, top: box1.bottom, ),Container( color:Colors.redAccent, alignment:Alignment.center, child:constText('box4'), ).applyConstraint( id: box4, size:50, bottomRightTo: parent, ),GestureDetector( child:Container( color:Colors.pink, alignment:Alignment.center, child:constText('box5 draggable'), ), onPanUpdate: (details) {setState(() { x+= details.delta.dx; y+= details.delta.dy; }); }, ).applyConstraint( id: box5, width:120, height:100, centerTo: parent, zIndex:100, translate:Offset(x, y), translateConstraint:true, ),Container( color:Colors.lightGreen, alignment:Alignment.center, child:constText('box6'), ).applyConstraint( id: box6, size:120, centerVerticalTo: box2, verticalBias:0.8, left: box3.right, right: parent.right, ),Container( color:Colors.lightGreen, alignment:Alignment.center, child:constText('box7'), ).applyConstraint( id: box7, size: matchConstraint, left: parent.left, right: box3.left, centerVerticalTo: parent, margin:constEdgeInsets.all(50), ),Container( color:Colors.cyan, alignment:Alignment.center, child:constText('child[7] pinned to the top right'), ).applyConstraint( width:200, height:100, left: box5.right, bottom: box5.top, ),constText('box9 baseline to box7', style:TextStyle( color:Colors.white, ), ).applyConstraint( id: box9, baseline: box7.baseline, left: box7.left, ),Container( color:Colors.yellow, alignment:Alignment.bottomCenter, child:constText('percentage layout\nwidth: 50% of parent\nheight: 30% of parent'), ).applyConstraint( size: matchConstraint, widthPercent:0.5, heightPercent:0.3, horizontalBias:0, verticalBias:0, centerTo: parent, ),Barrier( id: barrier, direction:BarrierDirection.left, referencedIds: [box6, box5], ),Container( color:constColor(0xFFFFD500), alignment:Alignment.center, child:constText('align to barrier'), ).applyConstraint( width:100, height:200, top: box5.top, right: barrier.left, ) ], ), ); }}
- guidelineFlutter Web Online Example
classGuidelineExampleextendsStatelessWidget {constGuidelineExample({Key? key}):super(key: key);@overrideWidgetbuild(BuildContext context) {ConstraintId guideline=ConstraintId('guideline');returnMaterialApp( home:Scaffold( body:ConstraintLayout( children: [Container( color:constColor(0xFF005BBB), ).applyConstraint( width: matchParent, height: matchConstraint, top: parent.top, bottom: guideline.top, ),Guideline( id: guideline, horizontal:true, guidelinePercent:0.5, ),Container( color:constColor(0xFFFFD500), ).applyConstraint( width: matchParent, height: matchConstraint, top: guideline.bottom, bottom: parent.bottom, ),constText('Stand with the people of Ukraine', style:TextStyle( fontSize:40, color:Colors.white, ), ).applyConstraint( width: wrapContent, height: wrapContent, centerHorizontalTo: parent, bottom: guideline.bottom, ) ], ), ), ); }}
- barrierFlutter Web Online Example
classBarrierExampleextendsStatelessWidget {constBarrierExample({Key? key}):super(key: key);@overrideWidgetbuild(BuildContext context) {ConstraintId leftChild=ConstraintId('leftChild');ConstraintId rightChild=ConstraintId('rightChild');ConstraintId barrier=ConstraintId('barrier');returnMaterialApp( home:Scaffold( body:ConstraintLayout( debugShowGuideline:true, children: [Container( color:constColor(0xFF005BBB), ).applyConstraint( id: leftChild, width:200, height:200, top: parent.top, left: parent.left, ),Container( color:constColor(0xFFFFD500), ).applyConstraint( id: rightChild, width:200, height: matchConstraint, right: parent.right, top: parent.top, bottom: parent.bottom, heightPercent:0.5, verticalBias:0, ),Barrier( id: barrier, direction:BarrierDirection.bottom, referencedIds: [leftChild, rightChild], ),constText('Align to barrier', style:TextStyle( fontSize:40, color:Colors.blue, ), ).applyConstraint( width: wrapContent, height: wrapContent, centerHorizontalTo: parent, top: barrier.bottom, goneMargin:constEdgeInsets.only(top:20), ) ], ), ), ); }}
classBadgeExampleextendsStatelessWidget {constBadgeExample({Key? key}):super(key: key);@overrideWidgetbuild(BuildContext context) {ConstraintId anchor=ConstraintId('anchor');returnScaffold( body:ConstraintLayout( children: [Container( color:Colors.yellow, ).applyConstraint( width:200, height:200, centerTo: parent, id: anchor, ),Container( color:Colors.green, child:constText('Indeterminate badge size', style:TextStyle( color:Colors.black, fontSize:20, ), ), ).applyConstraint( left: anchor.right, bottom: anchor.top, translate:constOffset(-0.5,0.5), percentageTranslate:true, ),Container( color:Colors.green, ).applyConstraint( width:100, height:100, left: anchor.right, right: anchor.right, top: anchor.bottom, bottom: anchor.bottom, ) ], ), ); }}
classGridExampleextendsStatelessWidget {constGridExample({Key? key}):super(key: key);@overrideWidgetbuild(BuildContext context) {List<Color> colors= [Colors.redAccent,Colors.greenAccent,Colors.blueAccent,Colors.orangeAccent,Colors.yellow,Colors.pink,Colors.lightBlueAccent ];returnScaffold( body:ConstraintLayout( children: [ ...constraintGrid( id:ConstraintId('grid'), left: parent.left, top: parent.top, itemCount:50, columnCount:8, itemWidth:50, itemHeight:50, itemBuilder: (index) {returnContainer( color: colors[index% colors.length], ); }, itemMarginBuilder: (index) {returnconstEdgeInsets.only( left:10, top:10, ); }) ], ), ); }}
- staggered gridFlutter Web Online Example
classStaggeredGridExampleextendsStatelessWidget {constStaggeredGridExample({Key? key}):super(key: key);@overrideWidgetbuild(BuildContext context) {List<Color> colors= [Colors.redAccent,Colors.greenAccent,Colors.blueAccent,Colors.orangeAccent,Colors.yellow,Colors.pink,Colors.lightBlueAccent ];constdouble smallestSize=40;constint columnCount=8;Random random=Random();returnScaffold( body:ConstraintLayout( children: [TextButton( onPressed: () { (contextasElement).markNeedsBuild(); }, child:constText('Upset', style:TextStyle( fontSize:32, height:1.5, ), ), ).applyConstraint( left:ConstraintId('horizontalList').right, top:ConstraintId('horizontalList').top, ), ...constraintGrid( id:ConstraintId('horizontalList'), left: parent.left, top: parent.top, margin:constEdgeInsets.only( left:100, ), itemCount:50, columnCount: columnCount, itemBuilder: (index) {returnContainer( color: colors[index% colors.length], alignment:Alignment.center, child:Text('$index'), ); }, itemSizeBuilder: (index) {if (index==0) {returnconstSize( smallestSize* columnCount+35, smallestSize); }if (index==6) {returnconstSize(smallestSize*2+5, smallestSize); }if (index==7) {returnconstSize(smallestSize*6+25, smallestSize); }if (index==19) {returnconstSize(smallestSize*2+5, smallestSize); }if (index==29) {returnconstSize(smallestSize*3+10, smallestSize); }returnSize( smallestSize, (2+ random.nextInt(4))* smallestSize); }, itemSpanBuilder: (index) {if (index==0) {return columnCount; }if (index==6) {return2; }if (index==7) {return6; }if (index==19) {return2; }if (index==29) {return3; }return1; }, itemMarginBuilder: (index) {returnconstEdgeInsets.only( left:5, top:5, ); }) ], ), ); }}
- circle positionFlutter Web Online Example
classCirclePositionExampleStateextendsState<CirclePositionExample> {lateTimer timer;lateint hour;lateint minute;lateint second;double centerTranslateX=0;double centerTranslateY=0;@overridevoidinitState() {super.initState();calculateClockAngle(); timer=Timer.periodic(constDuration(seconds:1), (_) {calculateClockAngle(); }); }voidcalculateClockAngle() {setState(() {DateTime now=DateTime.now(); hour= now.hour; minute= now.minute; second= now.second; }); }@overridevoiddispose() {super.dispose(); timer.cancel(); }@overrideWidgetbuild(BuildContext context) {returnScaffold( body:ConstraintLayout( children: [GestureDetector( child:Container( decoration:constBoxDecoration( color:Colors.red, borderRadius:BorderRadius.all(Radius.circular(1000), ), ), ), onPanUpdate: (details) {setState(() { centerTranslateX+= details.delta.dx; centerTranslateY+= details.delta.dy; }); }, ).applyConstraint( width:20, height:20, centerTo: parent, zIndex:100, translate:Offset(centerTranslateX, centerTranslateY), translateConstraint:true, ),for (int i=0; i<12; i++)Text('${i +1}', style:constTextStyle( fontWeight:FontWeight.bold, fontSize:25, ), ).applyConstraint( centerTo:rId(0), translate:circleTranslate( radius:205, angle: (i+1)*30, ), ),for (int i=0; i<60; i++)if (i%5!=0)Transform.rotate( angle: pi+ pi* (i*6/180), child:Container( color:Colors.grey, margin:constEdgeInsets.only( top:405, ), ), ).applyConstraint( width:1, height:415, centerTo:rId(0), ),Transform.rotate( angle: pi+ pi* (hour*30/180), alignment:Alignment.topCenter, child:Container( color:Colors.green, ), ).applyConstraint( width:5, height:80, centerTo:rId(0), translate:constOffset(0,0.5), percentageTranslate:true, ),Transform.rotate( angle: pi+ pi* (minute*6/180), alignment:Alignment.topCenter, child:Container( color:Colors.pink, ), ).applyConstraint( width:5, height:120, centerTo:rId(0), translate:constOffset(0,0.5), percentageTranslate:true, ),Transform.rotate( angle: pi+ pi* (second*6/180), alignment:Alignment.topCenter, child:Container( color:Colors.blue, ), ).applyConstraint( width:5, height:180, centerTo:rId(0), translate:constOffset(0,0.5), percentageTranslate:true, ),Text('$hour:$minute:$second', style:constTextStyle( fontSize:40, ), ).applyConstraint( outTopCenterTo:rId(0), margin:constEdgeInsets.only( bottom:250, ), ) ], ), ); }}
classMarginExampleextendsStatelessWidget {constMarginExample({Key? key}):super(key: key);@overrideWidgetbuild(BuildContext context) {returnScaffold( body:ConstraintLayout( children: [Container( color:constColor(0xFF005BBB), ).applyConstraint( size:50, topLeftTo: parent, margin:constEdgeInsets.only( left:20, top:100, ), ),Container( color:constColor(0xFFFFD500), ).applyConstraint( size:100, top:sId(-1).bottom, right: parent.right.margin(100), ),Container( color:Colors.pink, ).applyConstraint( size:50, topRightTo: parent.rightMargin(20).topMargin(50), ), ], ), ); }}
- pinned positionFlutter Web Online Example
classPinnedPositionExampleStateextendsState<PinnedPositionExample> {lateTimer timer;double angle=0;@overridevoidinitState() {super.initState(); timer=Timer.periodic(constDuration(milliseconds:16), (_) {setState(() { angle++; }); }); }@overridevoiddispose() {super.dispose(); timer.cancel(); }@overrideWidgetbuild(BuildContext context) {ConstraintId anchor=ConstraintId('anchor');returnScaffold( appBar:constCustomAppBar( title:'Pinned Position', codePath:'example/pinned_position.dart', ), body:ConstraintLayout( children: [Container( color:Colors.yellow, ).applyConstraint( id: anchor, size:200, centerTo: parent, ),Container( color:Colors.cyan, ).applyConstraint( size:100, pinnedInfo:PinnedInfo( anchor,Anchor(0.2,AnchorType.percent,0.2,AnchorType.percent),Anchor(1,AnchorType.percent,1,AnchorType.percent), angle: angle, ), ),Container( color:Colors.orange, ).applyConstraint( size:60, pinnedInfo:PinnedInfo( anchor,Anchor(1,AnchorType.percent,1,AnchorType.percent),Anchor(0,AnchorType.percent,0,AnchorType.percent), angle:360- angle, ), ),Container( color:Colors.black, ).applyConstraint( size:60, pinnedInfo:PinnedInfo( anchor,Anchor(0.5,AnchorType.percent,0.5,AnchorType.percent),Anchor(0.5,AnchorType.percent,0.5,AnchorType.percent), angle: angle, ), ),Container( decoration:constBoxDecoration( color:Colors.red, borderRadius:BorderRadius.all(Radius.circular(10)), ), ).applyConstraint( size:10, centerBottomRightTo: anchor, ),Container( decoration:constBoxDecoration( color:Colors.red, borderRadius:BorderRadius.all(Radius.circular(10)), ), ).applyConstraint( size:10, centerTopLeftTo: anchor, ),Container( decoration:constBoxDecoration( color:Colors.red, borderRadius:BorderRadius.all(Radius.circular(10)), ), ).applyConstraint( size:10, centerTo: anchor, ) ], ), ); }}
- translateFlutter Web Online Example
classTrackPainterextendsCustomPainter {Queue<Offset> points=Queue();Paint painter=Paint();TrackPainter(this.points);@overridevoidpaint(Canvas canvas,Size size) { canvas.drawPoints(PointMode.polygon, points.toList(), painter); }@overrideboolshouldRepaint(CustomPainter oldDelegate)=>true;}classTranslateExampleStateextendsState<TranslateExample> {lateTimer timer;double angle=0;double earthRevolutionAngle=0;Queue<Offset> points=Queue();@overridevoidinitState() {super.initState(); timer=Timer.periodic(constDuration(milliseconds:16), (_) {setState(() { angle+=1; earthRevolutionAngle+=0.1; }); }); }@overridevoiddispose() {super.dispose(); timer.cancel(); }@overrideWidgetbuild(BuildContext context) {ConstraintId anchor=ConstraintId('anchor');returnScaffold( appBar:constCustomAppBar( title:'Translate', codePath:'example/translate.dart', ), body:ConstraintLayout( children: [CustomPaint( painter:TrackPainter(points), ).applyConstraint( width: matchParent, height: matchParent, ),Container( decoration:constBoxDecoration( color:Colors.redAccent, borderRadius:BorderRadius.all(Radius.circular(1000)), ), child:constText('----'), alignment:Alignment.center, ).applyConstraint( id:cId('sun'), size:200, pinnedInfo:PinnedInfo( parent,Anchor(0.5,AnchorType.percent,0.5,AnchorType.percent),Anchor(0.3,AnchorType.percent,0.5,AnchorType.percent), angle: earthRevolutionAngle*365/25.4, ), ),Container( decoration:constBoxDecoration( color:Colors.blue, borderRadius:BorderRadius.all(Radius.circular(1000)), ), child:constText('----'), alignment:Alignment.center, ).applyConstraint( id:cId('earth'), size:100, pinnedInfo:PinnedInfo(cId('sun'),Anchor(0.5,AnchorType.percent,0.5,AnchorType.percent),Anchor(0.5,AnchorType.percent,0.5,AnchorType.percent), angle: earthRevolutionAngle*365, ), translate:circleTranslate( radius:250, angle: earthRevolutionAngle, ), translateConstraint:true, ),Container( decoration:constBoxDecoration( color:Colors.grey, borderRadius:BorderRadius.all(Radius.circular(1000)), ), child:constText('----'), alignment:Alignment.center, ).applyConstraint( id:cId('moon'), size:50, pinnedInfo:PinnedInfo(cId('earth'),Anchor(0.5,AnchorType.percent,0.5,AnchorType.percent),Anchor(0.5,AnchorType.percent,0.5,AnchorType.percent), angle: earthRevolutionAngle*365/27.32, ), translate:circleTranslate( radius:100, angle: earthRevolutionAngle*365/27.32, ), translateConstraint:true, paintCallback: (_, __, ____, offset, ______) { points.add(offset!);if (points.length>2000) { points.removeFirst(); } }, ),Text('Sun rotates ${(earthRevolutionAngle *365 /25.4) ~/360} times') .applyConstraint( outTopCenterTo:cId('sun'), ),Text('Earth rotates ${earthRevolutionAngle *365 ~/360} times') .applyConstraint( outTopCenterTo:cId('earth'), ),Text('Moon rotates ${(earthRevolutionAngle *365 /27.32) ~/360} times') .applyConstraint( outTopCenterTo:cId('moon'), ),Container( color:Colors.yellow, ).applyConstraint( id: anchor, size:250, centerRightTo: parent.rightMargin(300), ),Container( color:Colors.red, child:constText('pinned translate'), ).applyConstraint( centerTo: anchor, translate:PinnedTranslate(PinnedInfo(null,Anchor(0.5,AnchorType.percent,0.5,AnchorType.percent),null, angle: angle, ), ), ),Container( color:Colors.blue, child:constText('circle translate'), ).applyConstraint( size: wrapContent, centerTo: anchor, translate:circleTranslate( radius:100, angle: angle, ), ),Container( color:Colors.cyan, child:constText('pinned & circle translate'), ).applyConstraint( centerTo: anchor, translate:PinnedTranslate(PinnedInfo(null,Anchor(0.5,AnchorType.percent,0.5,AnchorType.percent),null, angle: angle, ), )+circleTranslate( radius:150, angle: angle, ), ),Container( color:Colors.orange, child:constText('normal translate'), ).applyConstraint( size: wrapContent, outBottomCenterTo: anchor, translate:Offset(0, angle/5), ) ], ), ); }}
- When the layout is complex, if the child elements need to be repainted frequently, it isrecommended to use RepaintBoundary to improve performance.
classOffPaintExampleextendsStatelessWidget {constOffPaintExample({Key? key}):super(key: key);@overrideWidgetbuild(BuildContext context) {returnMaterialApp( home:Scaffold( body:ConstraintLayout( children: [Container( color:Colors.orangeAccent, ).offPaint().applyConstraint( width:200, height:200, topRightTo: parent, ) ], ), ), ); }}
- Try to use const Widget. If you can't declare a child element as const and it won't change, youcan use OffBuildWidget to avoid the rebuilding of the child element.
classOffBuildExampleextendsStatelessWidget {constOffBuildExample({Key? key}):super(key: key);@overrideWidgetbuild(BuildContext context) {returnMaterialApp( home:Scaffold( body:ConstraintLayout( children: [/// subtrees that do not changeContainer( color:Colors.orangeAccent, ).offBuild(id:'id').applyConstraint( width:200, height:200, topRightTo: parent, ) ], ), ), ); }}
Child elements will automatically become RelayoutBoundary unless width or height is wrapContent.The use of wrapContent can be reasonably reduced, because after the size of ConstraintLayoutchanges (usually the size of the window changes), all child elements whose width or height iswrapContent will be re-layout. And since the constraints passed to other child elements won'tchange, no real re-layout will be triggered.
If you use Guideline or Barrier in the children list, Element and RenderObject will inevitably begenerated for them, which will be laid out but not drawn. At this point you can useGuidelineDefine or BarrierDefine to optimize it, no Element and RenderObject will be generatedanymore:
classBarrierExampleextendsStatelessWidget {constBarrierExample({Key? key}):super(key: key);@overrideWidgetbuild(BuildContext context) {ConstraintId leftChild=ConstraintId('leftChild');ConstraintId rightChild=ConstraintId('rightChild');ConstraintId barrier=ConstraintId('barrier');returnScaffold( body:ConstraintLayout( childConstraints: [BarrierDefine( id: barrier, direction:BarrierDirection.bottom, referencedIds: [leftChild, rightChild], ), ], children: [Container( color:constColor(0xFF005BBB), ).applyConstraint( id: leftChild, width:200, height:200, topLeftTo: parent, ),Container( color:constColor(0xFFFFD500), ).applyConstraint( id: rightChild, width:200, height: matchConstraint, centerRightTo: parent, heightPercent:0.5, verticalBias:0, ),constText('Align to barrier', style:TextStyle( fontSize:40, color:Colors.blue, ), ).applyConstraint( centerHorizontalTo: parent, top: barrier.bottom, ) ], ), ); }}
- Every frame, ConstraintLayout compares the parameters and decides the following things:
- Does the constraint need to be recalculated?
- Does it need to be relayout?
- Does it need to be redrawn?
- Do you need to rearrange the drawing order?
- Do you need to rearrange the order of event distribution?
These comparisons will not be a performance bottleneck, but will increase CPU usage. If you knowenough about the internals of ConstraintLayout, you can use ConstraintLayoutController to manuallytrigger these operations to stop parameter comparison.
classConstraintControllerExampleStateextendsState<ConstraintControllerExample> {double x=0;double y=0;ConstraintLayoutController controller=ConstraintLayoutController();@overrideWidgetbuild(BuildContext context) {returnScaffold( appBar:constCustomAppBar( title:'Constraint Controller', codePath:'example/constraint_controller.dart', ), body:ConstraintLayout( controller: controller, children: [GestureDetector( child:Container( color:Colors.pink, alignment:Alignment.center, child:constText('box draggable'), ), onPanUpdate: (details) {setState(() { x+= details.delta.dx; y+= details.delta.dy; controller.markNeedsPaint(); }); }, ).applyConstraint( size:200, centerTo: parent, translate:Offset(x, y), ) ], ), ); }}
ConstraintLayout's constraint-based layout algorithm is extremely powerful and flexible, and itseems that it can become a general layout framework. You just need to generate constraints and handover the task of layout to ConstraintLayout. Some built-in features like circle position, staggeredgrid, grid, and list are available in extended form.
The charts in the online example is a typical extension:
Extensions for ConstraintLayout are welcome.
If it helps you a lot, consider sponsoring me a cup of milk tea, or giving a star. Your support isthe driving force for me to continue to maintain.
Thanks to the following netizens for their sponsorship, let's make Flutter better and bettertogether.
- 栢陶 2022.05.15
- CaiGo 2022.05.17
Subscribe to my WeChat official account to get the latest news of ConstraintLayout. Follow-up willalso share some high-quality, unique, and thoughtful Flutter technical articles.
Scan the code to add my personal WeChat, pull you into the Flutter technical exchange WeChat group,please note 【add technical group】
MIT LicenseCopyright (c) 2022 hackware1993Permission is hereby granted, free of charge, to any person obtaining a copy of this software andassociated documentation files (the "Software"), to deal in the Software without restriction,including without limitation the rights to use, copy, modify, merge, publish, distribute,sublicense, and/or sell copies of the Software, and to permit persons to whom the Software isfurnished to do so, subject to the following conditions:The above copyright notice and this permission notice shall be included in all copies or substantialportions of the Software.THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUTNOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE ANDNONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGESOR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR INCONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
About
A super powerful Stack, build flexible layouts with constraints. Similar to ConstraintLayout for Android and AutoLayout for iOS. But the code implementation is much more efficient, it has O(n) layout time complexity and no linear equation solving is required.
Topics
Resources
License
Uh oh!
There was an error while loading.Please reload this page.
Stars
Watchers
Forks
Packages0
Uh oh!
There was an error while loading.Please reload this page.
Contributors2
Uh oh!
There was an error while loading.Please reload this page.