css_box 0.1.0
css_box: ^0.1.0 copied to clipboard
Layout widgets for the CSS rules Flutter's box protocol cannot state: whole words that overflow, shrink-to-fit, flex lines, grid tracks, floats, inline boxes.
0.1.0 #
First published version.
- Widgets for the CSS rules that Flutter's box protocol cannot state, each
an ordinary
RenderBoxthat answers Flutter's intrinsic, dry-layout and baseline questions:- lines and words:
LineBox(andLineBox.grown, CSS 2.1 10.8),Balance,Pretty,IndentedText,BlockEllipsis(withtext-wrap: balance/prettyunder a clamp),LineClamp,ClampedBlock; - inline formatting:
InlineFlow,InlineFrame,InlineFrames,GlyphBackgrounds; - baselines:
LastBaseline,EdgeBaseline,MiddleBaseline,TopBaseline,AlignBox; - sizing:
ShrinkWidth,MinContentWidth,FixedWidth,KeywordClamp,Compressible,FractionalWidth,FractionalConstraints,FractionalHeight,FractionalMinHeight,LooseHeight,RatioBox,FloorBox,Inset,Spill; - flex, grid, floats, tables and columns:
FlexLine,GapWrap,Tracks,FloatFlow,TableBox,TableCaptions,Layers,MultiColumn(balanced columns withorphansandwidows, css-multicol-1); - positioning, scrolling and clipping:
Sticky,SpotScope,SpotMark,SpotShift,SpotText,SpotArea,ClipBox,ScrollBox,DocumentExtent; - painting:
Blend,TileMask,MaskLayers,PictureTile, and the decorations and clippers (OuterShadow,InnerShadow,DashedBorder,CornerShapeBorder,OutlineRing, the gradient transforms, theclip-pathshapes and others); - interaction:
PressWhereDrawn.
- lines and words:
- Text scaling:
FloatTextandInlineFlowscale their text by atextScaler, the ambientMediaQuery.textScalerOfwhere none is given, asTextdoes: the glyphs, the strut and every inline box'sInlineFonttogether. Only text scales: anInlineAtom, or aWidgetSpanon aFloatText's line, is laid out at its own size and the text in it scales once, by its ownText-- unlikeRichText, which scales aWidgetSpan's box as a whole and the text in it again.TextScaler.noScalingkeeps a layout of fixed pixel metrics as written. - Three libraries:
css_box.dart(what a page uses),rendering.dart(the render objects and the dry-question protocols) andbands.dart(width bands), each showing its names by name; the helpers the package's own files share are@internaland in none of them. - Tested on Flutter 3.38.5 (Dart 3.10.4) through 3.47.6, with
tool/test_range.sh. The shadow cut is also tested in Chrome. - An example app that shows every snippet of the README, and benchmarks for
Tracks,InlineFlowandFloatFlowon large pages, and of howFloatTextandInlineFlowscale with their content: a line of aFloatTextis set from the words up to a cut not far past it, and anInlineFlowkeeps the widths it measured for its last two contents, not all it ever held.