Flutter文本辅助插件text_helpers的使用

特性

InlineText / InlineRow

InlineText + InlineRow

开始使用

pubspec.yaml

在pubspec.yaml文件中添加依赖项：

dependencies:
  text_helpers: <latest_version>

导入

在代码中导入包：

import 'package:text_helpers/text_helpers.dart';

使用方法

InlineRow

InlineRow 可用于调整子元素大小以避免溢出。当行溢出时，可以只缩小指定的子元素。

示例：第一段文字溢出时缩小

InlineRow(
  wrapIndex: 0, // 第一个子元素会根据溢出情况调整大小
  children: [
    Text('First content', overflow: TextOverflow.ellipsis), // 文本溢出时显示省略号
    Text('Second content'),
    Text('Third content'),
  ],
)

示例：第二段文字溢出时缩小

InlineRow(
  wrapIndex: 1, // 第二个子元素会根据溢出情况调整大小
  children: [
    Text('First content'),
    Text('Second content', overflow: TextOverflow.ellipsis), // 文本溢出时显示省略号
    Text('Third content'),
  ],
)

InlineText

InlineText 可用于逐字隐藏溢出的文字，解决 Flutter 的溢出问题（如 flutter#18761）。

示例：简单使用

InlineText('Lorem Ipsum is simply dummy text')

效果图

完整示例

以下是一个完整的示例代码，展示如何集成 InlineRow 和 InlineText：

main.dart

import 'package:flutter/material.dart';

import 'src/full_example.dart';
import 'src/inline_row_example.dart';
import 'src/inline_text_example.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Text Helpers Example',
      theme: ThemeData(primarySwatch: Colors.blue),
      home: const HomePage(),
    );
  }
}

class HomePage extends StatefulWidget {
  const HomePage({Key? key}) : super(key: key);

  [@override](/user/override)
  State<HomePage> createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Text Helpers Example')),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              child: Text('InlineRow'),
              onPressed: () {
                Navigator.of(context).push(
                  MaterialPageRoute(builder: (context) => InlineRowExample()),
                );
              },
            ),
            SizedBox(height: 10),
            ElevatedButton(
              child: Text('InlineText'),
              onPressed: () {
                Navigator.of(context).push(
                  MaterialPageRoute(builder: (context) => InlineTextExample()),
                );
              },
            ),
            SizedBox(height: 10),
            ElevatedButton(
              child: Text('Full Example'),
              onPressed: () {
                Navigator.of(context).push(
                  MaterialPageRoute(builder: (context) => FullExample()),
                );
              },
            ),
          ],
        ),
      ),
    );
  }
}

inline_row_example.dart

import 'package:flutter/material.dart';
import 'package:text_helpers/text_helpers.dart';

class InlineRowExample extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('InlineRow Example')),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Text('First Example: First content shrinks when overflowed'),
            SizedBox(height: 10),
            InlineRow(
              wrapIndex: 0, // 第一个子元素溢出时缩小
              children: [
                Text('First content', overflow: TextOverflow.ellipsis),
                Text('Second content'),
                Text('Third content'),
              ],
            ),
            SizedBox(height: 20),
            Text('Second Example: Second content shrinks when overflowed'),
            SizedBox(height: 10),
            InlineRow(
              wrapIndex: 1, // 第二个子元素溢出时缩小
              children: [
                Text('First content'),
                Text('Second content', overflow: TextOverflow.ellipsis),
                Text('Third content'),
              ],
            ),
          ],
        ),
      ),
    );
  }
}

inline_text_example.dart

import 'package:flutter/material.dart';
import 'package:text_helpers/text_helpers.dart';

class InlineTextExample extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('InlineText Example')),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Text('Simple InlineText Example'),
            SizedBox(height: 10),
            InlineText('Lorem Ipsum is simply dummy text'), // 逐字隐藏溢出部分
          ],
        ),
      ),
    );
  }
}