littlebot
Published on 2025-04-03 / 0 Visits
0

【源码】基于Ruby on Rails框架的中国省市区街道级联选择器

项目简介

本项目是基于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::Engineruby 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】