搜尋套件、儲存庫與 APP 分類

套件詳情v1.0.1

flutter_survey

一個用於處理動態問卷/資料收集調查的建立與狀態管理的套件,支援條件性問題。

AndroidiOSWebmacOSWindowsLinux
近 30 天下載
133
喜歡數
52
Pub 分數
140

安裝套件

flutter pub add flutter_survey

套件介紹

根據套件公開資料產生的選型評估,僅供參考。

Flutter Survey 是一個動態表單套件,專為在 Flutter 應用中建立互動式問卷與資料收集調查而設計。它支援條件邏輯,讓問題能根據先前的答案出現或消失。該套件有效管理調查狀態,實現跨多個平台的順暢導航與資料處理。非常適合用於收集使用者反饋、進行評估或取得具有分支邏輯的結構化輸入。可輕鬆整合至針對 Android、iOS、Web、macOS、Windows 與 Linux 所開發的應用程式中。

適用情境

  • 用戶反饋收集
  • 互動評估
  • 動態數據輸入表單
  • 分支問卷工作流程
  • 移動和網頁數據調查

主要特色

  • 條件性問題渲染
  • 問卷的狀態管理
  • 跨平台支援
  • 與 Flutter 的輕鬆整合
  • 支援複雜的分支邏輯
  • 可重複使用的調查組件

適合對象

  • 開發互動式表單的開發者
  • 需要自適應問題流程的應用程式
  • 用於研究或分析的資料收集工具
  • 多平台調查應用
  • 以使用者體驗為導向的資料輸入介面

使用建議

  • 需要理解條件邏輯設計
  • 複雜佈局可能需要自訂樣式
  • 內建驗證功能有限,僅限基本需求
  • 最適合中等複雜度的調查,而非高度自訂的使用者介面

原始 README

以下為關聯原始碼儲存庫的 README 原文快照,最新內容請造訪原始碼儲存庫。

Flutter Survey Logo

Pub License: MIT style: flutter lints License: MIT

Flutter Survey Logo 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.

Screenrecorder-2021-05-11-20-23-21-153

📋 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.

🔮 Next Update

:heavy_check_mark: Supports Internationalization.
:heavy_check_mark: Supports custom regex validation
:heavy_check_mark: Supports various formats of input (Date Picker, File Upload, Slider etc)
:heavy_check_mark: Track progress

⚙️ Installation

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

所屬分類

依賴

依賴清單 5 項

原始碼儲存庫

使用此套件的專案

暫無相關資料。