Flutter Survey 是一个动态表单包,专为在 Flutter 应用中构建交互式问卷和数据收集调查而设计。它支持条件逻辑,可根据之前的回答使问题出现或消失。该包高效管理调查状态,实现跨多个平台的无缝导航和数据处理。非常适合收集用户反馈、进行评估或获取具有分支逻辑的结构化输入。可轻松集成到面向 Android、iOS、Web、macOS、Windows 和 Linux 的应用中。
适合场景
用户反馈收集
互动评估
动态数据输入表单
分支问卷工作流程
移动和网页数据调查
主要特点
条件性问题渲染
问卷的状态管理
跨平台支持
与 Flutter 的轻松集成
支持复杂的分支逻辑
可重用的调查组件
适合对象
开发交互式表单的开发者
需要自适应问题流程的应用程序
用于研究或分析的数据收集工具
多平台调查应用
以用户体验为中心的数据输入界面
使用建议
需要理解条件逻辑设计
复杂布局可能需要自定义样式
内置验证功能有限,仅限基本要求
最适合中等复杂度的调查,而非高度定制化的用户界面
原始 README
以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。
Flutter Survey
Inspired by Google Forms
A simple yet powerful package that handles the creation of a dynamic questionnaire/research survey with conditional questions.
Have you ever wanted to implement a form/questionnaire/survey like the ones you see on Google forms?
Have you ever wanted to implement conditional questions that show or hide the questions that follow, based on the user's input?
This package helps you build data collection forms hassle-free.
📋 Features
:heavy_check_mark: Eliminates boilerplate code for surveys.
:heavy_check_mark: Implement Conditional/Single Choice/Multiple Choice questions.
:heavy_check_mark: Intuitively construct your own questions with infinite nesting.
:heavy_check_mark: Customize it by creating your own form widgets from scratch using the builder method.
:heavy_check_mark: Add your own properties for your custom widgets.
:heavy_check_mark: Supports validation using the Form widget
:heavy_check_mark: Implicitly supports Dark theme.
This project requires the latest version of Dart. You can download the latest and greatest here.
1. Depend on it
Add this to your package's pubspec.yaml file:
dependencies:flutter_survey:'^1.0.1'
2. Install it
You can install packages from the command line:
$ pub get
..
Alternatively, your editor might support pub. Check the docs for your editor to learn more.
3. Import it
Now in your Dart code, you can use:
import'package:flutter_survey/survey.dart';
📖 Usage
First, you must initialize the question structure where you specify the type of questions
and their possible answers, if any. You can also nest questions to form conditional questions.
You can even mark them as mandatory. This can be either in json format fetched from the server or can be constructed using the
[Question] model provided as part of this package. The structure is intuitive and determines the flow of the form.
Types of questions
The Questions are classified based on the kind of input they take.
Text Input Question
As the name suggests here the answer is not limited to any specific choice.
The answer to this question can be typed in by the user, single line or multiline.
Setting the answerChoice variable to null or simply leaving it altogether gives you this.
Question(
question: "What is your name?",
)
Single Choice Question
Here, Radio Buttons are used as input. You define the possible answer choices as a Map,
with the keys being the answer choices. Note that the value of the corresponding keys happen to be null.
This is because they don't have an associated list of questions that follow it.
Question(
question: 'Do you like drinking coffee?',
answerChoices: {
"Yes": null,
"No": null,
},
),
Multiple Choice Question
Here, Checkboxes are used as input. Just like the Single Choice Questions, You define the possible answer choices as a Map
with the keys being the answer choices. Note that even here the value of the corresponding keys happen to be null for the same
reason as Single Choice Questions. The difference here is that you set isSingleChoice to false.
Question(
isSingleChoice: false,
question: 'What are the brands that you have tried?',
answerChoices: {
"Nestle": null,
"Starbucks": null,
"Coffee Day": null,
},
),
Conditional/Nested Questions
This is where you define questions that follow based on the answer of the question prior to it.
The values of the keys defined in the answerChoices field determines the flow. For example here,
if the user were to choose "Yes" to "Do you like drinking coffee", the user would be confronted with
another question "What are the brands you've tried?" followed by more nesting.
Question(
isMandatory: true,
question: 'Do you like drinking coffee?',
answerChoices: {
"Yes": [
Question(
singleChoice: false,
question: "What are the brands that you've tried?",
answerChoices: {
"Nestle": null,
"Starbucks": null,
"Coffee Day": [
Question(
question: "Did you enjoy visiting Coffee Day?",
isMandatory: true,
answerChoices: {
"Yes": [
Question(
question: "Please tell us why you like it",
)
],
"No": [
Question(
question: "Please tell us what went wrong",
)
],
},
)
],
})
],
"No": [
Question(
question: "Do you like drinking Tea then?",
answerChoices: {
"Yes": [
Question(
question: "What are the brands that you've tried?",
answerChoices: {
"Nestle": null,
"ChaiBucks": null,
"Indian Premium Tea": [
Question(
question: "Did you enjoy visiting IPT?",
answerChoices: {
"Yes": [
Question(
question: "Please tell us why you like it",
)
],
"No": [
Question(
question: "Please tell us what went wrong",
)
],
},
)
],
})
],
"No": null,
},
)
],
},
),
A full question structure represented as a List:
List<Question> _initialData = [
Question(
isMandatory: true,
question: 'Do you like drinking coffee?',
answerChoices: {
"Yes": [
Question(
singleChoice: false,
question: "What are the brands that you've tried?",
answerChoices: {
"Nestle": null,
"Starbucks": null,
"Coffee Day": [
Question(
question: "Did you enjoy visiting Coffee Day?",
isMandatory: true,
answerChoices: {
"Yes": [
Question(
question: "Please tell us why you like it",
)
],
"No": [
Question(
question: "Please tell us what went wrong",
)
],
},
)
],
})
],
"No": [
Question(
question: "Do you like drinking Tea then?",
answerChoices: {
"Yes": [
Question(
question: "What are the brands that you've tried?",
answerChoices: {
"Nestle": null,
"ChaiBucks": null,
"Indian Premium Tea": [
Question(
question: "Did you enjoy visiting IPT?",
answerChoices: {
"Yes": [
Question(
question: "Please tell us why you like it",
)
],
"No": [
Question(
question: "Please tell us what went wrong",
)
],
},
)
],
})
],
"No": null,
},
)
],
},
),
Question(
question: "What age group do you fall in?",
isMandatory: true,
answerChoices: const {
"18-20": null,
"20-30": null,
"Greater than 30": null,
})
];
Pass the list of questions to the ConditionalQuestions Widget.
This is the main widget that handles the form.
The list of questions constructed above are passed to the initialData parameter.
The onNext callback function is an optional parameter that is called with the current state of the survey, which is a List of
QuestionResult objects.
Survey(
initialData: _surveyData,
onNext:(questionResults){
print(questionResults);
//store the result
},
)
🤝 Contributing
Help make this package more useful and serve the needs of the community by reporting bugs,
submitting feedback and/or opening a PR.
ℹ️ About me
Visit my LinkedIn at https://www.linkedin.com/in/michel98