You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
layui/docs/dropdown/detail/options.md

4.0 KiB

属性名 描述 类型 默认值
elem

绑定元素选择器或 DOM 对象

string/DOM -

data

下拉菜单的数据源。格式详见:#data 格式

array -
trigger

触发组件的事件类型。支持所有事件,如: click,hover,mousedown,contextmenu

string

click

show

是否渲染即显示组件面板。该属性一般在重载方法中传递。

boolean

false

align

下拉面板相对绑定元素的水平对齐方式。支持以下可选值:

  • left 左对齐(默认)
  • center 居中对齐
  • right 右对齐
string

left

isAllowSpread

是否允许菜单组展开收缩

boolean

true

isSpreadItem

是否初始展开子菜单

boolean

true

delay

延迟关闭的毫秒数。当 trigger: 'hover' 时才生效

number

300

className

自定义组件主容器的样式类名,从而在外部重新定义样式。

string -
style

设置组件主容器的 CSS 样式。

string -
shade 2.8+

设置弹出时的遮罩。支持以下方式赋值:

  • 若值为 number 类型,则表示为遮罩透明度,如:
    shade: 0.3
  • 若值为 array 类型,则可同时设置透明度和背景色,如:
    shade: [0.3, '#000']
number
array

0

templet

全局定义菜单的列表模板,可添加任意 html 字符,且支持 laytpl 模板语法。用法详见:#示例

2.8+ : 模板亦可采用函数写法:

templet: function(d){
  return '<i class="layui-icon layui-icon-tips"></> ' + d.title;
}
string
function
-
content

自定义组件内容,从而替代默认的菜单结构。用法详见:#示例

string -
clickScope 2.8+

设置触发点击事件的菜单范围。 支持以下可选值:

  • all : 即代表父子菜单均可触发事件

默认无需设置,即父级菜单不触发事件

string -
ready

组件成功弹出后的回调函数。返回的参数如下:

ready: function(elemPanel, elem){
  console.log(elemPanel); // 组件面板元素对象
  console.log(elem); // 当前组件绑定的目标元素对象
}   

click

菜单项被点击时的回调函数。返回的参数如下:
click: function(data, othis){
  console.log(data); // 当前所点击的菜单项对应的数据
  console.log(othis); // 当前所点击的菜单项元素对象
  console.log(this.elem); // 当前组件绑定的目标元素对象,批量绑定中常用
  
  // 若返回 false则点击选项可不关闭面板 --- 2.8+
  /*
  return false;
  */

用法详见:#示例