Flutter评分插件reactive_flutter_rating_bar的使用

描述

reactive_flutter_rating_bar 是一个包装了 flutter_rating_bar 的插件，用于与 reactive_forms 一起使用。它提供了更方便的方法来创建可响应的评分条组件，并且可以轻松地集成到基于 ReactiveForms 的表单中。

由于官方文档还在编写中，您可以参考 GitHub 上提供的 示例代码 来了解如何使用该插件。

示例代码

下面是一个完整的示例，展示了如何在Flutter应用中使用 reactive_flutter_rating_bar：

import 'package:flutter/material.dart';
import 'package:reactive_flutter_rating_bar/reactive_flutter_rating_bar.dart';
import 'package:reactive_forms/reactive_forms.dart';

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

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

  // 构建表单
  FormGroup buildForm() => fb.group({
        'input': FormControl<double>(value: 2.5),
      });

  // 创建自定义图标
  Widget _image(String asset) {
    return Image.asset(
      asset,
      height: 30.0,
      width: 30.0,
      color: Colors.amber,
    );
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
        visualDensity: VisualDensity.adaptivePlatformDensity,
      ),
      home: Scaffold(
        body: SafeArea(
          child: SingleChildScrollView(
            physics: const BouncingScrollPhysics(),
            padding: const EdgeInsets.symmetric(
              horizontal: 20.0,
              vertical: 20.0,
            ),
            child: ReactiveFormBuilder(
              form: buildForm,
              builder: (context, form, child) {
                return Column(
                  children: [
                    // 使用 ReactiveRatingBar 创建评分条
                    ReactiveRatingBar<double>(
                      formControlName: 'input',
                      allowHalfRating: true,
                      ratingWidget: RatingWidget(
                        full: _image('assets/heart.png'),
                        half: _image('assets/heart_half.png'),
                        empty: _image('assets/heart_border.png'),
                      ),
                    ),
                    const SizedBox(height: 16),
                    // 使用 ReactiveRatingBarBuilder 创建自定义评分条
                    ReactiveRatingBarBuilder<double>(
                      formControlName: 'input',
                      minRating: 1,
                      direction: Axis.horizontal,
                      allowHalfRating: true,
                      itemCount: 5,
                      itemPadding: const EdgeInsets.symmetric(horizontal: 4.0),
                      itemBuilder: (context, _) => const Icon(
                        Icons.star,
                        color: Colors.amber,
                      ),
                    ),
                    ElevatedButton(
                      child: const Text('提交'),
                      onPressed: () {
                        if (form.valid) {
                          // 打印表单值
                          print(form.value);
                        } else {
                          // 标记所有字段为已触碰状态
                          form.markAllAsTouched();
                        }
                      },
                    ),
                  ],
                );
              },
            ),
          ),
        ),
      ),
    );
  }
}

代码解析

• buildForm 方法：构建了一个简单的 FormGroup，其中包含一个名为 input 的 FormControl，初始值为 2.5。
• _image 方法：用于创建自定义图标的辅助方法，可以根据需要替换为实际的图片路径。
• ReactiveRatingBar：使用预定义的 RatingWidget 来显示评分条，支持半星评分。
• ReactiveRatingBarBuilder：允许你通过 itemBuilder 自定义每个评分项的外观，这里使用的是默认的星星图标。
• ElevatedButton：当点击按钮时，检查表单是否有效，如果有效则打印表单值；否则将所有字段标记为已触碰状态以显示错误信息。

此示例展示了如何将 reactive_flutter_rating_bar 集成到您的项目中，并结合 reactive_forms 实现交互式评分功能。希望这对您有所帮助！如果有任何问题或需要进一步的帮助，请随时提问。