本篇将带你实现一个多选问卷小应用,用户可以勾选选项并点击提交按钮查看选择的结果。通过本教程,你将学习如何使用 Checkbox 组件、动态渲染列表、状态管理及用户交互,构建完整的应用程序。

关键词
- UI互动应用
 Checkbox组件- 状态管理
 - 动态列表渲染
 - 用户交互
 
一、功能说明
本多选问卷小应用允许用户选择多个选项并点击“提交”按钮。提交后会显示用户选择的选项或提示未选择任何选项。这一示例展示了如何使用 Checkbox 组件管理用户选择,并动态显示内容。
二、所需组件
@Entry和@Component装饰器Column和Row布局组件Checkbox组件用于用户选择Button组件用于提交@State修饰符用于状态管理
项目结构
- 项目名称:
MultiSelectSurveyApp - 自定义组件名称:
SurveyPage - 代码文件:
SurveyPage.ets、Index.ets 
三、代码实现
// 文件名:SurveyPage.ets
// 定义问卷页面组件
@Component
export struct SurveyPage {
  // 问卷选项数组
  questions: string[] = ['选项1', '选项2', '选项3', '选项4'];
  // 状态数组,用于保存每个选项的选中状态
  @State selectedAnswers: boolean[] = [false, false, false, false];
  @State isSubmitted: boolean = false; // 用于指示是否已提交
  // 构建页面布局和组件
  build() {
    Column({ space: 20 }) { // 垂直布局容器,子组件间距为 20
      // 问卷标题
      Text('请选择你喜欢的选项:')
        .fontSize(24)
        .fontWeight(FontWeight.Bold)
        .alignSelf(ItemAlign.Center);
      // 使用 ForEach 渲染多个复选框
      ForEach(this.questions, (question: string, index: number) => {
        Row() {
          Checkbox({ name: `checkbox${index}`, group: 'surveyGroup' }) // 创建复选框组件
            .select(this.selectedAnswers[index]) // 设置选中状态
            .selectedColor(Color.Blue) // 选中时的颜色
            .onChange((value: boolean) => { // 回调函数,更新选中状态
              this.selectedAnswers[index] = value;
              this.isSubmitted = false; // 每次改变选中状态时重置提交状态
            });
          Text(question) // 显示选项文本
            .fontSize(20)
            .margin({ left: 10 });
        }
      });
      // 提交按钮
      Button('提交')
        .onClick(() => {
          this.submitAnswers(); // 提交时触发的操作
        })
        .fontSize(20)
        .backgroundColor(Color.Green)
        .fontColor(Color.White)
        .margin({ top: 20 });
      // 根据提交状态显示不同内容
      if (this.isSubmitted) {
        if (this.getSelectedOptions().length > 0) {
          Text(`你选择了: ${this.getSelectedOptions().join(', ')}`) // 显示选择结果
            .fontSize(18)
            .fontColor(Color.Blue)
            .margin({ top: 20 });
        } else {
          Text('未选择任何选项')
            .fontSize(18)
            .fontColor(Color.Red)
            .margin({ top: 20 });
        }
      }
    }
    .padding(20)
    .width('100%')
    .height('100%')
    .alignItems(HorizontalAlign.Center);
  }
  // 获取已选中的选项列表
  private getSelectedOptions(): string[] {
    return this.questions.filter((_, index) => this.selectedAnswers[index]);
  }
  // 提交答案的逻辑
  private submitAnswers() {
    this.isSubmitted = true; // 更新提交状态
    console.log('用户提交的答案:', this.getSelectedOptions()); // 在控制台输出选中的答案
  }
}
 
// 文件名:Index.ets
// 导入自定义组件
import { SurveyPage } from './SurveyPage'
// 定义应用入口组件
@Entry
@Component
struct Index {
  build() {
    Column() {
      SurveyPage() // 引用问卷页面组件
    }
    .padding(20) // 设置页面内边距
  }
}
 
效果示例:用户选择多个选项并点击“提交”按钮后,应用会在页面上显示用户的选择结果。
四、代码解读
@State selectedAnswers:
用于保存每个选项的选中状态,Checkbox组件的选中与否根据此状态控制。ForEach循环:
用于动态生成Checkbox组件,方便渲染多项问卷选项。getSelectedOptions()方法:
返回选中的选项数组,供显示和后续处理。isSubmitted状态:
用于控制提交按钮点击后的显示效果,以便在页面上显示提交结果。
五、优化建议
- 样式调整:可以为 
Checkbox添加自定义样式,使界面更符合应用需求。 - 表单验证:在提交前验证用户是否选择了至少一个选项,避免无效提交。
 - 交互反馈:提交后添加反馈提示,如“提交成功”或弹出确认框。
 - 多语言支持:通过配置实现不同语言版本的问卷应用。
 
六、相关知识点
- 「Mac畅玩鸿蒙与硬件14」鸿蒙UI组件篇4 - Toggle 和 Checkbox 组件
 - 「Mac畅玩鸿蒙与硬件11」鸿蒙UI组件篇1 - Text 和 Button 组件详解
 
小结
本篇教程通过多选问卷小应用的实现,演示了 Checkbox 组件的基本用法和状态管理。你学会了如何动态渲染选项并处理用户输入,为开发更复杂的交互应用打下了基础。
下一篇预告
下一篇「UI互动应用篇7 - 简易计步器」将展示如何实现一个简单的计步器应用,帮助用户记录每日步数并显示当前进度。



















