Skip to content

时间线组件 1

StTimeline1 为时间线组件 1,StTimelineItem1 为时间线组件 1 的子组件,即时间线数据项展示组件。

组件参数

StTimeline1

参数名说明类型默认值
initialIndex初始展示的时间线数据项的索引number0
enableMousewheelSwitch是否开启鼠标滚轮切换时间线数据项booleantrue
speed时间线数据项切换过渡的速度,即切换时间线数据项时,过渡动画执行所需的时间,单位为毫秒number1500
transitionFun时间线数据项切换的过渡效果string'cubic-bezier(.68, -0.55, .26, 1.55)'
transitionDelay时间线数据项切换过渡动画的执行延迟,如果传入的是数字,则单位默认为毫秒number | string0
background组件的背景,注意,该参数的参数值会直接赋值给组件根元素的 background CSS 属性string'transparent'
timelineData组件右边或下面的时间线数据项,此参数为必填项string[]
timelinePerView组件右边的时间线数据项的展示个数number1
timelinePerViewReactScreen组件下边的时间线数据项的展示个数,即组件在响应式变换后的小屏幕宽度下的时间线数据项的展示个数number1
needReactScreenWidth需要响应式变化的小屏幕宽度界限,即浏览器可视窗口的宽度小于对于何值时,为小屏幕下的响应式布局number600
timelineOffset组件右边或下面的时间线开头和末尾的偏移量numberundefined
timelineColor组件右边或下面的时间线未激活项的颜色string'#9c9c9c9f'
timelineColorActive组件右边或下面的时间线激活项的颜色string'#efefef'
timelineTextMaxLine组件右边或下面的时间线每项文本最多显示行数number1
timelineSpeed组件右边或下面的时间线切换过渡效果的时长,单位为毫秒number1200
timelineTransitionFun组件右边或下面的时间线切换的过渡效果string'cubic-bezier(.68, -0.55, .26, 1.55)'
timelineTransitionDelay组件右边或下面的时间线切换过渡效果执行延迟,如果传入的是数字,则单位默认为毫秒number | string300
enableTimelineNav是否显示组件右边或下面的时间线区域的上一项或下一项的导航按钮booleantrue

StTimelineItem1

参数名说明类型默认值
idx当前时间线展示数据项的索引,或者说是 for 循环中当前组件的索引,此参数为必填项number
bgImgSrc组件的背景图片资源地址字符串string''
title标题string''
desc描述文本string''
color组件中的文字的颜色string'#efefef'
animationSpeed标题和描述文本的动画效果的执行时长,如果传入的是数字,则单位默认为毫秒number | string500
titleEnterDelay标题出现动画的执行延迟,如果传入的是数字,则单位默认为毫秒number | string1500
descEnterDelay描述文本出现动画的执行延迟,如果传入的是数字,则单位默认为毫秒number | string1700
titleMaxLine标题文本最多显示行数,超出此行数的文本会以省略号显示number1
descMaxLine描述文本最多显示行数,超出此行数的文本会以省略号显示number5

组件插槽

StTimeline1

插槽名说明
default时间线数据展示项组件的放置区域,即 StTimelineItem1 组件的放置位置

StTimelineItem1

插槽名说明插槽上绑定的参数
suffix时间线数据展示项组件中标题和描述文本下面的后缀内容1. isInitial:时间线组件是否初始状态;
2. isChange:当前是否为切换时间线数据展示项的状态;
3. enterIdx:接下来要进入浏览器可视区域的时间线数据展示项的索引;
4. leaveIdx:接下来要离开浏览器可视区域的时间线数据展示项的索引;
5. currentIdx:当前展示在浏览器可视区域的时间线数据展示项的索引

向子组件提供的状态

在子组件中,可以通过 inject API 注入父组件中通过 provide API 通过的状态。

StTimeline1

状态名说明
isReact当前组件是否响应式变化,以适应在小屏幕下展示时间线数据