spz-dropdown 下拉列表

何时使用

当页面上的操作命令过多时,用此组件可以收纳操作元素。点击或移入触点,会出现一个下拉列表。可在列表中进行选择,并执行相应的命令。

  • 用于收罗一组命令操作。

代码演示

基本用法

最基本的用法,使用 open 方法来打开下拉列表,点击屏幕上非下拉列表的区域会自动隐藏下拉列表。

<button @tap="dropdown.open">Open dropdown</button>

<spz-dropdown id="dropdown" layout="nodisplay" overlay-style="top: 8px;">
  <ul>
    <li>1st item</li>
    <li>2nd item</li>
    <li>3rd item</li>
  </ul>
</spz-dropdown>

属性

属性名说明类型默认值是否必需
placement列表弹出位置,可选:bottom, bottomLeft, bottomRight, top, topLeft, topRightstringbottomLeft
overlay-style下拉根元素的样式,仅支持 topleftCSSProperties-

方法

open

打开下拉列表,不需要参数。

close

隐藏下拉列表,不需要参数。

事件

dropdownOpen

当打开下拉列表时自动触发该事件。

dropdownClose

当隐藏下拉列表时自动触发该事件。

AI 摘要(LLM Ready)

  • 组件标识spz-dropdown
  • 用途一句话:向下弹出的列表。
  • 可识别属性条目:2
  • 可识别方法小节:2
  • 可识别事件小节:2
  • 关键属性名(Top)placementoverlay-style
  • 关键方法名(Top)openclose
  • 关键事件名(Top)dropdownOpendropdownClose
  • 阅读顺序建议:先看「何时使用」与「代码演示」,再核对属性/方法/事件。
  • 关联文档/guide/actions-and-events//guide/layouts/