Select (系统接口)

提供下拉选择菜单，让用户在多个选项间选择。

说明：

该组件从API version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

本文仅介绍当前模块的系统接口，其他公开接口参见select。

menuSystemMaterial²³⁺

menuSystemMaterial(material:Optional<SystemUiMaterial>)

设置Select下拉菜单的系统材质。不同系统材质对应不同的属性影响效果，该接口影响下拉菜单背景色menuBackgroundColor、边框颜色borderColor、边框宽度borderWidth、阴影shadow等参数，不建议与上述接口一起使用。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.ArkUI.ArkUI.Full

原子化服务API： 从API version 23开始，该接口支持在原子化服务中使用。

模型约束： 此接口仅可在Stage模型下使用。

参数：

参数名	类型	必填	说明
material	Optional<SystemUiMaterial>	是	设置下拉菜单系统材质。材质设置为非法值、undefined时，按照不设置系统材质处理。

示例

示例1（设置Select和下拉菜单系统材质）

该示例通过调用menuSystemMaterial接口实现下拉菜单系统材质效果，通过systemMaterial接口实现select组件系统材质效果。

从API version 23开始，新增menuSystemMaterial接口和systemMaterial接口。

import { uiMaterial } from '@kit.ArkUI';

@Entry
@Component
struct Index {
  build() {
    Column() {
      Select([{ value: 'SelectOption' },
        { value: 'SelectOption' },
        { value: 'SelectOption' },
        { value: 'SelectOption' },
        { value: 'SelectOption' }])
        .value('Click Show Options')
        .systemMaterial(new uiMaterial.Material({ type: uiMaterial.MaterialType.SEMI_TRANSPARENT }))
        .menuSystemMaterial(new uiMaterial.Material({ type: uiMaterial.MaterialType.SEMI_TRANSPARENT }))
    }
    // $r('app.media.img')需要替换为开发者所需的图像资源文件。
    .backgroundImage($r('app.media.img'))
  }
}

未设置系统材质

select-without-menu-new-material