Flutter URL预览插件easy_url_preview的使用

发布于 1周前 作者 itying888 来自 Flutter

Flutter URL预览插件easy_url_preview的使用

这个包可以帮助获取并展示URL的预览。

特性

  • 获取URL的预览数据。
  • 在小部件中显示预览数据。
  • 将预览数据保存到本地存储以便复用。

已知问题

  • 当此包在Web上使用时,由于CORS策略,预览数据可能无法加载。建议在移动应用中使用此包。

UrlPreview小部件

  • text: 包含URL的文本。
  • maxLinesOfDescription: 显示描述的最大行数,默认为2行。

如何使用

SizedBox(
  width: MediaQuery.sizeOf(context).width * .6,
  child: UrlPreview(
        text: "这是文本: https://www.flutterflow.io/flutterflow-developer-groups."
    ),
),

如何获取预览数据

  1. 创建一个UrlPreviewModel实例。
  2. 调用load方法以包含URL的文本加载预览数据。
  3. 通过调用hasData检查是否具有预览数据。
  4. 将预览数据保存到数据库以供以后使用。一旦预览数据被保存,应用程序可以在不重新加载的情况下显示预览数据。

示例: 注意,这段代码可能无法正常工作。你需要实现database类来保存预览数据。

// 定义一个UrlPreviewModel实例
final model = UrlPreviewModel();

// 加载站点预览
await model.load("这是文本和URL: https://google.com.");

// 检查是否有预览数据,并将其保存到数据库。
if (model.hasData) {
    await database.save(
        previewUrl: model.firstLink,
        previewTitle: model.title,
        previewDescription: model.description,
        previewImageUrl: model.image,
    );
}

如何显示预览

你可以将text传递给UrlPreview小部件来显示预览数据。text应包含URL。

或者,一旦你拥有预览数据,你可以将数据传递给UrlPreview小部件来显示预览数据而无需重新加载。

UrlPreview(
    previewUrl: message.previewUrl!,
    title: message.previewTitle,
    description:
        message.previewDescription,
    imageUrl: message.previewImageUrl,
),

示例代码

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

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return const MaterialApp(
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key});

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  String text =
      "这是文本: https://philgo.com  https://www.flutterflow.io/flutterflow-developer-groups. 点击下面的按钮查看预览。";
  bool preview = false;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: const Text('Easy URL 预览示例'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text(text),
            ElevatedButton(
              onPressed: () async {
                setState(() {
                  preview = true;
                });
              },
              child: const Text('显示预览'),
            ),
            if (preview)
              SizedBox(
                width: MediaQuery.sizeOf(context).width * .6,
                child: UrlPreview(text: text),
              ),
          ],
        ),
      ),
    );
  }
}

更多关于Flutter URL预览插件easy_url_preview的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter URL预览插件easy_url_preview的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然,下面是一个关于如何在Flutter应用中使用easy_url_preview插件的示例代码。这个插件可以帮助你快速生成一个URL的预览信息,比如标题、描述和缩略图等。

首先,你需要在你的pubspec.yaml文件中添加easy_url_preview依赖:

dependencies:
  flutter:
    sdk: flutter
  easy_url_preview: ^最新版本号  # 请替换为实际的最新版本号

然后,运行flutter pub get来安装依赖。

接下来,在你的Flutter项目中,你可以按照以下步骤使用easy_url_preview插件:

  1. 导入必要的包。
  2. 创建一个方法来获取URL预览。
  3. 在UI中显示预览信息。

以下是一个完整的示例代码:

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter URL Preview Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  final TextEditingController _urlController = TextEditingController();
  UrlPreviewData? _previewData;
  bool _isLoading = false;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Flutter URL Preview Demo'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: <Widget>[
            TextField(
              controller: _urlController,
              decoration: InputDecoration(
                labelText: 'Enter URL',
                border: OutlineInputBorder(),
              ),
              keyboardType: TextInputType.url,
            ),
            SizedBox(height: 16),
            ElevatedButton(
              onPressed: _fetchUrlPreview,
              child: Text('Get Preview'),
            ),
            SizedBox(height: 16),
            if (_isLoading)
              CircularProgressIndicator(),
            if (_previewData != null)
              Column(
                crossAxisAlignment: CrossAxisAlignment.start,
                children: <Widget>[
                  Text(
                    'Title: ${_previewData!.title}',
                    style: TextStyle(fontSize: 18, fontWeight: FontWeight.bold),
                  ),
                  SizedBox(height: 8),
                  Text('Description: ${_previewData!.description}'),
                  SizedBox(height: 16),
                  if (_previewData!.thumbnailUrl != null)
                    Image.network(
                      _previewData!.thumbnailUrl!,
                      width: double.infinity,
                      fit: BoxFit.cover,
                    ),
                ],
              ),
          ],
        ),
      ),
    );
  }

  Future<void> _fetchUrlPreview() async {
    setState(() {
      _isLoading = true;
      _previewData = null;
    });

    try {
      final String url = _urlController.text.trim();
      if (url.isEmpty || !url.startsWith('http')) {
        throw FormatException('Please enter a valid URL starting with http or https.');
      }

      final UrlPreviewResult result = await EasyUrlPreview.fetchPreview(url);
      if (result.success) {
        setState(() {
          _previewData = result.data;
          _isLoading = false;
        });
      } else {
        throw Exception(result.message ?? 'Failed to fetch URL preview.');
      }
    } catch (e) {
      setState(() {
        _isLoading = false;
        // Optionally show an error message to the user
        ScaffoldMessenger.of(context).showSnackBar(
          SnackBar(content: Text('Error: ${e.toString()}')),
        );
      });
    }
  }
}

在这个示例中,我们创建了一个简单的Flutter应用,用户可以在文本框中输入URL,然后点击按钮获取URL的预览信息。预览信息包括标题、描述和缩略图(如果可用)。

注意:在实际应用中,你可能需要添加更多的错误处理和用户体验优化,比如更详细的错误消息、加载动画的优化等。此外,easy_url_preview插件的具体API可能会随着版本更新而变化,请参考其官方文档以获取最新的使用方法和API信息。

回到顶部