• Alert
    • 安装
    • 属性
    • 事件
    • 插槽
    • 相关 issue
    • 贡献者
    • 发布日志

    Alert

    Alert

    demo 原始链接demo 源码编辑文档组件源码

    alert - 图1

    二维码

    alert - 图2

    Install

    安装

    局部注册

    全局注册

    1. import { Alert } from 'vux'
    2. export default {
    3. components: {
    4. Alert
    5. }
    6. }

    1. // 在入口文件全局引入
    2. import Vue from 'vue'
    3. import { Alert } from 'vux'
    4. Vue.component('alert', Alert)

    该组件支持以plugin形式调用:

    以插件形式调用时,和template中使用不同,属性名请使用小驼峰式,比如buttonText而不是button-text。在 ViewBox 或者 overflow-scrolling:touch 的容器中使用时,请使用 prop:transfer-dom 来解决其引起的 z-index 失效问题。详细参考 demo。

    1. import { AlertPlugin } from 'vux'
    2. Vue.use(AlertPlugin)
    3. // 或者umd方式
    4. // 引入构建的js文件
    5. Vue.use(vuxAlertPlugin)
    1. // 显示
    2. this.$vux.alert.show({
    3. title: 'Vux is Cool',
    4. content: 'Do you agree?',
    5. onShow () {
    6. console.log('Plugin: I\'m showing')
    7. },
    8. onHide () {
    9. console.log('Plugin: I\'m hiding')
    10. }
    11. })
    12. // 隐藏
    13. this.$vux.alert.hide()
    14. // 获取显示状态
    15. this.$vux.alert.isVisible() // v2.9.1 支持

    如果你想实现在vue-routerbeforeEach或者afterEach的 hook 里关闭,可以使用 Vue.$vux.alert.hide()

    该组件在 v2.7.2 以上支持单独调用,方法和插件使用一致。

    1. import { AlertModule } from 'vux'
    2. AlertModule.show({
    3. title: 'VUX is Cool',
    4. content: this.$t('Do you agree?'),
    5. onShow () {
    6. console.log('Module: I\'m showing')
    7. },
    8. onHide () {
    9. console.log('Module: I\'m hiding now')
    10. }
    11. })

    API

    属性

    名字类型默认值说明版本要求
    valuebooleanfalse是否显示, 使用 v-model 绑定变量
    titlestring弹窗标题
    contentstring提示内容,作为 slot:default 的默认内容,如果使用 slot:default, 将会失效v2.2.0
    button-textstringok(确定)按钮文字
    hide-on-blurbooleanfalse是否在点击遮罩时自动关闭弹窗
    mask-transitionstringvux-fade遮罩动画
    dialog-transitionstringvux-dialog弹窗主体动画
    mask-z-indexnumber string1000遮罩层 z-index 值v2.6.4

    事件

    名字参数说明版本要求
    @on-show弹窗显示时触发
    @on-hide弹窗关闭时触发

    插槽

    名字说明版本要求
    默认插槽提示内容

    Issues

    相关 issue

    • #2795 [Bug Report] alert弹窗需提供单独的点击事件,而非on-hide事件
    • #2640 请问Alert组件有没有支持定制样式的计划?
    • #2173 怎样在actions文件中直接引入 alert 插件使用,除了通过传递组件 this 参数方式外(类似于 mint-ui 的 MessageBox.alert() 方式)
    • #2060 建议alert、confirm插件返回promise
    • #2025 以插件形式调用alert和confirm,如果未点击确认或者取消,返回后弹框依然会存在
    • #1826 alert组件点击确定没有可执行的回调函数
    • #1742 Alert组件支持hideOnBlur,Comfirm原本支持hideOnBlur,更新文档
    • #1729 Alert组件的弹出位置
    • #1330 main.js 直接调用组件
    • #1285 vux弹出的alert不能用回车或者空格来关闭

    贡献者

    贡献者

    该组件(包含文档)迭代次数 29,贡献人数 3
    airylandFisherLin Sen

    Changelog

    发布日志

    • v2.9.1 [feature] 添加 isVisible 获取当前显示状态 #2704
    • v2.7.2 [feature] 支持作为模块直接调用 (import { AlertModule } from 'vux') #2173
    • v2.6.4 [feature] 支持属性 mask-z-index 设置遮罩 z-index
    • v2.5.5 [feature] 支持 hideOnBlur #1742
    • v2.2.0 [feature] 添加属性 prop:content
    • v2.1.1-rc.11 [enhance] 作为插件使用时,每次都重置属性值
    • v2.1.1-rc.9 [fix] 修正 onHide 回调被错误调用 #1023 @jsonviewer
    • v2.0.0 [change] 使用 v-model 而不是:show.sync进行显示属性绑定
    • v2.0.0 [todo] 修复动画