npm 包 @the-mx-group/ng-select 使用教程

阅读时长 4 分钟读完

前言

在前端开发过程中,有时候需要实现下拉选择框,这时你会发现 Angular 框架提供的 select 控件并不能满足特定需要。而 @the-mx-group/ng-select 包的出现,为我们提供了更为灵活、易用的下拉选择框组件。

安装和引用

在命令行中使用 npm 或 yarn 安装 @the-mx-group/ng-select 包:

或者

在模块中引用该包:

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

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

在模板中使用该组件:

API

Inputs

  • items: 必选项,下拉列表数据,
  • ngModel: 选中项绑定变量,
  • multiple: 是否支持多选,默认为 false,
  • bindLabel: 选择项用来展示的属性名,默认为 name,
  • searchFn: 自定义搜索函数,
  • placeholder: 未选择时显示的占位符,
  • clearable: 是否支持清空已选项,默认为 true,
  • searchable: 是否支持搜索,默认为 true,
  • addTag: 是否支持添加新选项,默认为 false,
  • loading: 是否显示加载中状态,
  • disabled: 是否禁用下拉选择框。

Outputs

  • change: 当选择项发生变化时触发的事件。

样式

该组件提供了默认样式,如果想要修改样式,可以使用以下类名:

  • .ng-select-container: 容器样式,
  • .ng-select-dropdown: 下拉框样式,
  • .ng-option: 选项样式,
  • .ng-option-selected: 选中项样式。

示例

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

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

结语

@the-mx-group/ng-select 包是一个非常好用的下拉选择框组件,它提供了丰富的 API 和默认样式,并支持自定义样式。希望本文能帮助读者更好地使用该组件,也希望读者在使用该组件时,能够充分发挥和挖掘该组件的潜力。

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

纠错
反馈