Flutter问答向导插件question_wizard的使用

question_wizard 是一个用于 Flutter 的插件，旨在帮助开发者轻松创建问答向导或问卷调查。它提供了一个简单的方式来构建多步骤的问答流程，并且可以自定义每个步骤的 UI 和行为。

安装

首先，你需要在 pubspec.yaml 文件中添加 question_wizard 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  question_wizard: ^1.0.0  # 请使用最新版本

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

基本用法

1. 导入包：

   import 'package:question_wizard/question_wizard.dart';

2. 创建问答步骤：

   每个问答步骤都是一个 QuestionStep 对象。你可以定义问题、答案类型、验证规则等。

   final steps = [
     QuestionStep(
       title: 'What is your name?',
       answerType: AnswerType.text,
       validator: (value) {
         if (value.isEmpty) {
           return 'Please enter your name';
         }
         return null;
       },
     ),
     QuestionStep(
       title: 'How old are you?',
       answerType: AnswerType.number,
       validator: (value) {
         if (int.tryParse(value) == null) {
           return 'Please enter a valid number';
         }
         return null;
       },
     ),
     QuestionStep(
       title: 'What is your favorite color?',
       answerType: AnswerType.singleChoice,
       options: ['Red', 'Green', 'Blue'],
     ),
   ];

3. 创建 QuestionWizard 组件：

   使用 QuestionWizard 组件来显示问答向导。

   class MyWizard extends StatelessWidget {
     [@override](/user/override)
     Widget build(BuildContext context) {
       return QuestionWizard(
         steps: steps,
         onComplete: (Map<String, dynamic> answers) {
           print('Answers: $answers');
           // 处理完成的逻辑
         },
       );
     }
   }

4. 在应用中使用：

   将 MyWizard 组件添加到你的应用中。

   void main() {
     runApp(MaterialApp(
       home: Scaffold(
         appBar: AppBar(title: Text('Question Wizard')),
         body: MyWizard(),
       ),
     ));
   }

自定义

question_wizard 提供了多种自定义选项，包括：

• 自定义 UI：你可以通过 QuestionWizard 的 stepBuilder 属性来自定义每个步骤的 UI。
• 自定义验证：通过 validator 属性可以为每个步骤添加自定义验证逻辑。
• 自定义答案类型：支持文本、数字、单选、多选等多种答案类型。

示例

以下是一个完整的示例，展示了如何使用 question_wizard 创建一个简单的问答向导：

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

void main() {
  runApp(MaterialApp(
    home: Scaffold(
      appBar: AppBar(title: Text('Question Wizard')),
      body: MyWizard(),
    ),
  ));
}

class MyWizard extends StatelessWidget {
  final steps = [
    QuestionStep(
      title: 'What is your name?',
      answerType: AnswerType.text,
      validator: (value) {
        if (value.isEmpty) {
          return 'Please enter your name';
        }
        return null;
      },
    ),
    QuestionStep(
      title: 'How old are you?',
      answerType: AnswerType.number,
      validator: (value) {
        if (int.tryParse(value) == null) {
          return 'Please enter a valid number';
        }
        return null;
      },
    ),
    QuestionStep(
      title: 'What is your favorite color?',
      answerType: AnswerType.singleChoice,
      options: ['Red', 'Green', 'Blue'],
    ),
  ];

  [@override](/user/override)
  Widget build(BuildContext context) {
    return QuestionWizard(
      steps: steps,
      onComplete: (Map<String, dynamic> answers) {
        print('Answers: $answers');
        // 处理完成的逻辑
      },
    );
  }
}