Flutter智能文本处理插件smart_text_widget的使用

Flutter智能文本处理插件smart_text_widget的使用

smart_text_widget 是一个Flutter包，提供了高度可定制的 RTText 小部件。它设计用于处理各种场景，如空值、空字符串、数字、列表和映射等。该小部件还包括滚动、截断和动态文本显示等功能。

特性

• 支持多种数据类型：支持空值、空字符串、数字、列表和映射。
• 动态截断：设置最大宽度并动态截断文本。
• 滚动支持：自动滚动以适应长字符串或列表。
• 自定义列表分隔符：选择如何分隔列表项（逗号 , 或竖线 |）。
• 错误处理：在出现问题时显示默认或自定义错误文本。

截图

开始使用

要使用此包，将其添加到您的项目中，在 pubspec.yaml 文件中包含以下依赖：

dependencies:
  smart_text_widget: ^0.0.3

处理空值

RTText 小部件可以优雅地处理空值。当传递空值时，您可以显示自定义错误消息。以下是有效处理空值的方法：

const RTText(
  text: null,
  errorTrue: true,
  errorValue: "Null Value Encountered!",
  truncateEnable: true,
  truncateSize: 10,
  customEllipsis: "-->",
  maxWidth: true,
),

处理空字符串

如果输入为空字符串，您可以显示占位符或自定义消息以通知用户：

const RTText(
  text: "",
  errorTrue: true,
  errorValue: "No content available!",
  maxWidth: true,
),

显示数字值

您可以传递包括整数和浮点数在内的数字值给 RTText 小部件。该小部件会自动将它们转换为字符串。

const RTText(
  text: 42,
  maxWidth: true,
),

处理列表

RTText 小部件可以显示字符串列表。如果列表很长，可以使用 scroll 参数允许滚动。

const RTText(
  text: ["Apple", "Banana", "Cherry"],
  scroll: true,
  listSeparator: " | ",
  textAlign: TextAlign.center,
  maxWidth: true,
),

处理映射

您还可以传递映射来显示键值对作为文本。如有必要，可以自定义错误消息。

const RTText(
  text: {"name": "John", "age": 30},
  errorTrue: false,
  maxWidth: true,
),

截断长文本

如果文本超过特定长度，您可以启用截断。小部件将在指定长度后显示省略号。

const RTText(
  text: "This is a very long text that needs to be truncated after a certain length.",
  truncateEnable: true,
  truncateSize: 12,
  customEllipsis: "...",
  maxWidth: true,
),

可滚动的长字符串

对于需要在特定宽度内显示的长字符串，启用滚动以增强用户体验。

const RTText(
  text: "This is a long string that should be scrollable within its container.",
  scroll: true,
  maxWidth: true,
),

完整代码示例

以下是如何在Flutter应用中使用SmartText的小示例：

import 'package:flutter/material.dart';
import 'package:smart_text_widget/smart_text_widget.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: 'RTText Widget Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: Scaffold(
        appBar: AppBar(
          title: const Text('RTText Widget Showcase'),
        ),
        body: const SingleChildScrollView(
          child: Padding(
            padding: EdgeInsets.all(12.0),
            child: RTTextShowcase(),
          ),
        ),
      ),
    );
  }
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Column(
      crossAxisAlignment: CrossAxisAlignment.start,
      children: [
        const Text(
          'ResearchThinker Smart Text Widget: Handles Null, Empty, List, and Map values.',
          style: TextStyle(fontSize: 18, fontWeight: FontWeight.bold),
        ),
        const SizedBox(height: 10),
        // Null Value Example
        const RTText(
          text: null,
          errorTrue: true,
          errorValue: "Null Value Encountered!",
          truncateEnable: true,
          truncateSize: 10,
          customEllipsis: "-->",
          maxWidth: true,
        ),
        const SizedBox(height: 10),
        const RTText(  // Empty String Example
          text: "",
          errorTrue: true,
          errorValue: "Empty String!",
          maxWidth: true,
        ),
        const SizedBox(height: 10),
        const RTText( // Zero Value Example
          text: "0.0",
          truncateEnable: true,
          truncateSize: 4,
          textAlign: TextAlign.center,
          maxWidth: true,
          customEllipsis: " ==> ",
        ),
        const SizedBox(height: 10),
        const RTText( // List Example with Separator
          text: ["Apple", "Banana", "Cherry"],
          scroll: true,
          listSeparator: " | ",
          textAlign: TextAlign.center,
          textStyle: TextStyle(fontSize: 16, color: Colors.blue, fontWeight: FontWeight.bold),
        ),
        const SizedBox(height: 10),
        const RTText(
          text: ["Apple", "Banana", "Cherry"],
          scroll: true,
          listSeparator: " , ",
          textAlign: TextAlign.center,
          textStyle: TextStyle(fontSize: 16, color: Colors.blue, fontWeight: FontWeight.bold),
        ),
        const SizedBox(height: 10),
        const RTText(
          text: ["Apple", "Banana", "Cherry"],
          scroll: true,
          listSeparator: " - ",
          textAlign: TextAlign.center,
          textStyle: TextStyle(fontSize: 16, color: Colors.blue, fontWeight: FontWeight.bold),
        ),
        const SizedBox(height: 10),
        const RTText( // Map Example
          text: {"name": "ResearchThinker", "website": "https://researchthinker.com"},
          errorTrue: false,
          maxWidth: true,
          emptyPlaceholder: "No data available",
          textAlign: TextAlign.right,
        ),
        const SizedBox(height: 10),
        const RTText(  // Dynamic Value Example
          text: 120,
          textStyle: TextStyle(color: Colors.green, fontSize: 18),
          textAlign: TextAlign.left,
          maxWidth: true,
        ),
        const SizedBox(height: 10),
        const RTText(  // Large String with Scroll and Max Width
          text: "This is a very long text that might not fit in a single line and needs to be scrolled or truncated.",
          scroll: true,
          maxWidth: true,
          truncateSize: 62,
          truncateEnable: true,
          textStyle: TextStyle(fontSize: 16, fontWeight: FontWeight.w400),
          textAlign: TextAlign.justify,
        ),
      ],
    );
  }
}