搜索插件、代码仓与 APP 分类

float_column 封面
插件详情v4.2.1

float_column

Flutter FloatColumn 小部件,用于构建垂直列的控件和文本,其中文本会围绕浮动控件环绕,类似于 CSS float 的工作方式。

AndroidiOSWebmacOSWindowsLinux
近 30 天下载
9350
喜欢数
86
Pub 分数
160

安装插件

flutter pub add float_column

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

float_column 包提供了一个 Flutter 小部件,可实现垂直列布局,并使文本环绕浮动的子小部件,模拟 CSS float 行为。它非常适合创建流畅的杂志式布局,其中文本会围绕图片或其他元素流动。该小部件支持 Android、iOS、Web、macOS、Windows 和 Linux 等多个平台,适用于跨平台应用。它通过结合布局精度与动态内容流,增强了 UI 的灵活性。

适合场景

  • 杂志风格的文章布局
  • 带有图片和文字的产品列表
  • 带有浮动元素的动态内容卡片
  • 响应式网页布局
  • 社交媒体帖子显示

主要特点

  • 文本环绕浮动控件
  • 跨平台兼容性
  • 基于列的灵活结构
  • 支持混合小部件类型
  • 轻松集成到现有的 Flutter 代码中

适合对象

  • 需要类似 CSS 浮动行为的 UI 设计师
  • 开发内容丰富的应用程序的开发者
  • 需要响应式文本流的应用程序
  • Web 和移动混合项目
  • 复杂布局场景

使用建议

  • 可能需要仔细的对齐测试
  • 大量浮动元素带来的性能影响
  • 对嵌套浮点数的支持有限
  • 不适合高度复杂的网格系统
  • 需要理解布局约束

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

float_column

Pub License: MIT

A Flutter widget for building a vertical column of widgets and text, where the text wraps around floated widgets — similar to the CSS float and clear properties.

Try the live demo: https://ronjb.github.io/float_column

Example with left-to-right text

Features

  • Float widgets to the left or right (or start/end for automatic right-to-left support), with paragraph text wrapping around them.
  • Float widgets inline from within text using WidgetSpan — the float anchors to its position in the text.
  • Clear floats (like CSS clear), with optional minimum spacing.
  • Margins, padding, and a first-line indent (or hanging indent) on paragraphs.
  • Constrain a float's width to a percentage of the column's width.
  • Full right-to-left text direction support.
  • Justified text (TextAlign.justify) works correctly, including where text wraps around floats and at a first-line indent.
  • Works with Flutter text selection.
  • FloatColumn widgets can themselves be floated and nested.

Getting started

Add the dependency to your app's pubspec.yaml file:

dependencies:
  float_column: ^4.1.3

And import it:

import 'package:float_column/float_column.dart';

Usage

Basic example

FloatColumn accepts a list of children that can be Widget, Text, RichText, TextSpan, or WrappableText objects. Wrap any widget that should float in a Floatable:

FloatColumn(
  children: [
    const Floatable(
      float: FCFloat.start,
      padding: EdgeInsetsDirectional.only(end: 8),
      child: FlutterLogo(size: 100),
    ),
    const Floatable(
      float: FCFloat.end,
      clear: FCClear.both,
      clearMinSpacing: 20,
      padding: EdgeInsetsDirectional.only(start: 8),
      child: FlutterLogo(size: 100),
    ),
    WrappableText(
      text: const TextSpan(
        text: 'This text will wrap around the floated widgets, '
            'flowing to the right of the first logo, then below it, '
            'then to the left of the second logo…',
      ),
    ),
  ],
),

Plain Text and TextSpan children work too — they're treated like WrappableText automatically:

FloatColumn(
  children: [
    const Floatable(float: FCFloat.start, child: FlutterLogo(size: 80)),
    const Text('Text children wrap around floated siblings too.'),
  ],
),
Floated widgets in WidgetSpans

Widgets can also be floated from within the text itself by wrapping them in a Floatable inside a WidgetSpan. The float is anchored to the line of text containing the WidgetSpan, and the text wraps around it from there — handy for figures, pull quotes, or margin notes that should stay with their place in the text:

FloatColumn(
  children: [
    WrappableText(
      text: const TextSpan(
        children: [
          TextSpan(text: 'The image below is floated at the point in the '
              'text where it appears'),
          WidgetSpan(
            child: Floatable(
              float: FCFloat.start,
              clear: FCClear.start,
              padding: EdgeInsetsDirectional.only(end: 8),
              maxWidthPercentage: 0.33,
              child: Image(image: AssetImage('assets/fig1.png')),
            ),
          ),
          TextSpan(text: ', and the rest of the paragraph continues to '
              'wrap around it…'),
        ],
      ),
    ),
  ],
),
Drop caps

A classic use case — float the first letter of a paragraph:

FloatColumn(
  children: [
    WrappableText(
      text: const TextSpan(
        children: [
          WidgetSpan(
            child: Floatable(
              float: FCFloat.start,
              padding: EdgeInsetsDirectional.only(end: 8),
              child: Text('T', style: TextStyle(fontSize: 64, height: 1)),
            ),
          ),
          TextSpan(text: 'he rest of the paragraph wraps around the '
              'oversized first letter, like a drop cap in a book or '
              'magazine…'),
        ],
      ),
    ),
  ],
),

See the example app for a more polished DropCap widget with font-size-aware measurements.

Clearing floats

Like CSS clear, a child can be pushed below previously floated siblings with the clear property, using FCClear.left, FCClear.right, FCClear.start, FCClear.end, or FCClear.both. Floated widgets also support clearMinSpacing, the minimum vertical space between the cleared widget and the float above it:

FloatColumn(
  children: [
    const Floatable(float: FCFloat.start, child: FlutterLogo(size: 100)),
    const Floatable(
      float: FCFloat.start,
      clear: FCClear.start, // Placed below the first logo,
      clearMinSpacing: 16,  // with at least 16 pixels of spacing.
      child: FlutterLogo(size: 100),
    ),
    WrappableText(
      text: const TextSpan(text: 'This text wraps around both logos…'),
      clear: FCClear.none, // The default — no clearing.
    ),
  ],
),
Margins, padding, and indent

WrappableText and Floatable both support margin and padding. Margins can overlap adjacent content, similar to CSS margin behavior — vertical margins collapse between non-floated siblings, and a floated child's margin box is what sibling content wraps around. Padding never overlaps siblings.

WrappableText also supports a first-line indent — use a positive value for a normal indent or a negative value for a hanging indent:

WrappableText(
  text: const TextSpan(text: 'A paragraph with an indented first line…'),
  indent: 32,
  margin: const EdgeInsetsDirectional.only(start: 16),
  padding: const EdgeInsets.symmetric(vertical: 8),
),
Right-to-left text

FloatColumn respects the ambient Directionality (or an explicit textDirection), and FCFloat.start/FCFloat.end and FCClear.start/FCClear.end resolve automatically:

Example with right-to-left text

Nesting

FloatColumn widgets can be floated and nested:

Example with nested FloatColumn widgets

Reference

Floatable
Property Description
float Which side to float to: none (default), left, right, start, or end.
clear Place this child below floated siblings: none (default), left, right, start, end, or both.
clearMinSpacing Minimum vertical spacing below the cleared sibling.
margin Space around the child that can overlap adjacent content.
padding Space around the child that never overlaps siblings.
maxWidthPercentage Maximum width as a fraction of the column's width (defaults to 1.0).
WrappableText
Property Description
text The TextSpan to display.
clear Place this paragraph below floated siblings.
indent First-line indent; negative for a hanging indent.
margin, padding Space around the paragraph.
textAlign, textDirection, overflow, textScaler, maxLines, locale, strutStyle, textHeightBehavior Standard text layout properties, like those on Text.

Additional information

所属分类

源码仓库

使用此插件的项目