通告栏 NoticeBar
用于循环播放展示一组消息通知,可设置横向滚动和纵向滚动
使用
API安装使用
import { TiNoticeBar } from '@titian-design/mobile-vue'
用法示例
基础用法
<template>
<TiNoticeBar content="内容文字" />
</template>
<script lang="ts" setup>
import { TiNoticeBar } from '@titian-design/mobile-vue';
</script>
纵向滚动
<template>
<TiNoticeBar content="['内容1', '内容2']" variant="vertical" />
</template>
<script lang="ts" setup>
import { TiNoticeBar } from '@titian-design/mobile-vue';
</script>
滚动速度
<template>
<TiNoticeBar content="内容文字" :speed="100" />
</template>
<script lang="ts" setup>
import { TiNoticeBar } from '@titian-design/mobile-vue';
</script>
内容超出后显示方式
属性含义:
auto
内容超出一行,variant为horizontal时,默认滚动播放;variant为vertical时截断。一般用于横向滚动。wrap
内容超出后换行,不可滚动。此模式为纯静态展示。ellipsis
内容超出一行缺省,一般用于纵向滚动。clip
内容超出一行截断,一般用于纵向滚动。
<template>
<TiNoticeBar content="内容文字" text-mode="auto" />
<TiNoticeBar content="内容文字" text-mode="wrap" />
<TiNoticeBar content="内容文字" text-mode="ellipsis" />
<TiNoticeBar content="内容文字" text-mode="clip" />
</template>
<script lang="ts" setup>
import { TiNoticeBar } from '@titian-design/mobile-vue';
</script>
TiNoticeBar API
属性 Properties
名称 | 类型 | 必填 | 默认值 | 说明 | 备注 |
---|---|---|---|---|---|
content | string | array | 是 | 否 | 展示内容,纵向滚动时传入array | - |
color | string | 否 | #fa2c19 | 文字颜色,背景色默认为文字颜色加 10%透明度 | - |
speed | number | 否 | 50 | 滚动速率 (px/s) | - |
variant | string | 否 | horizontal | 滚动方式,可选值horizontal vertical | - |
scrollable | boolean | 否 | false | 是否开启滚动播放,内容长度溢出时默认开启 | - |
left-icon | string | 否 | - | 左侧图标 | - |
right-icon | string | 否 | - | 右侧图标 | - |
text-mode | string | 否 | auto | 文本溢出样式,可选值auto wrap ellipsis clip | wrap 即文本溢出换行,此状态为禁止状态,不可滚动播放 |
ext-style | string | 否 | - | 根节点样式 | - |
事件 Events
名称 | 参数列表 | 描述 | 备注 |
---|---|---|---|
click | (e: Event) => void | 点击通知栏时触发 | - |
插槽 Slots
名称 | 说明 | 备注 |
---|---|---|
before | 内容左面的插槽 | - |
after | 内容右侧的插槽 | - |
外部样式类 External Classes
名称 | 说明 | 备注 |
---|---|---|
ext-class | 根节点样式类 | - |
CSS 变量 CSS Variable
变量 | 默认值 | 说明 | 备注 |
---|---|---|---|
--notice-bar-height | 72px | 通告栏高度 | - |
--notice-bar-color | rgba(250,44,25,1) | 通告栏文字颜色,默认跟随主题色 | - |
--notice-bar-background-color | rgba(250,44,25,0.1) | 通告栏背景色,默认跟随主题色加10%透明度 | - |
--notice-bar-padding-v | 16px | 通告栏垂直方向内边距 | textMode 为wrap 模式下有效 |
--notice-bar-padding-h | 28px | 通告栏水平方向内边距 | textMode 为wrap 模式下有效 |
--notice-bar-line-height | 40px | 通告栏文字行高 | textMode 为wrap 模式下有效 |