ng2-select

Angular based replacement for select boxes

  • 所有者: valor-software/ng2-select
  • 平台:
  • 许可证: MIT License
  • 分类:
  • 主题:
  • 喜欢:
    0
      比较:

Github星跟踪图

Native UI Select Angular component (demo)

ng2-select npm version npm downloadsslack

Angular 2 Style Guide
Build Status

Quick start

  1. A recommended way to install ng2-select is through npm package manager using the following command:

npm i ng2-select --save

  1. Include ng2-select.css in your project

  2. More information regarding of using ng2-select is located in
    demo and demo sources.

API

Properties

  • items - (Array<any>) - Array of items from which to select. Should be an array of objects with id and text properties.
    As convenience, you may also pass an array of strings, in which case the same string is used for both the ID and the text.
    Items may be nested by adding a children property to any item, whose value should be another array of items. Items that have children may omit having an ID.
    If items are specified, all items are expected to be available locally and all selection operations operate on this local array only.
    If omitted, items are not available locally, and the query option should be provided to fetch data.
  • active (?Array<any>) - selection data to set. This should be an object with id and text properties in the case of input type 'Single',
    or an array of such objects otherwise. This option is mutually exclusive with value.
  • allowClear (?boolean=false) (not yet supported) - Set to true to allow the selection to be cleared. This option only applies to single-value inputs.
  • placeholder (?string='') - Placeholder text to display when the element has no focus and selected items.
  • disabled (?boolean=false) - When true, it specifies that the component should be disabled.
  • multiple - (?boolean=false) - Mode of this component. If set true user can select more than one option.
    This option only applies to single-value inputs, as multiple-value inputs don't have the search input in the dropdown to begin with.

Events

  • data - it fires during all events of this component; returns Array<any> - current selected data
  • selected - it fires after a new option selected; returns object with id and text properties that describes a new option.
  • removed - it fires after an option removed; returns object with id and text properties that describes a removed option.
  • typed - it fires after changing of search input; returns string with that value.

Troubleshooting

Please follow this guidelines when reporting bugs and feature requests:

  1. Use GitHub Issues board to report bugs and feature requests (not our email address)
  2. Please always write steps to reproduce the error. That way we can focus on fixing the bug, not scratching our heads trying to reproduce it.

Thanks for understanding!

License

The MIT License (see the LICENSE file for the full text)

主要指标

概览
名称与所有者valor-software/ng2-select
主编程语言TypeScript
编程语言TypeScript (语言数: 2)
平台
许可证MIT License
所有者活动
创建于2015-08-27 10:08:22
推送于2024-08-20 20:20:14
最后一次提交2016-04-20 16:19:56
发布数6
最新版本名称v2.0.0 (发布于 2017-11-23 14:02:57)
第一版名称v1.0.3 (发布于 2016-05-18 18:54:27)
用户参与
星数673
关注者数41
派生数579
提交数194
已启用问题?
问题数419
打开的问题数349
拉请求数95
打开的拉请求数52
关闭的拉请求数455
项目设置
已启用Wiki?
已存档?
是复刻?
已锁定?
是镜像?
是私有?