Chosen for Rails Asset Pipeline 技术文档
1. 安装指南
1.1 安装 chosen-rails
gem
首先,在 Rails 项目的 Gemfile
中添加 chosen-rails
gem:
gem 'jquery-rails'
gem 'chosen-rails'
然后运行以下命令安装依赖:
bundle install
1.2 关于 jQuery
你可以通过 jquery-rails
gem 获取 jQuery。如果你在 Rails 4 及以上版本中遇到 Turbolinks 问题,建议使用 jquery-turbolinks
。
2. 项目的使用说明
2.1 引入 Chosen 的 JavaScript 资源
在 app/assets/javascripts/application.js
文件中添加以下内容,以使用 jQuery 版本的 Chosen:
//= require jquery
//= require chosen-jquery
如果你使用 Prototype,可以添加以下内容:
//= require jquery
//= require chosen-prototype
2.2 引入 Chosen 的样式表资源
在 app/assets/stylesheets/application.css
文件中添加以下内容:
*= require chosen
2.3 启用 Chosen JavaScript
在 Rails 6 中,确保在 app/views/layouts/application.html.erb
文件中添加 javascript_include_tag
:
<%= javascript_include_tag 'application' %>
然后,在某个 CoffeeScript 文件中(例如 scaffold.js.coffee
)添加以下代码以启用 Chosen:
$ ->
# enable chosen js
$('.chosen-select').chosen
allow_single_deselect: true
no_results_text: 'No results matched'
width: '200px'
注意:从 Chosen 0.9.15
开始,width
选项是必需的。
确保该文件在 application.js
中被引入:
//= require chosen-jquery
//= require scaffold
2.4 在表单中使用 Chosen
在表单字段中添加 chosen-select
类:
<%= f.select :author,
User.all.map { |u| [u.name, u.id] },
{ include_blank: true },
{ class: 'chosen-select' }
%>
如果你使用 Simple Form 作为表单构建器:
<%= f.association :author,
collection: User.all,
include_blank: true,
input_html: { class: 'chosen-select' }
%>
3. 项目 API 使用文档
3.1 RSpec 辅助方法
chosen-rails
提供了 RSpec 功能辅助方法,允许用户从单选框或多选框中选择或取消选择选项。在 spec/rails_helper.rb
(或 spec/spec_helper.rb
)中添加以下内容:
require 'chosen-rails/rspec'
这将自动配置 RSpec,添加以下内容:
RSpec.configure do |config|
config.include Chosen::Rspec::FeatureHelpers, type: :feature
end
配置包括两个额外的辅助方法,适用于所有 type: :feature
的测试:
chosen_select(value, options = {})
chosen_unselect(value, options = {})
这两个方法都需要在 options
哈希中包含 from: '...'
,它可以是 CSS 选择器或字段的标签(需要标签上有 for
属性)。
3.2 示例用法
处理单选框:
chosen_select('Leo Tolstoy', from: 'Author')
chosen_unselect('Leo Tolstoy', from: '#author')
chosen_select('Fyodor Dostoyevsky', from: '#author')
处理多选框:
chosen_select('Leo Tolstoy', 'Fyodor Dostoyevsky', 'Anton Chekhov', from: 'Authors')
# 或者,单个值:
chosen_select('Leo Tolstoy', from: '#authors')
chosen_unselect('Fyodor Dostoyevsky', ' Anton Chekhov', from: 'Authors')
# 或者,单个值:
chosen_unselect('Leo Tolstoy', from: '#authors')
4. 项目安装方式
4.1 更新 Chosen 源文件
使用以下 Rake 命令更新 Chosen 源文件:
rake update-chosen
4.2 发布 gem
使用以下 Rake 命令发布 gem:
rake release
5. 许可证
chosen-rails
gem 使用 MIT 许可证。
- DDeepSeek-V3.1-TerminusDeepSeek-V3.1-Terminus是V3的更新版,修复语言问题,并优化了代码与搜索智能体性能。Python00
- QQwen3-Omni-30B-A3B-InstructQwen3-Omni是多语言全模态模型,原生支持文本、图像、音视频输入,并实时生成语音。00
GitCode-文心大模型-智源研究院AI应用开发大赛
GitCode&文心大模型&智源研究院强强联合,发起的AI应用开发大赛;总奖池8W,单人最高可得价值3W奖励。快来参加吧~0267cinatra
c++20实现的跨平台、header only、跨平台的高性能http库。C++00AI内容魔方
AI内容专区,汇集全球AI开源项目,集结模块、可组合的内容,致力于分享、交流。02- HHunyuan-MT-7B腾讯混元翻译模型主要支持33种语言间的互译,包括中国五种少数民族语言。00
GOT-OCR-2.0-hf
阶跃星辰StepFun推出的GOT-OCR-2.0-hf是一款强大的多语言OCR开源模型,支持从普通文档到复杂场景的文字识别。它能精准处理表格、图表、数学公式、几何图形甚至乐谱等特殊内容,输出结果可通过第三方工具渲染成多种格式。模型支持1024×1024高分辨率输入,具备多页批量处理、动态分块识别和交互式区域选择等创新功能,用户可通过坐标或颜色指定识别区域。基于Apache 2.0协议开源,提供Hugging Face演示和完整代码,适用于学术研究到工业应用的广泛场景,为OCR领域带来突破性解决方案。00- HHowToCook程序员在家做饭方法指南。Programmer's guide about how to cook at home (Chinese only).Dockerfile06
- PpathwayPathway is an open framework for high-throughput and low-latency real-time data processing.Python00
热门内容推荐
最新内容推荐
项目优选









