Flutter快速开发插件Rapido的使用

Rapido 将快速应用程序开发（Rapid Application Development, RAD）的原则引入到移动开发中，目前支持 Flutter。

简介

Rapido 通过以下方式简化了构建以文档为中心的应用程序的过程：

1. 提供了 DocumentList 和 Document 类，使得管理用户数据（包括持久化）变得简单。
2. 提供了许多用于与 DocumentList 交互的 UI 元素，例如列表视图、表单、地图和其他小部件。这些小部件知道如何处理 DocumentList，因此几乎无需额外编码即可提供大量功能。
3. 轻松自定义核心小部件的能力。

快速上手

创建一个 DocumentList 并为字段定义标签，然后创建一个 DocumentListScaffold，如下所示：

class _MyHomePageState extends State<MyHomePage> {
  DocumentList taskList = DocumentList("Tarea",
      labels: {"Date": "date", "Task": "task", "Priority": "pri count"});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return DocumentListScaffold(taskList);
  }
}

Rapido 的小部件会根据字段名称推断每列的数据类型。基本的增删改查（CRUD）功能会自动创建： （添加按钮、表单、列表视图、编辑和删除、排序）

Rapido 还能处理特殊的数据类型： （选择器和地图）

你可以替换任何小部件为你自己的小部件，或者使用内置的定制钩子来快速创建你自己的外观和感觉。

Rapido 在线

• 获取 Rapido
• 我们的 GitHub 仓库
• Rapido 教程
• 我们在 YouTube 频道 上有一些入门视频

深度解析

使用 DocumentList 的概述

DocumentList 是 R.A.D. 体验的核心。只需使用一个列表，就可以获得：

1. 对象的本地持久化。
2. 默认的增删改查（CRUD）界面，用户可以用来显示、创建、编辑和删除列表中的文档。

导入

所有你需要的东西都在 rapido.dart 中：

import 'package:rapido/rapido.dart';

此导入包含 DocumentList 本身以及所有在其上工作的 UI 元素。

DocumentList

要创建一个 DocumentList，只需要包含一个 “documentType” 字符串。此字符串由 DocumentList 用于组织其文档。然后，只需传递类型为 Map<String, dynamic> 的映射即可向其添加文档。

DocumentList taskList = DocumentList("tasks");
taskList.add(Document(initialValues: {"name":"grocery shopping", "priority": 1, "done": false}));

注意，映射使用的是键的字符串，但值是动态的。你可以在 DocumentList 中存储任何你喜欢的内容。

你可以使用普通的列表功能来修改和删除文档：

taskList[0]  = Document(initialValues: {"name":"grocery shopping", "priority": 1, "done": true});

你也可以删除它们：

taskList.removeAt(0);

请注意，对 DocumentList 的所有更改都会自动保存到用户的手机上！用户可以关闭应用，重新打开时，数据仍然在那里。

UI 元素

创建 DocumentList 后，你可以使用 Rapido 提供的各种 UI 元素。只需传递 DocumentList，小部件就能自行推断出要向用户显示的功能。

例如，如果你想轻松创建一个支持添加、删除和编辑文档的应用程序，可以使用 DocumentListScaffold 类。

DocumentListScaffold(taskList, title:"Task List");

DocumentListView 将创建一个列表视图来显示和编辑列表中的项目。它还提供了多个定制选项，但默认设置“即开即用”。

DocumentListView(taskList);

DocumentListMapView 将在地图上显示任何带有名为 “latlong” 字段的文档：

DocumentListMapView(taskList);

DocumentForm 允许轻松创建新文档或编辑现有文档。

要创建新文档：

DocumentForm(taskList);

要编辑现有文档：

DocumentForm(taskList, index: 0);

欢迎反馈

Rapido 正在快速发展中。请访问 我们的 GitHub 仓库 来记录任何问题或功能请求。当然，欢迎提交拉取请求。

完整示例代码

以下是一个完整的示例代码，展示如何使用 Rapido 插件：

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

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Rapido Demo',
      home: RapidoExample(title: 'Rapido'),
    );
  }
}

class RapidoExample extends StatefulWidget {
  RapidoExample({Key key, this.title}) : super(key: key);
  final String title;

  [@override](/user/override)
  _RapidoExampleState createState() => _RapidoExampleState();
}

class _RapidoExampleState extends State<RapidoExample> {
  // 创建一个带有自定义 documentType 字符串的 DocumentList，并包含字段标签的映射。
  final DocumentList documentList = DocumentList(
    "task list",
    labels: {
      "Complete": "done?",
      "Date": "date",
      "Title": "title",
      "Note": "subtitle",
      "Priority": "pri count"
    },
  );

  // 构建一个 DocumentListScaffold，为用户提供创建、编辑和删除文档的界面。
  [@override](/user/override)
  Widget build(BuildContext context) {
    return DocumentListScaffold(
      documentList,
      title: "Tasks",
    );
  }
}