questionnaire 問卷
更新時間:2025-07-03 14:46:06
一、介紹
問卷元件用於直播間的問卷調查功能,支援多種題型包括單選題、多選題、問答題、評星題等。元件提供完整的問卷展示、答題和提交功能。
元件提供一個主要入口元件:
NormalQuestionnaire- 通用問卷元件
二、引入
2.1 UMD 方式
<script src="https://websdk.videocc.net/iar-questionnaire-ui/rc-20250612/normal-questionnaire.umd.js"></script>
<script>
const { NormalQuestionnaire } = window.PolyvIarQuestionnaireUi;
</script>
2.2 NPM 方式
// 安装依赖
pnpm add @polyv/iar-questionnaire-ui
// 引入组件
import { NormalQuestionnaire } from '@polyv/iar-questionnaire-ui';
三、程式碼範例
<template>
<div>
<!-- 问卷组件 -->
<NormalQuestionnaire
ref="questionnaireRef"
:questionnaire-target="questionnaireSDK"
:questionnaire-data="questionnaireData"
@to-show="onToShow"
@to-hide="onToHide"
@submit-success="onSubmitSuccess"
/>
</div>
</template>
<script setup>
import { NormalQuestionnaire } from '@polyv/iar-questionnaire-ui';
import { Questionnaire } from '@polyv/iar-questionnaire-sdk';
// 初始化问卷 SDK
const questionnaireSDK = new Questionnaire(iarCore);
// 问卷数据
const questionnaireData = ref(null);
// 事件处理
const onToShow = () => {
console.log('显示问卷弹窗');
};
const onToHide = () => {
console.log('隐藏问卷弹窗');
};
const onSubmitSuccess = () => {
console.log('问卷提交成功');
};
</script>
四、API
4.1 Props
| 參數 | 說明 | 類型 | 預設值 | 必填 |
|---|---|---|---|---|
| questionnaireTarget | 問卷 SDK 實例 | Questionnaire |
- | 是 |
| questionnaireData | 問卷資料 | QuestionnaireData |
- | 否 |
4.2 Events
| 事件名 | 說明 | 回調參數 |
|---|---|---|
| to-show | 顯示問卷彈窗時觸發 | () => void |
| to-hide | 隱藏問卷彈窗時觸發 | () => void |
| submit-success | 問卷提交成功時觸發 | () => void |
4.3 方法
透過 ref 可以呼叫元件的方法:
| 方法名 | 說明 | 參數 | 回傳值 |
|---|---|---|---|
| show | 顯示問卷 | - | void |
| hide | 隱藏問卷 | - | void |
| submit | 提交問卷 | - | Promise<void> |
