# @danielfarrell/bootstrap-combobox 中文文档

规范地址：https://npmcn.com/package/%40danielfarrell/bootstrap-combobox/

版本：1\.1\.8
npm 元数据更新时间：2022-06-12T16:51:52.043Z
中文译文更新时间：2026-11-11T10:19:32.526Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40danielfarrell/bootstrap-combobox
原文对照：https://npmcn.com/package/%40danielfarrell/bootstrap-combobox/?lang=original
项目主页：https://github.com/danielfarrell/bootstrap-combobox#readme
源码仓库：https://github.com/danielfarrell/bootstrap-combobox

## 关键信息（来自 npm 元数据）

- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2017-03-19T15:12:26.281Z
- 最新版本发布：2017-03-19T15:12:26.281Z
- 近 30 天下载量：6007（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：1（近 12 个月 0 个）

## 中文简介

使用 twitter 拖带的组合框插件Name

## 安装

```sh
npm install @danielfarrell/bootstrap-combobox
```

也可以使用：`pnpm add @danielfarrell/bootstrap-combobox`、`yarn add @danielfarrell/bootstrap-combobox`、`bun add @danielfarrell/bootstrap-combobox`

## README

# 套接字组合

我们在工作时需要一个组合箱 在仔细观察了所有的选择之后 我对其中任何一个都不满意 这个项目的造型都建立在Twitter的"靴子"上, 以此为基础.

## 如何安装

您可以安装此插件 .

#### 1\. 手工下载

以前,这是安装插件的唯一方法. 您需要包含在 HTML 中的两个文件才能工作 :

1.  js/bootstrap-combobox.js (英语)
2.  css/bootstrap-combobox.css (中文(简体) )

#### 2\. 鲍尔安装

此插件现在已装入弓形! 如果你已经安装在机器上,只需使用命令:

```
bower install bootstrap-combobox
```

这将将插件安装到您的 bower 组件文件夹 。 详情请查阅 [http://bower.io/ (中文(简体) )](http://bower.io/)

## 怎样用

依赖性是靴子样式表(CSS或LESS). 包含它,然后是样式表( CSS 或 LESS) 和 javascript .

然后在普通选择框上激活插件( 建议先有空白选项):

```
<select class="combobox">
  <option></option>
  <option value="PA">Pennsylvania</option>
  <option value="CT">Connecticut</option>
  <option value="NY">New York</option>
  <option value="MD">Maryland</option>
  <option value="VA">Virginia</option>
</select>

<script type="text/javascript">
  $(document).ready(function(){
    $('.combobox').combobox();
  });
</script>
```

### 选项

启动插件时,您可能包含包含组合框选项的对象

```
$('.combobox').combobox({bsVersion: '2'});
```

`menu`: 自定义下拉菜单列表元素的标记.

`item`: 自定义下拉菜单列表项的标记.

`matcher`: 自定义一个函数 `item` 参数,将项目与输入进行比较。 在查询中默认匹配为项目的子字符串, 大小写提示

`sorter`: 自定义排序列表的函数 `items` 在下拉时显示

`highlighter`: 自定义用于突出显示的函数 `item`。默认在匹配的项目中粗体显示查询

`template`: 返回组合框标记的自定义函数.

`bsVersion`: 正在使用的靴子套版本。 默认使用此选项 `template` 函数生成正确的标记。 默认为"3". 设定为“ 2 ” , 用于兼容 Bootstrap 2

`appendId`: 已变换组合框所期望的ID. 这将变成 id attr , 并可以被映射到使用属性的标签 。 有用于无障碍.

## 依赖关系

使用最新1.X版本的jQuery和最新2.X或3.X的靴子套.

## 生活实例

### Bootstrap 2.0 版本 :

[http://dl.tropbox.com/u/21368/bootstrap-combobox/index.html 互联网档案馆的存檔,存档日期2014-12-21](http://dl.dropbox.com/u/21368/bootstrap-combobox/index.html)

### 脚步陷阱 3.0 版本

[http://bootstrap-combobox-test.herokuapp.com/ 互联网档案馆的存檔,存档日期2013-12-22](http://bootstrap-combobox-test.herokuapp.com/)

## 许可证

根据Apache 许可证颁发的许可证,2.0版本

## 常见问题

### @danielfarrell/bootstrap-combobox 是什么？

使用 twitter 拖带的组合框插件Name

### 如何安装 @danielfarrell/bootstrap-combobox？

在项目目录运行 npm install @danielfarrell/bootstrap-combobox，或使用 pnpm add / yarn add / bun add。

### @danielfarrell/bootstrap-combobox 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/danielfarrell\_\_bootstrap-combobox 是否存在。

### @danielfarrell/bootstrap-combobox 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @danielfarrell/bootstrap-combobox 可以商用吗？

@danielfarrell/bootstrap-combobox 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @danielfarrell/bootstrap-combobox 的下载量有多少？

根据 npm 官方下载统计，@danielfarrell/bootstrap-combobox 在 2026/10/11 – 2026/11/09 这 30 天内被下载 6,007 次，日均约 200 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @danielfarrell/bootstrap-combobox 还在维护吗？

最新版本 1\.1\.8 发布于 2017/03/19（9 年前）；至今共发布 1 个版本，其中过去 12 个月发布了 0 个；首次发布于 2017/03/19。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。