Flutter自动文本换行与大小调整插件text_wrap_auto_size的使用

text_wrap_auto_size 是一个Flutter插件，用于根据给定的尺寸自动调整文本的换行和字体大小，并支持多种语言的连字符处理。

功能特性

• 自动缩放字体大小。
• 程序化访问字体大小计算。
• 支持多种语言的连字符处理。
• 设置最小和最大字体大小。
• 使用二分搜索算法以提高效率。

快速开始

首先需要在项目中添加 text_wrap_auto_size 依赖：

dependencies:
  text_wrap_auto_size: ^latest_version

然后导入包并使用：

import 'package:flutter/material.dart';
import 'package:text_wrap_auto_size/text_wrap_auto_size.dart';
import 'package:text_wrap_auto_size/text_wrap_auto_size_hyphend.dart';

示例代码

以下是一个完整的示例demo，展示如何使用该插件实现自动文本换行和大小调整功能：

import 'package:flutter/material.dart';
import 'package:text_wrap_auto_size/text_wrap_auto_size_hyphend.dart';

class ExampleHyphenation extends StatefulWidget {
  final TextEditingController controller = TextEditingController(
      text: 'The arts are a vast subdivision of culture, composed of many creative endeavors and disciplines.');

  ExampleHyphenation({Key? key}) : super(key: key);

  @override
  _ExampleHyphenationState createState() => _ExampleHyphenationState();
}

class _ExampleHyphenationState extends State<ExampleHyphenation> {
  String text = '';

  @override
  void initState() {
    super.initState();
    text = widget.controller.text;
    widget.controller.addListener(() {
      setState(() {
        text = widget.controller.text;
      });
    });
  }

  @override
  Widget build(BuildContext context) {
    return SafeArea(
      child: Scaffold(
        body: SingleChildScrollView(
          child: Column(
            children: [
              SizedBox(
                width: MediaQuery.of(context).size.width,
                height: MediaQuery.of(context).size.height * 0.1,
                child: TextFormField(
                  controller: widget.controller,
                  decoration: const InputDecoration(hintText: 'Enter some text'),
                  autofocus: true,
                ),
              ),
              const SizedBox(height: 16),
              SizedBox(
                width: MediaQuery.of(context).size.width,
                height: MediaQuery.of(context).size.height * 0.9,
                child: TextWrapAutoSizeHyphend(
                  Text(
                    text,
                    style: const TextStyle(color: Colors.red, fontWeight: FontWeight.bold),
                    textAlign: TextAlign.right,
                    key: ValueKey(text),
                  ),
                  'en_us',
                  doShowDebug: true,
                  minFontSize: 50,
                  maxFontSize: 100,
                ),
              ),
            ],
          ),
        ),
      ),
    );
  }
}

关键参数说明

• minFontSize 和 maxFontSize: 设置文本的最小和最大字体大小。如果这些设置导致文本被裁剪，则会忽略这些参数。
• language code: 例如 'en_us' 用于指定连字符处理的语言。
• doShowDebug: 开启调试信息显示。

其他注意事项

• 插件要求必须提供宽度和高度，否则会抛出异常。
• 可以通过静态方法 solution 获取计算后的数据，包括调整后的 TextStyle 和最终渲染的尺寸。

总结

text_wrap_auto_size 提供了强大的文本自动换行和字体大小调整功能，适用于需要动态调整文本显示的应用场景。更多详细信息和示例可以参考 官方文档 或 GitHub仓库。