# 变更记录 | 产品版本 | 更新内容 | 更新日期 | | --- | --- | --- | | V6.0.1 | 新增了通过指令控制下拉列表选项是否禁用 | 2023-10-27 | | V7.0.1 | 1、完善了下拉列表字段，支持字段非必填时隐藏清除选项按钮，满足用户使用场景
2、支持了下拉字段通过“选项显示方式”平滑切换为单选字段 | 2024-10-24 | # 1 功能介绍 下拉选择内容的组件，单选。结合 字段布局面板 控件使用可以得到最佳的布局体验。 # 2 控件对象 `kd.bos.form.field.ComboEdit` # 3 视觉展示  # 4 属性说明 ## 4.1 通用属性 >通用属性包含字段和控件的一些公有的属性，如宽高，帮助文本等等。请参考[通用属性](https://vip.kingdee.com/article/215559076720798976) ## 4.2 样式属性 >样式属性是每个控件在设计器右侧样式栏可以设置的属性，请参考[样式属性](https://vip.kingdee.com/article/252017936767406336) ## 4.3 业务属性 | 属性名 | 类型 | 默认值 | 说明 | 支持版本 | | --- | --- | --- | --- | --- | | 显示样式 | 下拉 | 文字 | 设置下拉项显示内容：文字、图片、文字+图片 | | | 下拉风格 | 下拉 | 默认风格 | 设置下拉风格：默认风格、风格一，风格一为下拉图标跟随选中内容长度改变位置,详情见4.3.1 | | | 下拉项 | 弹框选择 | - | 设置下拉字段下拉项信息，可配置标题，内容和图片 | | | 缺省值 | 下拉 | - | 设置下拉列表默认展示的下拉项 | | | 为空提示信息 | 文本 | - | 当字段内容为空时，输入框内显示的信息 | | | 加密存储 | 复选框 | false | 设置字段内容是否加密存储 | | | 校验下拉值 | 复选框 | false | 给下拉列表赋值时，校验此值是否在下拉列表中存在 | | | 清除按钮 | 复选框 | true | 字段设置非必录时，可通过该属性控制是否显示清除选项按钮 | V7.0.1 | | 选项显示方式 | 下拉 | - | 可以通过控制该选项将下拉字段切换为单选字段 | V7.0.1 | ### 4.3.1 下拉风格 **下拉风格**属性分为默认、风格一。风格视觉如下： 默认风格：  风格一：  *注意： 风格一无下划线，比较精简* # 5 插件示例 ## 5.1 控件编程模型 复选框字段的控件编程模型为ComboEdit类型，派生自FieldEdit： ```java package kd.bos.form.field; public class ComboEdit extends FieldEdit { ``` ComboEdit可以控制下拉选项的锁定属性，kd.bos.form.field.ComboEdit#setComboItems 这个方法，该方法的入参是一个ComboItem集合，ComboItem提供了一个属性disable，代表是否可选，插件只需要调用控件的这个方法传入参数即可； ## 5.2 数据模型 下拉框字段的属性对象是ComboProp类型，派生自FieldProp，存储的是下拉选项值，String类型。 ```java package kd.bos.entity.property; public class ComboProp extends FieldProp { ``` ## 5.3 插件事件 下拉框字段，继承了字段值改变事件，未增加其他插件事件。