Skip to content

Panel 面板 ​

fui-panel 用于展示图文列表,可配置标题、缩略图、摘要和辅助信息。

支持平台 ​

以下为官网文档所列的平台支持情况,具体功能及版本限制请参见本页的平台说明。

App-vueApp-nvue微信小程序支付宝小程序百度小程序字节小程序QQ小程序H5PC快手小程序钉钉小程序
✓✓✓✓✓✓✓✓✓✓✓

基础用法 ​

vue
<template>
  <!-- 图文面板 -->
  <fui-panel :panelData="panelData" @click="handlePanelClick" />
</template>

<script>
export default {
  data() {
    return {
      // 面板标题与图文列表
      panelData: {
        head: '最新消息',
        list: [{ title: '组件更新', desc: '查看最新的组件使用说明' }]
      }
    };
  },
  methods: {
    /** 处理面板项点击 */
    handlePanelClick(item) {
      uni.showToast({ title: item.title, icon: 'none' });
    }
  }
};
</script>

数据结构 ​

panelData 默认使用 head 作为面板标题,list 作为列表。列表项可包含 src、title、desc、source、time、extra,分别表示图片、标题、摘要、来源、时间和附加信息。通过 fields 可将这些默认字段映射到业务数据中的其他键名。

属性 ​

尺寸和间距默认单位为 rpx。

属性类型说明官网默认值
panelDataObject面板数据{}
fieldsObject数据字段名映射{}
backgroundString面板背景色#fff
highlightBoolean点击列表项时是否显示反馈true
flexStartBoolean图片和文本是否顶部对齐false
rowReverseBoolean图片是否显示在内容右侧false
marginTopNumber / String上外边距0
marginBottomNumber / String下外边距0
paddingNumber / String左右内边距32
hdBorderBoolean是否显示标题下方分隔线true
hdLeftNumber / String标题分隔线左侧间距32
hdRightNumber / String标题分隔线右侧间距0
hdBackgroundString标题背景色#fff
headSizeNumber / String面板标题字体大小32
headColorString面板标题颜色#181818
bdBorderBoolean是否显示列表项之间的分隔线true
bdLeftNumber / String列表分隔线左侧间距32
bdRightNumber / String列表分隔线右侧间距0
widthNumber / String图片宽度120
heightNumber / String图片高度120
radiusNumber / String图片圆角0
sizeNumber / String列表项标题字体大小32
colorString列表项标题颜色#181818
fontWeightNumber / String列表项标题字重normal
descSizeNumber / String摘要字体大小28
descColorString摘要颜色#7F7F7F
infoSizeNumber / String辅助信息字体大小24
infoColorString辅助信息颜色#b2b2b2
isBorderBoolean是否显示面板上下边框true
borderColorString边框和分隔线颜色#eee

事件 ​

事件说明回调参数
click点击列表项时触发包含 index 和当前列表项字段的对象

插槽 ​

插槽说明
default列表之后的自定义内容

平台说明 ​

本地源码中,非 nvue 平台的部分颜色属性默认为空字符串,由样式变量提供颜色;nvue 使用表中的颜色默认值。本地源码的面板标题内联颜色拼接了 rpx,显式设置 headColor 时请留意实际显示效果。