css_box 0.1.2
css_box: ^0.1.2 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.2 #
- A
BlockEllipsisunder aLineClampthat has been laid out answers a height asked before the clamp lays out again (intrinsic heights, dry layout) as the clamp will cut it, once the room it is asked in is not the one the clamp counted its lines in, or once anything under the clamp has changed (a text, a text scale, a style). It answered the budget the clamp's last layout told it: a title built at one line that a clamp of two let break into two lines once the text scale went from 1.3 to 2.0 answered its one line, and a grid of such cards sized its rows one line short and overflowed them until the page was laid out anew. Laid out and asked in the same room with nothing changed, a block answers as before.RenderLineClamp.markNeedsLayoutonly clears a flag. LineBoxround a line of nothing but atomic inlines on a forced strut (StrutStyle.forceStrutHeight) answers the strut's line height and ascent when asked before layout (intrinsic heights, dry layout, dry baseline), as it is laid out: Skia sets the line at the strut whatever stands on it. It worked the line out of each box's own ascent and descent, which are Skia's unrounded ones where Blink rounds them, and a glyph atvertical-align: -4pxon a 32px line answered 32.73 to anIntrinsicHeightround it. A strut that is a minimum is unchanged.- New
OffsetSpanandOffsetSpans: a run of text painted off its place on the line bydxanddy, as a relatively positioned inline box is (CSS 2.1 9.4.3,position: relativewithtop/left). The span lays out as theTextSpanit is, so the line keeps the place and no line grows;OffsetSpansround the paragraph paints it moved, each piece on its own line, andFloatTextpaints the pieces on its lines moved itself. A footnote mark attop: -0.5emon the baseline is drawn half an em up with the words round it where they were. - New
SmallCapsSpan: aTextSpanforfont-variant: small-caps(andpetite-caps,all-small-caps,all-petite-caps) in a face with no small capitals of its own. Each letter that changes when uppercased is drawn as its capital atsize, the rest at the text's size; underallthe whole run is small capitals (css-fonts-4 6.4, as a browser makes them up). Itstextstays the string written, and reads back so:SmallCapsSpan(text: 'oct 31, 2026', size: 11)drawsOCTat 11 and31, 2026at the paragraph's size.
0.1.1 #
- A vertical
FlexLinehanded no width of its own (fit-content) reads its items'FlexCell.crossSizeFractionagainst the width it comes to, where it read them as no size at all. The share counts as the item's content while the width is worked out (css-sizing-3 5.2.1), then the line is laid out again at that width: awidth: 90%item of a 351-wide column is 315.9 wide, and a column narrower than the room is its widest item's width, the share 90% of that. A line given its width is unchanged. RatioBoxat an indefinite width is as wide as its content's max-content width, and as tall as that width gives through the ratio (css-sizing-3 5.1), where it answered 0 tall. AColumnmeasuring how wide the box wants to be asks it how tall it is with no width, then how wide at that height, so a picture atwidth: 100%with anaspect-ratioin a shrink-to-fit parent (ShrinkWidth,IntrinsicWidth) came out 0x0. Asked how wide at the height it comes to by itself, which states no height (css-sizing-4 5.2), it now answers its content's widths, not the ratio's: a percentage-width picture keeps no min-content (css-sizing-3 5.2.2), and its parent shrinks to the room instead of overflowing it. A height the box is given is still read through the ratio.FractionalConstraintsasks its child how tall it is at the width the child is laid out at in the room, where it asked at the whole room. A picture of a stated width undermax-width: 100%in a wider room stays its own width (CSS 2.1 10.4), but aSizedBoxhands the width it is asked at on to theAspectRatioinside, so the picture answered the room's height: under anIntrinsicHeightit stood taller than it is. A child that fills its room (anAspectRatioof no width) is still asked at the room, and so is one that answers no width.FloatTextsets a long paragraph in work that grows with its length when it is right to left, holds right-to-left letters or bidi controls, or has a letter or word spacing. Each of its lines was set from all the rest of the paragraph, so 4 times the words took 16 times the work. A paragraph set right to left, or holding right-to-left letters, is now read off a cut a little past the line, where a letter after the line settles the bidi levels (UAX #9). A spaced paragraph, or one with an embedding or an isolate, is laid out once at the line's width, and the lines after it are read off that layout until the width changes. Its lines break where they did.
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.