鸿蒙界面开发--自定义弹窗内置可滚动的单选列表

ArkTs自定义弹框

效果图:

难点主要在于Dialog内部的自定义内容布局。涉及Stack布局及Stack嵌套、Body中使用了Scroll,最主要的是Scroll中的Column中使用了padding,给Header和Footer保留空间的高度。

此外还涉及到父子组件双向通信使用@State、@ObjectLink和@Observed, 涉及父孙组件双向通信使用@Provide和@Consume。

一个小技巧:通过在子组件中定义closeDialog?:()=>void,在子组件中关闭父组件中定义的dialog实例。

实现代码

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
// 一个内容可以滚动的单选列表

@Entry
@Component
struct CustomDialogPage {
  @Provide selectedStudent: Student = new Student()
  dialogController: CustomDialogController = new CustomDialogController({
    builder: MyCustomDialog({ cancel: this.onCancel, confirm: this.onConfirm }),
    alignment: DialogAlignment.Bottom,
    offset: { dy: 0, dx: 0 }, // 弹窗相对alignment所在位置的偏移量,即设置弹框相对于底部向上偏移10个vp
    autoCancel: true, // 点击弹框外的地方自动关闭
    customStyle: true // 弹窗容器样式是否自定义。默认值:false,弹窗容器的宽度根据栅格系统自适应,不跟随子节点;高度自适应子节点,最大为窗口高度的90%;圆角为24vp
  })

  onCancel() {
    // 注入取消钩子
    console.log('onCancel')
  }

  onConfirm() {
    // 注入确定钩子
    console.log('您点击了确定')
  }

  build() {
    Column() {
      Button('显示自定义弹窗')
        .onClick(() => {
          this.dialogController.open()
        })

      Text('子组件当前选中的学生是:' + this.selectedStudent.name)
        .fontColor(Color.Red)
    }
    .margin(10)
    .width('100%')
  }
}

/**
 * 自定义弹窗组件
 */
@CustomDialog
struct MyCustomDialog {
  @State students: Student[] = []
  controller: CustomDialogController
  cancel: () => void
  confirm: () => void

  aboutToAppear() {
    this.students = this.loadData()
  }

  loadData(): Array<Student> {
    // 加一个英文字符串,模拟器和预览器中不支持中文搜索
    let names: string[] = ['Farb', '小明', '小红', '小刚', '小美', '小杜', '小帅', '小李', '小王', '小刘', '小杨', '小宋']
    const data: Student[] = []
    let i: number
    for (i = 0; i < names.length; i++) {
      data.push(new Student(i + 1, names[i]))
    }
    return data
  }

  build() {
    Stack({ alignContent: Alignment.Bottom }) {
      Stack({ alignContent: Alignment.Top }) {
        this.Header()
        this.Body()
      }.height('100%') // 保证内嵌的Stack高度也铺满整个容器,防止搜索时容器变小
      .backgroundColor(Color.White)

      this.Footer()
    }
    .height('60%') // 弹框最占屏幕的60%高度
  }

  /**
   * 显示头部信息:包括标题和搜索框
   */
  @Builder Header() {
    Column() {
      Text('请选择一个学生').fontSize(20).margin({ top: 10, bottom: 10 })
      TextInput({ placeholder: '请输入学生姓名进行搜索' })
        .placeholderColor('#ccc')
        .onChange(value => {
          if (value) {
            this.students = this.loadData().filter(item => item.name.toLowerCase().indexOf(value.toLowerCase()) >= 0)
          } else {
            this.students = this.loadData()
          }
        })
    }.height(100)
    .padding(10)
    .zIndex(10) // 让Header位于最上面
    .backgroundColor(Color.White)
  }

  /**
   * 显示主体列表
   */
  @Builder Body() {
    Scroll() {
      Column() {
        ForEach(this.students, (item: Student) => {
          StudentCard({ student: item, closeDialogFunc: () => {
            this.controller.close() // 关闭父组件的弹框
          } })
        })
      }
      .padding({ // 这里要分别留出header和footer的高度
        bottom: 50,
        top: 100
      })
    }
    .scrollBar(BarState.Off)
  }
  /**
   * 显示底部按钮
   */
  @Builder Footer() {
    Button('取消')
      .width('100%')
      .height(50)
      .fontSize(18)
      .fontWeight(FontWeight.Bold)
      .fontColor('#3CBEF5')
      .backgroundColor(Color.White)
      .type(ButtonType.Normal)
      .onClick(() => {
        this.controller.close()
        this.cancel();
      })
  }
}


/**
 * 封装每一行数据
 */
@Component
struct StudentCard {
  @ObjectLink student: Student
  @Consume selectedStudent: Student
  // 关闭父组件的弹框函数
  closeDialogFunc?: () => void

  build() {
    Row() {
      Text(this.student.name)
        // 这里可根据需要调整布局,当前默认让student.name占据除了单选按钮的剩余所有空间
        .layoutWeight(1)
      Radio({ value: '', group: 'default' })
        .checked(this.student.isChecked)
        .onChange(isChecked => {
          // 每个单选按钮状态的变化都要同步到student属性isChecked上
          this.student.isChecked = isChecked
          if (isChecked) {
            this.closeDialog()
          }
        })
    }
    .border({
      width: {
        bottom: 1,
      },
      color: '#ddd'
    })
    .padding(10)
    .justifyContent(FlexAlign.Center)
    .onClick(() => {
      this.student.isChecked = true
      this.closeDialog()
    })
    .width('100%')
  }

  closeDialog() {
    if (this.closeDialogFunc) {
      this.selectedStudent = this.student
      this.closeDialogFunc()
    }
  }
}


@Observed
class Student {
  id: number
  name: string
  isChecked: boolean

  constructor(id?: number, name: string = '', isChecked: boolean = false) {
    this.id = id
    this.name = name
    this.isChecked = isChecked
  }
}
Licensed under CC BY-NC-SA 4.0
页面浏览量Loading
如果觉得我的博客能帮助到你,欢迎点击右侧的赞助进行投喂。如有技术咨询,也可以加本人好友。