avalon-mmRouter-rails 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a296a27f53516f76fa78459c0dbf614e1b30759e
+  data.tar.gz: 7a2c0f6ec0d2b9d38f81e09d396ca58583c4e089
+SHA512:
+  metadata.gz: ccf719babbefbf6d1c891309a78c4f08b33fc8808bf5ba664e343b90fad62b8baa15a0d73fb3b834d78a34d19237f9f0df54f6940b68a5f300a87d50e8b5e561
+  data.tar.gz: 3cd2a801ced381fb890948c89e76338c829bd811af60e8e009cd0e94731ad9d434f43c643bdc2b25f2241f864b5fd45a19b93be1af3dbb7a08cdcb456f2d6419

data/.gitignore

@@ -0,0 +1,15 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+*.DS_Store

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in avalon-mmRouter-rails.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 iron
+
+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,17 @@
+# Avalon::MmRouter::Rails
+
+Rails 3.1 asset-pipeline gem to provide avalon.js mmRouter
+
+mmRouter js: https://github.com/RubyLouvre/mmRouter
+
+```ruby
+gem 'avalon-mmRouter-rails'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install avalon-mmRouter-rails

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/avalon-mmRouter-rails.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'avalon/mmRouter/rails/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "avalon-mmRouter-rails"
+  spec.version       = Avalon::MmRouter::Rails::VERSION
+  spec.authors       = ["zj0713001"]
+  spec.email         = ["zj0713001@gmail.com"]
+  spec.summary       = %q{Use javascript framework Avalon mmRouter with Rails 3+}
+  spec.description   = %q{his gem provides javascript framework Avalon mmRouter for your Rails 3+ application.}
+  spec.homepage      = "https://github.com/zj0713001/avalon-mmRouter-rails"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  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.7"
+  spec.add_development_dependency "rake", "~> 10.0"
+end

data/lib/avalon/mmRouter/rails.rb

@@ -0,0 +1,13 @@
+require "avalon/mmRouter/rails/version"
+
+module Avalon
+  module MmRouter
+    module Rails
+      if defined?(::Rails) and Gem::Requirement.new('>= 3.1').satisfied_by?(Gem::Version.new ::Rails.version)
+        class Rails::Engine < ::Rails::Engine
+          # this class enables the asset pipeline
+        end
+      end
+    end
+  end
+end

data/lib/avalon/mmRouter/rails/version.rb

@@ -0,0 +1,7 @@
+module Avalon
+  module MmRouter
+    module Rails
+      VERSION = "0.0.1"
+    end
+  end
+end

data/vendor/assets/javascripts/avalon/mmHistory.js

@@ -0,0 +1,310 @@
+/*
+ * 
+ * version 0.7
+ * built in 2015.10.12
+ */
+
+define(["avalon"], function(avalon) {
+    var anchorElement = document.createElement('a')
+
+    var History = avalon.History = function() {
+        this.location = location
+    }
+
+    History.started = false
+    //取得当前IE的真实运行环境
+    History.IEVersion = (function() {
+        var mode = document.documentMode
+        return mode ? mode : window.XMLHttpRequest ? 7 : 6
+    })()
+
+    History.defaults = {
+        basepath: "/",
+        html5Mode: false,
+        hashPrefix: "!",
+        iframeID: null, //IE6-7，如果有在页面写死了一个iframe，这样似乎刷新的时候不会丢掉之前的历史
+        interval: 50, //IE6-7,使用轮询，这是其时间时隔
+        fireAnchor: true,//决定是否将滚动条定位于与hash同ID的元素上
+        routeElementJudger: avalon.noop // 判断a元素是否是触发router切换的链接
+    }
+
+    var oldIE = window.VBArray && History.IEVersion <= 7
+    var supportPushState = !!(window.history.pushState)
+    var supportHashChange = !!("onhashchange" in window && (!window.VBArray || !oldIE))
+    History.prototype = {
+        constructor: History,
+        getFragment: function(fragment) {
+            if (fragment == null) {
+                if (this.monitorMode === "popstate") {
+                    fragment = this.getPath()
+                } else {
+                    fragment = this.getHash()
+                }
+            }
+            return fragment.replace(/^[#\/]|\s+$/g, "")
+        },
+        getHash: function(window) {
+            // IE6直接用location.hash取hash，可能会取少一部分内容
+            // 比如 http://www.cnblogs.com/rubylouvre#stream/xxxxx?lang=zh_c
+            // ie6 => location.hash = #stream/xxxxx
+            // 其他浏览器 => location.hash = #stream/xxxxx?lang=zh_c
+            // firefox 会自作多情对hash进行decodeURIComponent
+            // 又比如 http://www.cnblogs.com/rubylouvre/#!/home/q={%22thedate%22:%2220121010~20121010%22}
+            // firefox 15 => #!/home/q={"thedate":"20121010~20121010"}
+            // 其他浏览器 => #!/home/q={%22thedate%22:%2220121010~20121010%22}
+            var path = (window || this).location.href
+            return this._getHash(path.slice(path.indexOf("#")))
+        },
+        _getHash: function(path) {
+            if (path.indexOf("#/") === 0) {
+                return decodeURIComponent(path.slice(2))
+            }
+            if (path.indexOf("#!/") === 0) {
+                return decodeURIComponent(path.slice(3))
+            }
+            return ""
+        },
+        getPath: function() {
+            var path = decodeURIComponent(this.location.pathname + this.location.search)
+            var root = this.basepath.slice(0, -1)
+            if (!path.indexOf(root))
+                path = path.slice(root.length)
+            return path.slice(1)
+        },
+        _getAbsolutePath: function(a) {
+            return !a.hasAttribute ? a.getAttribute("href", 4) : a.href
+        },
+        /*
+         * @interface avalon.history.start 开始监听历史变化
+         * @param options 配置参数
+         * @param options.hashPrefix hash以什么字符串开头，默认是 "!"，对应实际效果就是"#!"
+         * @param options.routeElementJudger 判断a元素是否是触发router切换的链接的函数，return true则触发切换，默认为avalon.noop，history内部有一个判定逻辑，是先判定a元素的href属性是否以hashPrefix开头，如果是则当做router切换元素，因此综合判定规则是 href.indexOf(hashPrefix) == 0 || routeElementJudger(ele, ele.href)，如果routeElementJudger返回true则跳转至href，如果返回的是字符串，则跳转至返回的字符串，如果返回false则返回浏览器默认行为
+         * @param options.html5Mode 是否采用html5模式，即不使用hash来记录历史，默认false
+         * @param options.fireAnchor 决定是否将滚动条定位于与hash同ID的元素上，默认为true
+         * @param options.basepath 根目录，默认为"/"
+         */
+        start: function(options) {
+            if (History.started)
+                throw new Error("avalon.history has already been started")
+            History.started = true
+            this.options = avalon.mix({}, History.defaults, options)
+            //IE6不支持maxHeight, IE7支持XMLHttpRequest, IE8支持window.Element，querySelector, 
+            //IE9支持window.Node, window.HTMLElement, IE10不支持条件注释
+            //确保html5Mode属性存在,并且是一个布尔
+            this.html5Mode = !!this.options.html5Mode
+            //监听模式
+            this.monitorMode = this.html5Mode ? "popstate" : "hashchange"
+            if (!supportPushState) {
+                if (this.html5Mode) {
+                    avalon.log("如果浏览器不支持HTML5 pushState，强制使用hash hack!")
+                    this.html5Mode = false
+                }
+                this.monitorMode = "hashchange"
+            }
+            if (!supportHashChange) {
+                this.monitorMode = "iframepoll"
+            }
+            this.prefix = "#" + this.options.hashPrefix + "/"
+            //确认前后都存在斜线， 如"aaa/ --> /aaa/" , "/aaa --> /aaa/", "aaa --> /aaa/", "/ --> /"
+            this.basepath = ("/" + this.options.basepath + "/").replace(/^\/+|\/+$/g, "/")  // 去最左右两边的斜线
+
+            this.fragment = this.getFragment()
+
+            anchorElement.href = this.basepath
+            this.rootpath = this._getAbsolutePath(anchorElement)
+            var that = this
+
+            var html = '<!doctype html><html><body>@</body></html>'
+            if (this.options.domain) {
+                html = html.replace("<body>", "<script>document.domain =" + this.options.domain + "</script><body>")
+            }
+            this.iframeHTML = html
+            if (this.monitorMode === "iframepoll") {
+                //IE6,7在hash改变时不会产生历史，需要用一个iframe来共享历史
+                avalon.ready(function() {
+                    if(that.iframe) return
+                    var iframe = that.iframe || document.getElementById(that.iframeID) || document.createElement('iframe')
+                    iframe.src = 'javascript:0'
+                    iframe.style.display = 'none'
+                    iframe.tabIndex = -1
+                    document.body.appendChild(iframe)
+                    that.iframe = iframe.contentWindow
+                    that._setIframeHistory(that.prefix + that.fragment)
+                })
+
+            }
+
+            // 支持popstate 就监听popstate
+            // 支持hashchange 就监听hashchange
+            // 否则的话只能每隔一段时间进行检测了
+            function checkUrl(e) {
+                var iframe = that.iframe
+                if (that.monitorMode === "iframepoll" && !iframe) {
+                    return false
+                }
+                var pageHash = that.getFragment(), hash, lastHash = avalon.router.getLastPath()
+                if (iframe) {//IE67
+                    var iframeHash = that.getHash(iframe)
+                    //与当前页面hash不等于之前的页面hash，这主要是用户通过点击链接引发的
+                    if (pageHash !== lastHash) {
+                        that._setIframeHistory(that.prefix + pageHash)
+                        hash = pageHash
+                        //如果是后退按钮触发hash不一致
+                    } else if (iframeHash !== lastHash) {
+                        that.location.hash = that.prefix + iframeHash
+                        hash = iframeHash
+                    }
+
+                } else if (pageHash !== lastHash) {
+                    hash = pageHash
+                }
+                if (hash !== void 0) {
+                    that.fragment = hash
+                    that.fireRouteChange(hash, {fromHistory: true})
+                }
+            }
+
+            //thanks https://github.com/browserstate/history.js/blob/master/scripts/uncompressed/history.html4.js#L272
+
+            // 支持popstate 就监听popstate
+            // 支持hashchange 就监听hashchange(IE8,IE9,FF3)
+            // 否则的话只能每隔一段时间进行检测了(IE6, IE7)
+            switch (this.monitorMode) {
+                case "popstate":
+                    this.checkUrl = avalon.bind(window, "popstate", checkUrl)
+                    this._fireLocationChange = checkUrl
+                    break
+                case  "hashchange":
+                    this.checkUrl = avalon.bind(window, "hashchange", checkUrl)
+                    break;
+                case  "iframepoll":
+                    this.checkUrl = setInterval(checkUrl, this.options.interval)
+                    break;
+            }
+            //根据当前的location立即进入不同的路由回调
+            avalon.ready(function() {
+                that.fireRouteChange(that.fragment || "/", {replace: true})
+            })
+        },
+        fireRouteChange: function(hash, options) {
+            var router = avalon.router
+            if (router && router.navigate) {
+                router.setLastPath(hash)
+                router.navigate(hash === "/" ? hash : "/" + hash, options)
+            }
+            if (this.options.fireAnchor) {
+                scrollToAnchorId(hash.replace(/\?.*/g,""))
+            }
+        },
+        // 中断URL的监听
+        stop: function() {
+            avalon.unbind(window, "popstate", this.checkUrl)
+            avalon.unbind(window, "hashchange", this.checkUrl)
+            clearInterval(this.checkUrl)
+            History.started = false
+        },
+        updateLocation: function(hash, options, urlHash) {
+            var options = options || {},
+                rp = options.replace,
+                st =    options.silent
+            if (this.monitorMode === "popstate") {
+                // html5 mode 第一次加载的时候保留之前的hash
+                var path = this.rootpath + hash + (urlHash || "")
+                // html5 model包含query
+                if(path != this.location.href.split("#")[0]) history[rp ? "replaceState" : "pushState"]({path: path}, document.title, path)
+                if(!st) this._fireLocationChange()
+            } else {
+                var newHash = this.prefix + hash
+                if(st && hash != this.getHash()) {
+                    this._setIframeHistory(newHash, rp)
+                    if(this.fragment) avalon.router.setLastPath(this.fragment)
+                    this.fragment = this._getHash(newHash)
+                }
+                this._setHash(this.location, newHash, rp)
+            }
+        },
+        _setHash: function(location, hash, replace){
+            var href = location.href.replace(/(javascript:|#).*$/, '')
+            if (replace){
+                location.replace(href + hash)
+            }
+            else location.hash = hash
+        },
+        _setIframeHistory: function(hash, replace) {
+            if(!this.iframe) return
+            var idoc = this.iframe.document
+                idoc.open()
+                idoc.write(this.iframeHTML)
+                idoc.close()
+            this._setHash(idoc.location, hash, replace)
+        }
+    }
+
+    avalon.history = new History
+
+    //https://github.com/asual/jquery-address/blob/master/src/jquery.address.js
+
+    //劫持页面上所有点击事件，如果事件源来自链接或其内部，
+    //并且它不会跳出本页，并且以"#/"或"#!/"开头，那么触发updateLocation方法
+    avalon.bind(document, "click", function(event) {
+        var defaultPrevented = "defaultPrevented" in event ? event['defaultPrevented'] : event.returnValue === false
+
+        if (!History.started || defaultPrevented || event.ctrlKey || event.metaKey || event.which === 2)
+            return
+        var target = event.target
+        while (target.nodeName !== "A") {
+            target = target.parentNode
+            if (!target || target.tagName === "BODY") {
+                return
+            }
+        }
+
+        if (targetIsThisWindow(target.target)) {
+            var href = oldIE ? target.getAttribute("href", 2) : target.getAttribute("href") || target.getAttribute("xlink:href")
+            var prefix = avalon.history.prefix
+            if (href === null) { // href is null if the attribute is not present
+                return
+            }
+            var hash = href.replace(prefix, "").trim()
+            if(!(href.indexOf(prefix) === 0 && hash !== "")) {
+                var routeElementJudger = avalon.history.options.routeElementJudger
+                hash = routeElementJudger(target, href)
+                if(hash === true) hash = href
+            }
+            if (hash) {
+                event.preventDefault()
+                avalon.router && avalon.router.navigate(hash)
+            }
+        }
+    })
+
+    //判定A标签的target属性是否指向自身
+    //thanks https://github.com/quirkey/sammy/blob/master/lib/sammy.js#L219
+    function targetIsThisWindow(targetWindow) {
+        if (!targetWindow || targetWindow === window.name || targetWindow === '_self' || (targetWindow === 'top' && window == window.top)) {
+            return true
+        }
+        return false
+    }
+    //得到页面第一个符合条件的A标签
+    function getFirstAnchor(list) {
+        for (var i = 0, el; el = list[i++]; ) {
+            if (el.nodeName === "A") {
+                return el
+            }
+        }
+    }
+
+    function scrollToAnchorId(hash, el) {
+        if ((el = document.getElementById(hash))) {
+            el.scrollIntoView()
+        } else if ((el = getFirstAnchor(document.getElementsByName(hash)))) {
+            el.scrollIntoView()
+        } else {
+            window.scrollTo(0, 0)
+        }
+    }
+    return avalon
+})
+
+// 主要参数有 basepath  html5Mode  hashPrefix  interval domain fireAnchor

data/vendor/assets/javascripts/avalon/mmPromise.js

@@ -0,0 +1,221 @@
+define(["avalon"], function (avalon) {
+//chrome36的原生Promise还多了一个defer()静态方法，允许不通过传参就能生成Promise实例，
+//另还多了一个chain(onSuccess, onFail)原型方法，意义不明
+//目前，firefox24, opera19也支持原生Promise(chrome32就支持了，但需要打开开关，自36起直接可用)
+//本模块提供的Promise完整实现ECMA262v6 的Promise规范
+//2015.3.12 支持async属性
+    function ok(val) {
+        return val
+    }
+    function ng(e) {
+        throw e
+    }
+
+    function done(onSuccess) {//添加成功回调
+        return this.then(onSuccess, ng)
+    }
+    function fail(onFail) {//添加出错回调
+        return this.then(ok, onFail)
+    }
+    function defer() {
+        var ret = {};
+        ret.promise = new this(function (resolve, reject) {
+            ret.resolve = resolve
+            ret.reject = reject
+        });
+        return ret
+    }
+    var msPromise = function (executor) {
+        this._callbacks = []
+        var me = this
+        if (typeof this !== "object")
+            throw new TypeError("Promises must be constructed via new")
+        if (typeof executor !== "function")
+            throw new TypeError("not a function")
+
+        executor(function (value) {
+            _resolve(me, value)
+        }, function (reason) {
+            _reject(me, reason)
+        })
+    }
+    function fireCallbacks(promise, fn) {
+        if (typeof promise.async === "boolean") {
+            var isAsync = promise.async
+        } else {
+            isAsync = promise.async = true
+        }
+        if (isAsync) {
+            window.setTimeout(fn, 0)
+        } else {
+            fn()
+        }
+    }
+//返回一个已经处于`resolved`状态的Promise对象
+    msPromise.resolve = function (value) {
+        return new msPromise(function (resolve) {
+            resolve(value)
+        })
+    }
+//返回一个已经处于`rejected`状态的Promise对象
+    msPromise.reject = function (reason) {
+        return new msPromise(function (resolve, reject) {
+            reject(reason)
+        })
+    }
+
+    msPromise.prototype = {
+//一个Promise对象一共有3个状态：
+//- `pending`：还处在等待状态，并没有明确最终结果
+//- `resolved`：任务已经完成，处在成功状态
+//- `rejected`：任务已经完成，处在失败状态
+        constructor: msPromise,
+        _state: "pending",
+        _fired: false, //判定是否已经被触发
+        _fire: function (onSuccess, onFail) {
+            if (this._state === "rejected") {
+                if (typeof onFail === "function") {
+                    onFail(this._value)
+                } else {
+                    throw this._value
+                }
+            } else {
+                if (typeof onSuccess === "function") {
+                    onSuccess(this._value)
+                }
+            }
+        },
+        _then: function (onSuccess, onFail) {
+            if (this._fired) {//在已有Promise上添加回调
+                var me = this
+                fireCallbacks(me, function () {
+                    me._fire(onSuccess, onFail)
+                });
+            } else {
+                this._callbacks.push({onSuccess: onSuccess, onFail: onFail})
+            }
+        },
+        then: function (onSuccess, onFail) {
+            onSuccess = typeof onSuccess === "function" ? onSuccess : ok
+            onFail = typeof onFail === "function" ? onFail : ng
+            var me = this//在新的Promise上添加回调
+            var nextPromise = new msPromise(function (resolve, reject) {
+                me._then(function (value) {
+                    try {
+                        value = onSuccess(value)
+                    } catch (e) {
+                        // https://promisesaplus.com/#point-55
+                        reject(e)
+                        return
+                    }
+                    resolve(value)
+                }, function (value) {
+                    try {
+                        value = onFail(value)
+                    } catch (e) {
+                        reject(e)
+                        return
+                    }
+                    resolve(value)
+                })
+            })
+            for (var i in me) {
+                if (!personal[i]) {
+                    nextPromise[i] = me[i]
+                }
+            }
+            return nextPromise
+        },
+        "done": done,
+        "catch": fail,
+        "fail": fail
+    }
+    var personal = {
+        _state: 1,
+        _fired: 1,
+        _value: 1,
+        _callbacks: 1
+    }
+    function _resolve(promise, value) {//触发成功回调
+        if (promise._state !== "pending")
+            return;
+        if (value && typeof value.then === "function") {
+//thenable对象使用then，Promise实例使用_then
+            var method = value instanceof msPromise ? "_then" : "then"
+            value[method](function (val) {
+                _transmit(promise, val, true)
+            }, function (reason) {
+                _transmit(promise, reason, false)
+            });
+        } else {
+            _transmit(promise, value, true);
+        }
+    }
+    function _reject(promise, value) {//触发失败回调
+        if (promise._state !== "pending")
+            return
+        _transmit(promise, value, false)
+    }
+//改变Promise的_fired值，并保持用户传参，触发所有回调
+    function _transmit(promise, value, isResolved) {
+        promise._fired = true;
+        promise._value = value;
+        promise._state = isResolved ? "fulfilled" : "rejected"
+        fireCallbacks(promise, function () {
+            promise._callbacks.forEach(function (data) {
+                promise._fire(data.onSuccess, data.onFail);
+            })
+        })
+    }
+    function _some(any, iterable) {
+        iterable = Array.isArray(iterable) ? iterable : []
+        var n = 0, result = [], end
+        return new msPromise(function (resolve, reject) {
+            // 空数组直接resolve
+            if (!iterable.length)
+                resolve(result)
+            function loop(a, index) {
+                a.then(function (ret) {
+                    if (!end) {
+                        result[index] = ret//保证回调的顺序
+                        n++
+                        if (any || n >= iterable.length) {
+                            resolve(any ? ret : result)
+                            end = true
+                        }
+                    }
+                }, function (e) {
+                    end = true
+                    reject(e)
+                })
+            }
+            for (var i = 0, l = iterable.length; i < l; i++) {
+                loop(iterable[i], i)
+            }
+        })
+    }
+
+    msPromise.all = function (iterable) {
+        return _some(false, iterable)
+    }
+    msPromise.race = function (iterable) {
+        return _some(true, iterable)
+    }
+    msPromise.defer = defer
+
+
+
+    avalon.Promise = msPromise
+    var nativePromise = window.Promise
+    if (/native code/.test(nativePromise)) {
+        nativePromise.prototype.done = done
+        nativePromise.prototype.fail = fail
+        if (!nativePromise.defer) { //chrome实现的私有方法
+            nativePromise.defer = defer
+        }
+    }
+    return window.Promise = nativePromise || msPromise
+
+})
+//https://github.com/ecomfe/er/blob/master/src/Deferred.js
+//http://jser.info/post/77696682011/es6-promises