Flutter Schema.org数据标记插件flutter_schema_org的使用

Flutter Schema.org 数据标记插件 flutter_schema_org 的使用

flutter_schema_org 提供了用于 Schema.org 词汇的 Dart 定义，并可以导出为 JSON-LD 格式。这些类型以完整的区分联合类型的形式暴露出来，使得自动补全和更严格的验证变得容易。

你可以在 Schema.org 上找到所有可用的模式。每个模式在这个库中都有一个前缀 Schema。

例如：

• Organization => SchemaOrganization
• Person => SchemaPerson

使用方法

调用 SchemaOrg.writeJsonLd() 方法，并传入一个表示你的数据的 Schema.org 类。

SchemaOrg.writeJsonLd(
    SchemaOrganization(
        name: 'Oddbit',
        url: 'https://oddbit.id',
        logo: 'https://avatars.githubusercontent.com/u/1946799?s=200&v=4',
    ),
);

入门指南

首先，感谢您考虑参与。你是一个真正的超级粉丝，我们非常爱你！

所有的模式定义都是由 schema_parser CLI 脚本自动生成的，该脚本可以在仓库的 /parser 文件夹中找到。

报告错误和问题

验证所有模式及其使用方式的所有可能细节是一项巨大的任务。我们非常感激任何有助于改进此包的发现和链接到源代码或最佳实践。

我们非常感激你能提供的任何帮助，甚至更好的是你能提供有关如何改进生成所有代码的 schema_parser 脚本的建议。

示例代码

以下是一个完整的示例代码，展示了如何在 Flutter 应用程序中使用 flutter_schema_org 插件。

import 'package:flutter/material.dart';
import 'package:flutter_schema_org/flutter_schema_org.dart';
import 'package:flutter_schema_org/schemas/list_item.dart';
import 'package:flutter_schema_org/schemas/item_list.dart';
import 'package:flutter_schema_org/schemas/product.dart';

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

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

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final List<SchemaListItem> items = [
    SchemaListItem(position: 1, item: SchemaProduct(name: '产品 1'))
  ];

  [@override](/user/override)
  void initState() {
    super.initState();

    SchemaOrg.writeJsonLd(
      SchemaItemList(
        url: 'https://products.id',
        numberOfItems: 10,
        itemListElement: items.map((e) => e).toList(),
      ),
      name: '第一个产品',
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Schema.org 示例应用',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSwatch(
          primarySwatch: Colors.green,
          accentColor: Colors.green.shade700,
          brightness: Brightness.dark,
        ),
      ),
      home: Scaffold(
        body: Center(
          child: IntrinsicWidth(
            child: GestureDetector(
              onTap: () {
                SchemaOrg.removeScript('第一个产品');
              },
              child: Card(
                child: Padding(
                  padding: const EdgeInsets.all(16.0),
                  child: Row(
                    children: [
                      const CircleAvatar(
                        backgroundImage: NetworkImage(
                            'https://avatars.githubusercontent.com/u/1946799?s=200&v=4'),
                        radius: 30,
                      ),
                      const SizedBox(width: 16),
                      Text(
                        'Oddbit',
                        style: Theme.of(context).textTheme.titleLarge?.copyWith(
                              color: Colors.green,
                            ),
                      ),
                    ],
                  ),
                ),
              ),
            ),
          ),
        ),
      ),
    );
  }
}