转载

学习RxJS：Cycle.js

是什么

Cycle.js 是一个极简的JavaScript框架（核心部分加上注释125行），提供了一种函数式，响应式的人机交互接口（以下简称 HCI ）：

函数式

Cycle.js 把应用程序抽象成一个纯函数 main() ，从外部世界读取副作用( sources )，然后产生输出( sinks ) 传递到外部世界，在那形成副作用。这些外部世界的副作用，做为Cycle.js的插件存在(drivers)，它们负责：处理DOM、提供HTTP访问等。

学习RxJS：Cycle.js

响应式

Cycle.js 使用 rx.js 来实现关注分离，这意味着应用程序是基于事件流的，数据流是 Observable 的：

学习RxJS：Cycle.js

HCI

HCI 是双向的对话，人机互为观察者：

学习RxJS：Cycle.js

在这个交互模型中，人机之间的信息流互为输出输出，构成一个循环，也即 Cycle这一命名所指，框架的Logo更是以莫比乌斯环贴切的描述了这个循环。学习RxJS：Cycle.js

唯一的疑惑会是：循环无头无尾，信息流从何处发起？好问题，答案是：

However, we need a .startWith() to give a default value. Without this, nothing would be shown! Why? Because our sinks is reacting to sources , but sources is reacting to sinks . If no one triggers the first event, nothing will happen. —— via examples

有了 .startWith() 提供的这个初始值，整个流程得以启动，自此形成一个闭环，一个事件驱动的永动机

Drivers

driver 是 Cycle.js 主函数 main() 和外部世界打交道的接口，比如HTTP请求，比如DOM操作，这些是由具体的driver 负责的，它的存在确保了 main() 的纯函数特性，所有副作用和繁琐的细节皆由 driver来实施——所以 @cycle/core 才125 行，而 @cycle/dom 却有 4052 行之巨。

driver也是一个函数，从流程上来说，driver 监听 sinks （ main() 的输出）做为输入，执行一些命令式的副作用，并产生出 sources 做为 main() 的输入。

DOM Driver

即 @cycle/dom，是使用最为频繁的driver。实际应用中，我们的 main() 会与DOM进行交互：

需要传递内容给用户时， main() 会返新的DOM sinks，以触发 domDriver() 生成 virtual-dom ，并渲染
main() 订阅 domDriver() 的输出值（做为输入），并据此进行响应

学习RxJS：Cycle.js

组件化

每个Cycle.js应用程序不管多复杂，都遵循一套输入输出的基本法，因此，组件化是很容易实现，无非就是函数对函数的组合调用

学习RxJS：Cycle.js

实战

准备工作

安装全局模块

npminstall -g http-server

依赖模块一览

"devDependencies": {   "babel-plugin-transform-react-jsx": "^6.8.0",   "babel-preset-es2015": "^6.9.0",   "babelify": "^7.3.0",   "browserify": "^13.0.1",   "uglifyify": "^3.0.1",   "watchify": "^3.7.0" }, "dependencies": {   "@cycle/core": "^6.0.3",   "@cycle/dom": "^9.4.0",   "@cycle/http": "^8.2.2" }

.babelrc （插件支持JSX语法）

{   "plugins": [     ["transform-react-jsx", { "pragma": "hJSX" }]   ],   "presets": ["es2015"] }

Scripts（热生成和运行服务器）

"scripts": {   "start": "http-server",   "build": "../node_modules/.bin/watchify index.js -v -g uglifyify -t babelify -o bundle.js" }

以下实例需要运行时，可以开两个shell，一个跑热编译，一个起http-server（爱用currently亦可

$ npmrunbuild

$ npmstart

交互实例1

学习RxJS：Cycle.js

功能：两个button，一加一减，从0起步，回显计数
demo地址： http://output.jsbin.com/lamexacaku

HTML代码（实例2同，略

<!DOCTYPEhtml> <html> <head>     <metacharset="utf-8">     <title>components</title> </head> <body> <divid="container"></div> <scriptsrc="bundle.js"></script> </body> </html>

index.js

importCyclefrom '@cycle/core' import { makeDOMDriver, hJSX } from '@cycle/dom'   function main({ DOM }) {   const decrement$ = DOM.select('.decrement').events('click').map(_ => -1)   const increment$ = DOM.select('.increment').events('click').map(_ => +1)   const count$ = increment$.merge(decrement$)     .scan((x, y) => x + y)     .startWith(0)   return {     DOM: count$.map(count =>       <div>         <inputtype="button" className="decrement" value=" - "/>         <inputtype="button" className="increment" value=" + "/>         <div>           Clicked {count} times~         </div>       </div>     )   } }   Cycle.run(main, {   DOM: makeDOMDriver('#container'), })

不难看出：

main() 是个纯函数，从始至终不依赖外部状态，它的所有动力来自于DOM事件源click，这个状态机依靠 Observable.prototype.scan() 得以计算和传递，最后生成 sinks 传递给DOM driver以渲染；
启动了这个循环是 .startWith() ;
Cycle.run是应用程序的入口，加载 main() 和DOM driver，后者对一个HTML容器进行渲染输出

交互实例2

学习RxJS：Cycle.js

功能：一个button一个框，输入并点button后，通过Github api搜索相关的Repo，回显总数并展示第一页Repo列表

index.js

importCyclefrom '@cycle/core' import { makeDOMDriver, hJSX } from '@cycle/dom' import { makeHTTPDriver } from '@cycle/http'   const GITHUB_SEARCH_URL = 'https://api.github.com/search/repositories?q='   function main(responses$) {   const search$ = responses$.DOM.select('input[type="button"]')     .events('click')     .map(_ => { return { url: GITHUB_SEARCH_URL } })     const text$ = responses$.DOM.select('input[type="text"]')     .events('input')     .map(e => { return { keyword: e.target.value } })     const http$ = search$.withLatestFrom(text$, (search, text)=> search.url + text.keyword)     .map(state => { return { url: state, method: 'GET' } })     const dom$ = responses$.HTTP     .filter(res$ => res$.request.url && res$.request.url.startsWith(GITHUB_SEARCH_URL))     .mergeAll()     .map(res => JSON.parse(res.text))     .startWith({ loading: true })     .map(JSON => {         return <div>           <inputtype="text"/>           <inputtype="button" value="search"/>           <br/>           <span>             {JSON.loading ? 'Loading...' : `total: ${JSON.total_count}`}           </span>           <ol>             {               JSON.items && JSON.items.map(repo =>                 <div>                   <span>repo.full_name</span>                   <a href={ repo.html_url }>{ repo.html_url }</a>                 </div>               )             }           </ol>         </div>       }     )     return {     DOM: dom$,     HTTP: http$,   } }   const driver = {   DOM: makeDOMDriver('#container'),   HTTP: makeHTTPDriver(), }   Cycle.run(main, driver)

有了实例1做铺垫，这段代码也就通俗易懂了，需要提示的是：

Rx的Observable对象，命名上约定以$符为结束，以示区分
Observable.prototype.withLatestFrom() 的作用是：在当前Observable对象的事件触发时（不同于 combineLatest ），去合并参数的目标Observable对象的最新状态，并传递给下一级Observer
以上项目完整实例，可在 /rockdragon/rx_practise/tree/master/src/web 找到