Skip to content
On this page

Item 信息项

Hidden Title

基础用法:<SItem title="发起对话" sub-title="与数字员工直接交流" extra="立即进入" clickable />

属性事件插槽简介

基础用法

背景、边框与分割线

多行标题和副标题

扩展区域布局

阴影和 Hover 动画

成华主题(theme 默认值 default

石景山主题(theme 默认值 default

sybz 主题(theme 默认值:default)

设置 theme="sybz" 使用思云博智配色。theme 可选 default / chenghua / shijingshan / sybz,默认值为 default。品牌蓝 #4876EF,AI 辅助绿 #00D3AB

API

属性名说明类型可选值默认值
title标题,截断且溢出时鼠标移入显示完整内容string / number-undefined
subTitle副标题,截断且溢出时鼠标移入显示完整内容string / number-undefined
extra扩展区域的简单文本string / number-undefined
src左侧图片地址string-''
width组件宽度,数字按 px 处理string / number-''
height组件高度,数字按 px 处理string / number-''
color组件文字颜色string合法 CSS 颜色''
size预设内边距,也可直接传自定义尺寸string / numbersmall / default / large / CSS 尺寸default
padding内容内边距,优先级高于 sizestring / number-undefined
gap前缀、主内容及标题右侧区域之间的间距string / number-12
contentGap标题、副标题、正文及操作项之间的间距string / number-4
align前缀与主内容在交叉轴上的对齐方式stringstart / center / end / stretchcenter
background根节点 CSS 背景,支持纯色、线性渐变和径向渐变string合法 CSS background''
hoverBackground可点击状态的悬停背景;未设置时沿用 backgroundstring合法 CSS background''
border显示默认边框或传入完整 CSS border;传 false 可关闭边框boolean / stringtrue / false / CSS bordertrue
borderRadius圆角,数字按 px 处理string / number-''
divider是否显示底部分割线booleantrue / falsefalse
titleLines标题最大行数,0 表示不限制number0 / 正整数1
subTitleLines副标题最大行数,0 表示不限制number0 / 正整数1
extraPlacementextra / actions 的布局位置stringheader / side / bottomheader
extraAlignside 布局下扩展区域的垂直对齐方式stringstart / center / end / stretchcenter
styles各语义区域的内联样式SItemStyles见“语义样式区域”undefined
clickable是否显示点击交互,并支持 Enter / Space 键盘触发booleantrue / falsefalse
disabled是否禁用点击booleantrue / falsefalse
theme主题样式stringdefault / chenghua / shijingshan / sybzdefault
shadow阴影显示时机stringalways / never / hovernever
hoverAnimation悬停时是否上移动画booleantrue / falsefalse

语义样式区域

styles 支持 root / row / main / prefix / content / header / title / subTitle / body / extra / actions。其中 root 的优先级高于同名外观属性;extraside / bottom 布局下会覆盖完整的独立区域。

事件

事件名说明参数
click点击信息项时触发;disabled 时不触发(event: MouseEvent)

插槽

插槽名说明
prefix左侧图片、图标或头像
title自定义标题
subTitle自定义副标题
extra自定义扩展区域内容
actions自定义扩展区域操作
default标题和副标题下方的扩展内容

说明

  • padding 优先于 size;数字会转换成像素值,字符串可传 12px 20px 等完整 CSS 内边距。
  • small / default / large 对应内边距默认值分别为 8px / 16px / 24px
  • extraPlacement="side" 时,扩展区域是主内容的兄弟节点,因此设置背景或左边框会覆盖完整高度。
  • 原生 class / style 会继续作用于根节点;复杂定制优先使用 styles,避免依赖组件内部 DOM 层级。

思云博智私有前端组件库