⚠️ ⚠️ ⚠️
使用本组件时 请确保【直系祖先容器】如若隐藏 不是以 以下方式
不允许的隐藏方式 |
---|
通过css样式 display:none |
通过标签属性 hidden |
带有 type=”hidden” 的表单元素 |
允许的隐藏方式 |
---|
想要设置某容器隐藏 通过设置其父容器 { overflow: hidden; height:0; width:0 } 来间接实现 |
原因:本组件中有逻辑需要通过元素所占尺寸来判断 若元素不被渲染尺寸为0
props
属性 | 说明 | 类型 | 默认值 | 备注 | |
---|---|---|---|---|---|
height | 该组件的高度 | Number | 250 | ||
toCheck | 在数据未全部加载完成的情况下是否充满height【否则无法触发下页的加载】 | Boolean | true | ||
api | 请求的接口,返回值为Promise实例 | Function | () => Promise.reject(未提供接口 ) |
返回值为Promise实例 | |
ajaxType | 请求类型GET/POST | String | GET | 当为GET:请求传参时分页参数会与其他参数并列;当为POST:请求传参时分页参数会包裹在page对象中和其他参数并列 | |
pageSize | 一页的条数 | Number | 10 | ||
params | 分页参数以外的其他参数 | Object | |||
scrollStyle | 选项容器的样式 | Object | 主要目的:用来设置容器的高度 |
*分页参数
- pageSize
- currentPage【本组件不直接接收,内部比对params自动生成】
events
事件名 | 说明 | 返回值 | 备注 |
---|---|---|---|
onListChange | 每次数据列表变化后的值 | Array | |
onLoadingChange | 每次数据加载的状态,即是否正在加载 | true/false | 该事件不用刻意使用,本组件有加载状态,该事件主要应用与需要把本组件状态映射到父组件的情况,如newSelect组件 |
slots
slot名 | 说明 | 默认值 | 备注 |
---|---|---|---|
默认插槽 | 每一条数据的样式 | 该条数据的json值 | 插槽返回值list |
*插槽使用见https://cn.vuejs.org/v2/guide/components-slots.html#%E4%BD%9C%E7%94%A8%E5%9F%9F%E6%8F%92%E6%A7%BD
文档更新时间: 2020-09-21 11:57