Skip to content

NoticeBar 通知栏

基本用法

设置 text 文本内容和 prefix 左侧图标。

html
<wd-notice-bar text="这是一条消息提示信息,这是一条消息提示信息,这是一条消息提示信息" prefix="warn-bold" />

类型修改

设置 type 可修改通知类型,通知类型共有三种 info|warning|danger,默认值为warning

html
<wd-notice-bar text="这是一条消息提示信息,这是一条消息提示信息,这是一条消息提示信息" prefix="warn-bold" custom-class="space" />
<wd-notice-bar text="这是一条消息提示信息,这是一条消息提示信息,这是一条消息提示信息" prefix="check-outline" type="info" custom-class="space" />
<wd-notice-bar text="这是一条消息提示信息,这是一条消息提示信息,这是一条消息提示信息" prefix="wifi-error" type="danger" />
scss
:deep(.space) {
  margin-bottom: 10px;
}

插槽演示

html
<wd-notice-bar>
  <template #prefix>
    <wd-icon class="prefix" name="warn-bold">占位符</wd-icon>
  </template>
  通知被禁或时段内消息屏蔽可能造成消…
  <template #suffix>
    <div style="color: #4d80f0">查看</div>
  </template>
</wd-notice-bar>
scss
:deep(.prefix) {
  font-size: 18px;
  padding-right: 4px;
  width: 18px;
  height: 18px;
}

多行展示

设置 wrapable 属性为 true 且同时禁止滚动 scrollable 即可开启多行展示。

html
<wd-notice-bar text="这是一条消息提示信息,这是一条消息提示信息,这是一条消息提示信息" wrapable :scrollable="false" />

可关闭的

设置 closable 属性,使通知栏可以关闭。

html
<wd-notice-bar text="这是一条消息提示信息,这是一条消息提示信息,这是一条消息提示信息" closable />

自定义颜色

设置 color 修改文字和图标颜色,设置 background-color 修改背景颜色。

html
<wd-notice-bar
  text="这是一条消息提示信息,这是一条消息提示信息,这是一条消息提示信息"
  prefix="check-outline"
  closable
  color="#34D19D"
  background-color="#f0f9eb"
/>

多文本轮播

将一个string[]传递给text属性,即可开启多文本轮播,并且会在展示下一条文本时触发next事件,该事件接收一个number参数,代表的是当前展示的文本数组索引

html
<wd-notice-bar :text="textArray" prefix="check-outline" @next="onNext" />
javascript
import { ref } from 'vue'

const textArray = ref([
  '欢迎使用wot design uni',
  '该组件库基于uniapp ->Vue3, ts构建',
  '项目地址:https://github.com/Moonofweisheng/wot-design-uni',
  '我们的目标是打造最强uniapp组件库',
  '诚挚邀请大家共同建设',
  '这是一条消息提示信息,这是一条消息提示信息,这是一条消息提示信息,这是一条消息提示信息,这是一条消息提示信息'
])

const onNext = (index: number) => {
  console.log('展示下一条,index: ', index)
  console.log('文本是:' + textArray.value[index])
}

垂直滚动

  1. direction传递vertical即可开启垂直滚动,目前仅支持一个方向的垂直滚动
  2. text为数组时才会进行滚动
html
<wd-notice-bar prefix="warn-bold" direction="vertical" :text="textArray" :speed="0.5" :delay="3" custom-class="space" />
<wd-notice-bar prefix="warn-bold" direction="vertical" text="只有一条消息不会滚动" :speed="0.5" :delay="3" custom-class="space" />

Attributes

参数说明类型可选值默认值最低版本
text设置通知栏文案string string[]---
type设置通知栏类型stringinfo / warning / dangerwarning-
prefix设置左侧图标,使用 icon 章节中的图标名string---
scrollable是否可以滚动boolean-true-
delay滚动动画初始延时,单位 秒(s)number-1-
speed滚动速度,单位 px/snumber-50-
closable是否可以关闭boolean-false-
wrapable是否换行展示boolean-false-
color文字、图标颜色string---
background-color背景颜色string---
direction滚动方向NoticeBarScrollDirectionhorizontal verticalhorizontal-

Events

事件名称说明参数最低版本
close关闭按钮点击时--
next下一次滚动前触发index: number-
click点击时触发{ text: string, index: number },其中text为当前文本,index为当前文本索引1.2.16

Slot

name说明类型最低版本
prefix前置图标--
suffix后置插槽--
default通知文本内容--

外部样式类

类名说明最低版本
custom-class根节点样式-

Released under the MIT License.

Released under the MIT License.