项目简介
本项目是基于Ruby on Rails框架开发的插件,为Rails项目提供省市区街道四级(或三级、二级)选择框功能,主要用于收集收货地址等信息。数据源自国家统计局和淘宝,支持省市区街道的级联选择。
项目的主要特性和功能
- 级联选择功能:支持省、市、区、街道的级联选择,用户选择省份后可动态加载对应城市、区域和街道。
- 数据来源可靠:省市区数据源于国家统计局,街道数据来自淘宝,保证数据准确及时。
- 易于集成:提供基于Rails的Engine,便于开发者快速集成到现有Rails项目。
- API支持:提供JavaScript和Ruby的API,方便前后端获取城市信息。
- 测试框架:内置基于RSpec的测试框架,确保代码质量和功能正确性。
安装使用步骤
引入Gem
在项目的Gemfile
中添加以下代码:
ruby
gem 'clwy_china_city'
引入JavaScript文件
在app/assets/javascripts/application.js
中添加以下代码:
javascript
//= require 'jquery'
//= require 'clwy_china_city/jquery.clwy_china_city'
挂载Engine
在config/routes.rb
中挂载ClwyChinaCity::Engine
:
ruby
mount ClwyChinaCity::Engine => '/clwy_china_city'
在页面中使用选择框
在页面中添加以下代码(示例使用slim格式):
ruby
.city-group
select.city-select
option --省份--
= options_for_select(ClwyChinaCity.list)
select.city-select
option --城市--
select.city-select
option --地区--
select.city-select
option --街道--
确保所有选择框都包含city-select
类,并都在city-group
的DOM元素下。
获取城市名称
可以通过调用ClwyChinaCity.get('440300')
将城市代码转换为城市名称。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】