district_cn_selector 1.0.0

data/.gitignore

@@ -0,0 +1,27 @@
+# See http://help.github.com/ignore-files/ for more about ignoring files.
+#
+# If you find yourself ignoring temporary files generated by your text editor
+# or operating system, you probably want to add a global ignore instead:
+#   git config --global core.excludesfile ~/.gitignore_global
+
+# Ignore bundler config
+/.bundle
+
+# Ignore the default SQLite database.
+*.sqlite3
+
+# Ignore all logfiles and tempfiles.
+/log/*.log
+/tmp
+/public/assets
+/public/uploads
+/public/uploads/*.*
+/config/database.yml
+*.swp
+.DS_Store
+.DS_Store?
+Gemfile.lock
+/doc/TODO
+/spec/dummy/log/*.log
+/spec/dummy/tmp/
+/.idea

data/.rspec

@@ -0,0 +1 @@
+--drb  --color -f n

data/.travis.yml

@@ -0,0 +1,14 @@
+language: ruby
+
+before_install:
+  - gem install bundler
+
+gemfile:
+  - Gemfile
+
+rvm:
+  - 1.9.3
+  - 2.0.0
+
+script:
+  - bundle exec rake spec

data/Gemfile

@@ -0,0 +1,37 @@
+source 'http://ruby.taobao.org/'
+
+# Declare your gem's dependencies in area_select_cn.gemspec.
+# Bundler will treat runtime dependencies like base dependencies, and
+# development dependencies will be added by default to the :development group.
+gemspec
+
+# jquery-rails is used by the dummy application
+gem "sqlite3"
+group :development, :test do
+  gem "rspec-rails"
+  gem "capybara"
+  gem "capybara-webkit"
+  gem "factory_girl_rails"
+end
+
+gem 'therubyracer'
+gem 'uglifier', '>= 1.0.3'
+
+gem 'jquery-rails'
+gem 'sass-rails',   '~> 3.2.3'
+gem 'less-rails'
+gem 'bootstrap-sass'
+gem 'font-awesome-rails'
+gem 'simple_form'
+
+
+#gem 'select2-rails'
+#gem 'snap_js-rails'
+
+# Declare any dependencies that are still in development here instead of in
+# your gemspec. These might include edge Rails or gems from your path or
+# Git. Remember to move these dependencies to your gemspec before releasing
+# your gem to rubygems.org.
+
+# To use debugger
+# gem 'debugger'

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 kehao.qiu
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,138 @@
+[![Gem Version](https://badge.fury.io/rb/district_cn_selector.png)](http://badge.fury.io/rb/district_cn_selector)
+## 地区选择插件(测试中) 
+  三级联动地区选择器:
+
+  1. select-ul 模拟下拉菜单
+  2. select 下拉菜单(done,testing)
+
+## Example
+  [Online Demo](http://112.124.38.145:9292).
+
+##Features
+  1. 支持bootstrap  
+  2. 支持simple_form
+  3. 支持select和select-ul
+  4. 基于[district_cn](https://github.com/Kehao/district_cn),有一些实用的方法
+
+##Installation
+Add it to your Gemfile:
+```ruby
+gem 'district_cn_selector'
+```
+
+And then execute:
+```console
+bundle install
+```
+
+Add it to your application.js:
+
+```console
+// select
+//= require district_cn_selector/jquery.district
+// select-ul
+//= require district_cn_selector/jquery.district-ul
+```
+
+if you want to use the default theme, add it to your application.css:
+```console
+*= require  district_cn_selector/district-ul
+```
+
+## FormHelper
+###form_tag
+```erb
+
+<%= form_tag "" do %>
+<!-- select -->
+  <%= district_select(:company,:region_code,"331000") %>
+
+<!-- select-ul -->
+  <%= district_select_ul(:company,:region_code,"331000") %>
+<% end %>
+```
+
+###form_for
+```erb
+<%= form_for Company.new,:builder => DistrictCnSelector::Helpers::FormBuilder do |f| %>
+<!-- select -->
+  <%= f.district_select :region_code%>
+
+<!-- select-ul -->
+  <%= f.district_select_ul :region_code%>
+<%end%>
+```
+
+###simple_form_for
+```erb
+<%= simple_form_for Company.new,:html => { :class => 'form-horizontal' } do |f| %>
+<!-- select -->
+  <%= f.input :region_code,:as => :district_select %>
+
+<!-- select-ul -->
+  <%= f.input :region_code,:as => :district_select_ul %>
+<% end %>
+```
+
+###province,city,district select helper
+```erb
+<!-- select,select-ul适用 -->
+<!-- form_tag -->
+<%= district_select_ul(:company,:region_code,"331000") %>
+<%= city_select_ul(:company,:region_code,"331000") %>
+<%= province_select_ul(:company,:region_code,"331000") %>
+
+<!-- form_for -->
+<%= f.district_select_ul :region_code %>
+<%= f.city_select_ul :region_code %>
+<%= f.province_select_ul :region_code %>
+
+<!-- simple_form_for -->
+<%= f.input :region_code,:as => :district_select_ul %>
+<%= f.input :region_code,:as => :city_select_ul %>
+<%= f.input :region_code,:as => :province_select_ul %>
+```
+
+##Theme(select-ul适用)
+  1. default
+  2. bootstrap
+
+if you want to use the default theme, add it to your application.css:
+```console
+*= require district_cn_selector/district-ul
+```
+if you want to use bootstrap theme, you should import bootstrap css.
+
+```erb
+<!-- form_tag -->
+<%= district_select_ul(:company,:region_code,"331000",:theme=>:bootstrap) %>
+
+<!-- form_for -->
+<%= f.district_select_ul :region_code,:theme=>:bootstrap,:prompt_class=>"btn btn-success"%>
+
+<!-- simple_form_for,如果SimpleForm.wrapper等于:bootstrap，默认样式为:bootstrap -->
+<%= f.input :region_code,:as => :district_select_ul %>
+```
+## Test
+``` ruby
+  rake spec
+```
+## Resources
+* Chosen(http://harvesthq.github.io/chosen/)
+* X-editable(http://vitalets.github.io/x-editable/demo.html)
+* Jquery-addresspicker(http://xilinus.com/jquery-addresspicker/demos/index.html)
+* Jquery-Autocomplete(https://github.com/devbridge/jQuery-Autocomplete)
+* Jquery-tokeninput(https://github.com/loopj/jquery-tokeninput)
+* Jquery-ui(http://jqueryui.com/autocomplete/)
+* Select2(http://ivaynberg.github.io/select2/)
+* typeahead.js(https://github.com/twitter/typeahead.js/)
+
+
+##Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+

data/Rakefile

@@ -0,0 +1,21 @@
+#!/usr/bin/env rake
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+APP_RAKEFILE = File.expand_path("../spec/dummy/Rakefile", __FILE__)
+load 'rails/tasks/engine.rake'
+
+Bundler::GemHelper.install_tasks
+
+Dir[File.join(File.dirname(__FILE__), 'tasks/**/*.rake')].each {|f| load f }
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+
+desc "Run all specs in spec directory (excluding plugin specs)"
+RSpec::Core::RakeTask.new(:spec => 'app:db:test:prepare')
+task :default => :spec
+

data/config/routes.rb

@@ -0,0 +1,7 @@
+Rails.application.routes.draw do
+  # 返回树状结构的省，市，区县数据
+  get '/district_cn_selector/district',
+    :to => DistrictCnSelector::DistrictController.action(:index)
+  get '/district_cn_selector/district/search',
+    :to => DistrictCnSelector::DistrictController.action(:search)
+end

data/district_cn_selector.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'district_cn_selector/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "district_cn_selector"
+  spec.version       = DistrictCnSelector::VERSION
+  spec.authors       = ["kehao"]
+  spec.email         = ["kehao.qiu@gmail.com"]
+  spec.description   = %q{三级联动地区选择器}
+  spec.summary       = %q{三级联动地区选择器}
+  #spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+
+  spec.add_dependency "rails", ">= 3.2.6"
+  spec.add_dependency "jquery-rails"
+  spec.add_dependency "district_cn",">= 1.0.2"
+end

data/lib/district_cn_selector.rb

@@ -0,0 +1,22 @@
+require "district_cn"
+require "district_cn_selector/engine"
+
+module DistrictCnSelector
+  autoload :Theme, 'district_cn_selector/theme'
+  autoload :DistrictController, 'district_cn_selector/district_controller'
+
+  module Helpers
+    autoload :FormBuilderExtension, 'district_cn_selector/helpers/form_builder_extension'
+    autoload :FormBuilder, 'district_cn_selector/helpers/form_builder'
+  end
+
+  begin
+    require 'simple_form'
+    require 'district_cn_selector/hooks/simple_form'
+  rescue LoadError
+  end
+
+  require 'district_cn_selector/selector'
+  require 'district_cn_selector/district_select_ul_helper'
+  require 'district_cn_selector/district_select_helper'
+end

data/lib/district_cn_selector/district_controller.rb

@@ -0,0 +1,26 @@
+# encoding: utf-8
+module DistrictCnSelector
+  class DistrictController < ActionController::Base
+    layout nil
+    # 返回树状结构的整个省份，城市，区域列表，
+    # 避免选择地区时的多次请求 
+    def index
+      code = params[:region_code] 
+      results = 
+        if code 
+          DistrictCn.code(code).children
+        else
+          DistrictCn.tree
+        end
+      render :json => results
+    end
+
+    def search
+      ids = []
+      if params[:region_name]
+        ids = DistrictCn.search(params[:region_name])
+      end
+      render :json => ids.map{|id|{:id=>id.code,:text=>id.area_name}}
+    end
+  end
+end

data/lib/district_cn_selector/district_select_helper.rb

@@ -0,0 +1,46 @@
+# encoding: utf-8
+module ActionView
+  module Helpers
+    module FormOptionsHelper
+      def district_select(object, method, region_code=nil, options={}, html_options={})
+        tag = InstanceTag.new(object, method, self, options.delete(:object))
+        tag.to_district_select_tag(region_code, options, html_options)
+      end
+      alias_method :area_select, :district_select
+
+      def city_select(object, method, region_code=nil, options={}, html_options={})
+        tag = InstanceTag.new(object, method, self, options.delete(:object))
+        tag.to_city_select_tag(region_code, options, html_options)
+      end
+
+      def province_select(object, method, region_code=nil, options={}, html_options={})
+        tag = InstanceTag.new(object, method, self, options.delete(:object))
+        tag.to_province_select_tag(region_code, options, html_options)
+      end
+    end
+
+    module SelectHelperInstanceTag
+      def to_district_select_tag(region_code=nil, options={}, html_options={})
+        district_selector(region_code, options, html_options).to_select(:district)
+      end
+
+      def to_city_select_tag(region_code=nil,options={}, html_options={})
+        district_selector(region_code, options, html_options).to_select(:city)
+      end
+
+      def to_province_select_tag(region_code=nil,options={}, html_options={})
+        district_selector(region_code, options, html_options).to_select(:province)
+      end
+
+      private
+      def district_selector(region_code,options, html_options)
+        DistrictCnSelector::SelectSelector.new(self, region_code, options, html_options)
+      end
+    end
+
+    class InstanceTag #:nodoc:
+      include SelectHelperInstanceTag
+    end
+
+  end
+end

data/lib/district_cn_selector/district_select_ul_helper.rb

@@ -0,0 +1,48 @@
+# encoding: utf-8
+module ActionView
+  module Helpers
+    module FormOptionsHelper
+      def district_select_ul(object, method, region_code=nil, options={}, html_options={})
+        tag = InstanceTag.new(object, method, self, options.delete(:object))
+        tag.to_district_select_ul_tag(region_code, options, html_options)
+      end
+
+      alias_method :area_select_ul, :district_select_ul
+
+      def city_select_ul(object, method, region_code=nil, options={}, html_options={})
+        tag = InstanceTag.new(object, method, self, options.delete(:object))
+        tag.to_city_select_ul_tag(region_code, options, html_options)
+      end
+
+      def province_select_ul(object, method, region_code=nil, options={}, html_options={})
+        tag = InstanceTag.new(object, method, self, options.delete(:object))
+        tag.to_province_select_ul_tag(region_code, options, html_options)
+      end
+    end
+
+    module SelectUlHelperInstanceTag
+      def to_district_select_ul_tag(region_code=nil,options={}, html_options={})
+        district_ul_selector(region_code, options, html_options).to_select(:district)
+      end
+
+      def to_city_select_ul_tag(region_code=nil,options={}, html_options={})
+        district_ul_selector(region_code, options, html_options).to_select(:city)
+      end
+
+      def to_province_select_ul_tag(region_code=nil,options={}, html_options={})
+        district_ul_selector(region_code, options, html_options).to_select(:province)
+      end
+
+      private
+      def district_ul_selector(region_code,options, html_options)
+        DistrictCnSelector::SelectUlSelector.new(self, region_code, options, html_options)
+      end
+    end
+
+    class InstanceTag #:nodoc:
+      include SelectUlHelperInstanceTag
+    end
+
+  end
+end
+