npm 包 @pile-ui/condition 使用教程

阅读时长 7 分钟读完

在前端开发中,我们经常需要对数据进行筛选、排序等操作。@pile-ui/condition 是一款可以帮助我们快速生成筛选、排序等功能的组件库,使用简便,功能强大。

安装

在使用 @pile-ui/condition 之前,我们需要安装它。使用 npm 安装:

使用

在项目中引入组件:

配置 Condition:

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

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

这个例子中我们创建了三个条件:一个输入框、一个滑动条和一个下拉框。在 Condition 组件中,我们绑定了三个事件:onChange,onReset 和 onSubmit。这些事件将在我们改变条件时触发,可以在这里加入我们的筛选、排序等逻辑。

配置项

在 Condition 中,我们可以定义不同的条件,并选择不同的类型。

  • id - 条件的 ID,可以是任何字符串。这个 ID 将在我们获取条件的值时使用。

  • label - 条件的标签,在表单控件前展示。

  • type - 表单控件的类型。支持以下几种类型:

    • text - 文本输入框。
    • number - 数字输入框。
    • date - 日期选择器。
    • select - 下拉框选择器。
    • radio - 单选框。
    • checkbox - 复选框。
    • slider - 滑动条。
  • config - 表单控件的配置项。不同类型的表单控件支持不同的配置。示例:

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

    在这个例子中,我们配置了一个滑动条,可以设置最小值和最大值。

  • defaultValue - 表单控件的默认值。

事件

在 Condition 中,我们支持三个事件:

  • onChange - 条件变化时触发。返回一个对象,包含当前所有条件的值。
  • onReset - 重置按钮被点击时触发。
  • onSubmit - 提交按钮被点击时触发。

实例

下面是一个使用 Condition 的实例。在这个实例中,我们使用 @ant-design/icons 和 styled-components 来给条件卡片加上图标,并使用 console.log 显示当前条件的值。

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

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

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

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

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

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

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

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

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

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

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

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

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

结语

@pile-ui/condition 是一款功能强大、易于使用的组件库,可以帮助我们快速实现各种数据筛选、排序等功能。学习并使用它们将大大提高我们的开发效率。

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

纠错
反馈