README

MagicSuggest v2.1.7 更新了已弃用的 jQuery 方法

• (修复) 更新了已弃用的 jQuery 方法，如 trim()、$.isArray 和 Proxy()。
• (更新) 它们被原生 JavaScript 替代。
• (修复) jQuery 方法 each() 也被可能的原生 JavaScript forEach() 替换。

MagicSuggest v2.1.6 错误修复

• (修复) 禁止在输入上执行任意 HTML 和 SCRIPT。

MagicSuggest v2.1.5

• (修复) 预先添加关闭按钮而不是附加它
• (修复) 更新了 magicsuggest-min.js 以包含当前的 master 代码
• (特性) 动态更新最大选择大小

MagicSuggest v2.0.0

MagicSuggest 的新家在这里： http://nicolasbize.com/magicsuggest/ 包括全新的 API 文档、示例、教程等！

里程碑变更日志

MagicSuggest v.2.0.0

• 新家位于 http://nicolasbize.com/magicsuggest/ 以运行 gh-pages 无法处理的动态示例
• 现在支持 Bootstrap 3（必需）
• 响应式设计
• 不再有侵入性加载

v1.3.1 错误修复！（次要标记里程碑 - 2013年8月17日）

• (修复) 启用后禁用现在正常工作（归功于 amanokerim - https://github.com/amanokerim）
• (修复) 触发图标现在占满整个高度（归功于 DioVayne - https://github.com/DioVayne）
• (修复) 清除现在与 isSilent 兼容（归功于 Coywolf - https://github.com/Coywolf）
• (修复) 1.3.0 破坏了groupBy
• (特性) 与最新的 jQuery 1.10.2 兼容（归功于 RafaelMalgor - https://github.com/RafaelMalgor）
• (特性) 结果 JSON 对象现在可以有自定义结果属性 resultsField（归功于 RafaelMalgor - https://github.com/RafaelMalgor）

v1.3.0 一些更多特性和错误修复（次要标记里程碑 - 2013年5月25日）

• (特性) 组合组件现在可以通过同一个 div 元素获取（归功于 meghuizen - https://github.com/meghuizen）
• (修复) CSS 错误与 1.2.7+ 的 triggerHidden（归功于 ScullWM - https://github.com/ScullWM）
• (修复) 即使加载了大量数据，容器也会始终渲染为 1 行（归功于 travishaagen - https://github.com/travishaagen）
• (特性) 添加了最低 jQuery 版本以在文档中工作（归功于 rajeshmeniya - https://github.com/rajeshmeniya）
• (修复) 输入没有被正确地启用/禁用（归功于 zerekw - https://github.com/zerekw）
• (特性) 添加了 getName 和 setName 以轻松获取/设置组件的表单名称（归功于 jbmoens - https://github.com/jbmoens）
• (修复) 当在 DOM 原始元素中指定值时，它被正确地传递给 MS。（归功于 jbmoens - https://github.com/jbmoens）
• (修复) 输入空间现在始终使用剩余空间，这导致问题更少。
• (特性) 现在使用单选组合框时，组合框有更多的逻辑。
• (修复) 在小组合框中进行单选时，占用的空间保持在同一行。(感谢 ScullWM - https://github.com/ScullWM)
• (特性) 现在可以通过 Ctrl 键选择多个项目。(感谢 meghuizen - https://github.com/meghuizen)
• (特性) 触发图标现在使用纯 CSS。(感谢 meghuizen - https://github.com/meghuizen)
• (特性) cfg(data) 现在可以接受一个函数作为参数。(感谢 meghuizen - https://github.com/meghuizen)
• (特性) cfg(data) 现在可以接受一个 json 对象，其数据项位于 results 属性中
• (修复) CSS 已修复，使其在 bootstrap 模态框中表现正确。(感谢 daenuprobst - https://github.com/daenuprobst)
• (特性) 通过减少绘制调用到一个，优化了建议渲染。(感谢 meghuizen - https://github.com/meghuizen)
• (修复) 当组合框禁用时，现在不能再移除标签。(感谢 grena - https://github.com/grena)
• (修复) 设置数据只通过可见的建议集合进行。(感谢 grena - https://github.com/grena)
• (修复) 缺少分号，通过了完整的 jslint 检查。(感谢 grena - https://github.com/grena)
• (修复) 当 maxSuggestions 设置为 10 时，建议没有出现。(感谢 zerekw - https://github.com/zerekw 和 plasmaxy - https://github.com/plasmaxy)
• (修复) 清除函数已损坏。(感谢 travishaagen - https://github.com/travishaagen)
• (特性) 现在可以完全从 DOM 容器元素设置组件的配置。
• (特性) 添加了静默模式到选择更改方法，以确定是否是用户触发的。(感谢 travishaagen - https://github.com/travishaagen)
• (特性) 添加了 setData(object) 方法，以便在组合框渲染后填充它。(感谢 travishaagen - https://github.com/travishaagen)
• (修复) 当用户输入速度超过 typeDelay 时，ajax 查询被发送了两次。(感谢 arvenom - https://github.com/arvenom)
• (修复) 使用自定义渲染时，搜索结果的高亮也高亮了 HTML 标签。(感谢 pstuart2 - https://github.com/pstuart2)
• (特性) 添加了 cfg(strictSuggest)，用户可以选择建议的方式。
• (特性) 添加了 cfg(toggleOnClick)，用户可以通过点击它来展开/关闭组合框。(感谢 psulek - https://github.com/psulek)
• (修复) 当执行初始 ajax 调用时的空建议文本被错误触发。(感谢 curtgrimes - https://github.com/curtgrimes)
• (特性) 添加了 cfg(selectionRenderer) (感谢 pstuart2 - https://github.com/pstuart2)
• (修复) 空文本类未正确触发 (感谢 jods4 - https://github.com/jods4)
• (修复) IE8 兼容性 (感谢 Airborn22 - https://github.com/Airborn22)
• (特性) MagicSuggest 现在可以从 select dom 组件渲染。 (感谢 Yogu - https://github.com/Yogu)
• (特性) 当允许自由条目时，在失去焦点时现在会自动将输入的文本添加到选择中 (感谢 Airborn22 - https://github.com/Airborn22)
• (特性) 新增 public 方法 empty()，用于清除用户文本。
• (修复) 确保在触发加载事件之前组合框已被填充
• (特性) 重命名了一些事件以提高可读性

v1.2.0 在 jQuery 插件上的标准化 (小型里程碑 - 2013年3月4日)

• (修复) 修复了禁用时的行为，当可以编辑 emptyText 时
• (修复) collapse 方法会抛出错误
• (配置) typeDelay: 键盘按键之间的时间间隔（毫秒）（感谢 jayesbee - https://github.com/jayesbee)
• (特性) 标准化 jQuery 插件 (感谢 jayesbee - https://github.com/jayesbee)
• (特性) 添加了文档示例
• (配置) name: 用于 magicsuggest 的表单元素名称（感谢 iambibhas - https://github.com/iambibhas)
• (修复) 当值以文本形式渲染时启动渲染
• (配置) dataParams: Ajax 请求的附加参数（感谢 jayesbee - https://github.com/jayesbee)
• (修复) 与内部文本相关的其他渲染问题

v1.1.0 众多增强和错误修复 (小型里程碑 - 2013年2月19日)

• (特性) 关闭交叉样式现在融入得更多
• (特性) 按下 Esc 键现在会折叠组合框（不会失去焦点）
• (修复) 无法输入由空格组成的条目
• (配置) noSuggestionText: 当没有给定数据时显示的文本
• (配置) minCharsRenderer: 允许自定义未输入足够字符时显示的消息
• (配置) maxEntryRenderer: 允许自定义输入字符过多时显示的消息
• (配置) maxEntryLength: 限制用户输入的字符数
• (配置) style: 应用到主要容器的自定义样式
• (配置) infoMsgCls: 应用到辅助元素的自定义类
• (特性) 新的辅助消息在右上角，用于通知组件状态
• (配置) id: 允许为组件提供一个自定义 ID
• (配置) inputCfg: 允许将附加参数传递给 INPUT 标签。例如，启用 AngularJS 的自定义标签
• (配置) renderer: 允许在组合框内进行自定义渲染
• (配置) groupBy: 允许在组合框列表中进行分组
• (修复) 当从组合框中选择元素时，blur 事件现在正确注册
• (修复) 当在 IE 中悬停在触发器上时会出现闪烁
• (配置) strictSuggest: 设置建议的提出方式
• (修复) maxResults 现在正确解释
• (修复) maxSelection 现在正确解释
• (配置) method: 设置 Ajax 方法，默认为 'POST'
• (特性) Ajax 请求现在可以解释来自服务器的多个结果
• (修复) 当点击页面时触发的 blur 事件的问题
• (配置) required: 当未填写时触发无效/有效事件
• (特性) 通过 isValid() 方法进行验证

v1.0. 初始组件发布

• 选择是否允许自由条目
• 键盘管理
• 主题能力
• 静态和动态数据处理
• 定位