Flutter社交媒体文案格式化插件social_media_caption_formatter的使用

概述

social_media_caption_formatter 是一个为 Flutter 应用程序提供自定义小部件的软件包，用于格式化社交媒体文案。它支持如展开/折叠（read more/less）、可点击的网址、提及和标签等功能。

特性

• 自定义 CustomReadMore 小部件，用于显示社交媒体文案。
• 支持展开/折叠功能。
• 可点击的网址、提及和标签。
• 可自定义的截断长度、截断模式和文本样式。

安装

要使用此软件包，请在项目的 pubspec.yaml 文件中添加 social_media_caption_formatter 作为依赖项。

dependencies:
  flutter:
    sdk: flutter
  social_media_caption_formatter: ^0.0.1 # 最新版本

使用示例

以下是一个完整的示例，演示如何使用 social_media_caption_formatter 插件。

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('社交平台文案格式化插件'),
        ),
        body: Padding(
          padding: EdgeInsets.all(16.0),
          child: SocialMediaCaptionFormatter(
            text: "这是一段很长的文案，包含多个网址 http://example.com 和提及 @user123 以及标签 #flutter #dart 。点击这些元素会触发相应的动作。",
            trimLength: 50, // 截断长度
            trimMode: TrimMode.End, // 截断模式
            onTrim: (trimmedText) {
              print("截断后的文案: $trimmedText");
            },
            onUrlTap: (url) {
              print("点击了网址: $url");
            },
            onMentionTap: (mention) {
              print("点击了提及: $mention");
            },
            onHashtagTap: (hashtag) {
              print("点击了标签: $hashtag");
            },
          ),
        ),
      ),
    );
  }
}

代码解释

1. 导入必要的库

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

2. 主函数和应用入口

   void main() {
     runApp(MyApp());
   }
   
   class MyApp extends StatelessWidget {
     @override
     Widget build(BuildContext context) {
       return MaterialApp(
         home: Scaffold(
           appBar: AppBar(
             title: Text('社交平台文案格式化插件'),
           ),
           body: Padding(
             padding: EdgeInsets.all(16.0),
             child: SocialMediaCaptionFormatter(
               text: "这是一段很长的文案，包含多个网址 http://example.com 和提及 @user123 以及标签 #flutter #dart 。点击这些元素会触发相应的动作。",
               trimLength: 50, // 截断长度
               trimMode: TrimMode.End, // 截断模式
               onTrim: (trimmedText) {
                 print("截断后的文案: $trimmedText");
               },
               onUrlTap: (url) {
                 print("点击了网址: $url");
               },
               onMentionTap: (mention) {
                 print("点击了提及: $mention");
               },
               onHashtagTap: (hashtag) {
                 print("点击了标签: $hashtag");
               },
             ),
           ),
         ),
       );
     }
   }
   

在这个示例中，我们创建了一个简单的 Flutter 应用程序，并使用 SocialMediaCaptionFormatter 小部件来展示一段包含网址、提及和标签的长文案。通过设置 trimLength 和 trimMode 参数，我们可以控制文案的初始显示长度和截断模式。此外，我们还设置了回调函数 onUrlTap、onMentionTap 和 onHashtagTap 来处理用户点击这些元素时的相应操作。