npm 包 bz-semantic-ui-modal 使用教程

阅读时长 6 分钟读完

介绍

bz-semantic-ui-modal 是基于 Semantic UI Modal 的一个 npm 包,专门用于在前端页面中生成弹窗。相比于原生 Semantic UI Modalbz-semantic-ui-modal 的使用更加简便,同时也支持更多的样式定制。

安装

使用 npm 安装 bz-semantic-ui-modal

使用

在需要使用弹窗的地方引入 bz-semantic-ui-modal

在模板中添加一个按钮,用于触发弹窗:

在 JavaScript 中创建一个实例,并设置相应的属性:

-- -------------------- ---- -------
----- ----- - --- -------------------
  --- ----------- -- --- --
  ------ ------- -- ----
  ------------ ------- -- ----
  -------- ------ -- ----
--

-- -----------
-------------------------------------------------------------- -------- -- -
  ------------
--

API

BzSemanticUiModal(options)

构造函数,用于创建弹窗实例。

参数
  • options {Object} 弹窗实例的选项
    • id {string} (default: '') 弹窗的 id
    • title {string} (default: '') 弹窗的标题
    • description {string} (default: '') 弹窗的描述
    • content {string} (default: '') 弹窗的内容
    • onShow {Function} (default: null) 弹窗显示时的回调函数
    • onHide {Function} (default: null) 弹窗隐藏时的回调函数
    • clazzNames {Object} (default: {}) 弹窗的样式定制
返回值

BzSemanticUiModal 实例

BzSemanticUiModal.show()

显示弹窗。

BzSemanticUiModal.hide()

隐藏弹窗。

样式定制

bz-semantic-ui-modal 的样式可以通过 ClassNames 定义。以下是可供定制的属性名称:

  • modalContainerClass
  • modalClass
  • headerClass
  • titleClass
  • descriptionClass
  • contentClass
  • actionsClass
  • okButtonClass
  • cancelButtonClass

示例:

-- -------------------- ---- -------
----- ----- - --- -------------------
  --- -----------
  ------ -------
  ------------ -------
  -------- -------
  ----------- -
    -------------------- ---------------------
    ----------- -----------
    ----------- -----------
    ------------- -------------
    -------------- ---------------
    ------------------ ------------------
  -
--

完整示例

以下是一个完整的示例,实现了自定义样式和回调函数:

-- -------------------- ---- -------
--------- -----
----- ----------
  ------
    ----- ----------------
    ---------- - -------------------- ------------
    ----- ---------------- ----------------------------------------------------------------------
  -------
  ------
    ------- ----------------------------
    ------- --------------
      ------ ----------------- ---- ----------------------

      ----- ----- - --- -------------------
        --- -----------
        ------ -------
        ------------ -------
        -------- -------
        ------- -------- -- -
          --------------------
        --
        ------- -------- -- -
          --------------------
        --
        ----------- -
          -------------------- ---------------------
          ----------- -----------
          ----------- -----------
          ------------- -------------
          -------------- ---------------
          ------------------ ------------------
        -
      --

      -------------------------------------------------------------- -------- -- -
        ------------
      --
    ---------
  -------
-------

总结

在前端开发中,弹窗是我们经常使用的组件之一。bz-semantic-ui-modal 提供了一种简单、灵活的实现方式,可以让我们快速构建弹窗,同时也支持样式的自定义定制。希望本文对大家有所帮助,欢迎大家使用和反馈。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60066c8fccdc64669dde5792

纠错
反馈