繁體中文 redux 文件翻譯:
Pull request Compare This branch is 162 commits ahead, 661 commits behind reduxjs:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github Update ISSUE_TEMPLATE.md May 29, 2016
build follow official docs and update Jun 22, 2016
docs Merge remote-tracking branch 'upstream/master' into new-doc-zh-tw Aug 1, 2016
examples update Jul 20, 2016
logo Use Redux logo as favicon on GitBook docs (#1761) May 23, 2016
src throw if getState, subscribe, or unsubscribe called while dispatching ( Jul 19, 2016
test Improve typings for `compose` function (#1868) Jul 26, 2016
.babelrc Close #1687, Replace es3ify with Babel ES3 transforms (#1688) May 2, 2016
.editorconfig editorconfig: do not trim trailing whitespaces in Markdown files Feb 18, 2016
.eslintignore Really ignore all node_modules and dist in eslint. Mar 10, 2016
.eslintrc Bump eslint version Oct 26, 2015
.flowconfig Add Flow type annotations Jul 10, 2015
.gitignore Add ES Modules build Feb 5, 2016
.travis.yml Also test node v6 on travis Apr 27, 2016
CHANGELOG.md Fix conflicts from upstream Feb 25, 2016
CODE_OF_CONDUCT.md Bump Contributor Covenant to 1.4 Feb 9, 2016
CONTRIBUTING-zh-tw.md Create CONTRIBUTING-zh-tw.md Feb 22, 2016
CONTRIBUTING.md Remove rackt style paragraph from CONTRIBUTING.md Jun 9, 2016
LICENSE-logo.md Add Redux Logo (#1671) Apr 26, 2016
LICENSE.md Update LICENSE (#1650) Apr 22, 2016
PATRONS.md follow official docs and update Jun 22, 2016
README.md wording Jul 18, 2016
book.json follow official docs and update Jun 22, 2016
index.d.ts Improve typings for `compose` function (#1868) Jul 26, 2016
package.json Merge remote-tracking branch 'upstream/master' into new-doc-zh-tw Aug 1, 2016
webpack.config.js Fix typo: `OccurenceOrderPlugin` -> `OccurrenceOrderPlugin` (#1778) May 28, 2016

README.md

Redux 是個給 JavaScript 應用程式所使用的可預測 state 容器(如果你正在尋找一個 WordPress 框架,請查看 Redux Framework)。

他幫助你撰寫行為一致的應用程式,可以在不同的環境下執行 (客戶端、伺服器、原生應用程式),並且易於測試。在這之上,它提供一個很棒的開發體驗,例如把程式碼即時編輯與時間旅行除錯器結合

你可以使用 Redux 結合 React,或結合其他任何的 view library。 它非常小 (2kB ,包含依賴套件)。

build status npm version npm downloads redux channel on discord #rackt on freenode Changelog #187

新的東西!從 Redux 的作者學習它: Getting Started with Redux (三十部免費影片)

推薦

「我愛那些你在 Redux 做的東西」 Jing Chen,Flux 作者

「我在 FB 的內部 JS 討論群組尋求對 Redux 的評論,並獲得了普遍的好評。真的做得非常棒。」 Bill Fisher,Flux 文件的作者

「這很酷,你藉由完全不做 Flux 來發明了一個更好的 Flux。」 André Staltz,Cycle 作者

開發經驗

我在準備我的 React Europe 演講 「Hot Reloading 與時間旅行」 的時候撰寫了 Redux。我那時的目標是建立一個 state 管理 library,它只有最少的 API,但卻擁有完全可預測的行為,所以它可以實現 logging、hot reloading、時間旅行、universal 應用程式、記錄和重播,而不需要開發者任何其他的代價。

受到的影響

Redux 從 Flux 的概念發展而來,不過藉由從 Elm 獲取線索來避免它的複雜度。 不管你以前有沒有用過它們,只需要花幾分鐘就能入門 Redux。

安裝

安裝穩定版本:

npm install --save redux

這裡假設你是使用 npm 作為你的套件管理器。 若不是的話,你可以在 npmcdn 取得這些檔案並下載它們,或是將套件管理器指向它們。

最常見的是人們將 Redux 作為 CommonJS 模組中的一個 collection 使用。當你在 WebpackBrowserify 或 Node 環境中 import redux 時就能取得此模組。若你願意冒風險使用 Rollup,我們也同樣支援它。

如果你不想使用模組 bundler 也沒關係。redux npm 套件的 dist 資料夾包含了已編譯之 production 與 development 的 UMD build。你可以不透過 bundler 直接使用它們,也因此它們與許多熱門的 JavaScript 模組 loader 及環境相容。舉個例子,你可以將一個 UMD build 作為 <script> 標籤放入網頁中,或透過 Bower 進行安裝。UMD build 讓 Redux 能夠作為 window.Redux 全域變數進行使用。

Redux 的原始碼由 ES2015 撰寫而成,但是我們預先編譯了 CommonJS 及 UMD build 兩種 ES5 版本,讓它們可以運作於任何現代的瀏覽器。你不必使用 Babel 或模組 bundler 即可開始使用 Redux

補充性套件

大多數情況,你也會需要 React 的綁定開發者工具

npm install --save react-redux
npm install --save-dev redux-devtools

請注意,這些套件不同於 Redux 自身,許多 Redux 生態系中的套件並不提供 UMD build,所以我們建議使用像是 WebpackBrowserify 的 CommonJS 模組 bundler,以取得最舒適的開發體驗。

程式碼片段

你的應用程式的完整 state 被以一個 object tree 的形式儲存在單一一個的 store 裡面。 改變 state tree 的唯一方式是去發送一個 action,action 是一個描述發生什麼事的物件。 要指定 actions 要如何轉換 state tree 的話,你必須撰寫 pure reducers

就這樣!

import { createStore } from 'redux'

/**
 * 這是一個 reducer,一個有 (state, action) => state signature 的 pure function。
 * 它描述一個 action 如何把 state 轉換成下一個 state。
 *
 * state 的形狀取決於你:它可以是基本類型、一個陣列、一個物件,
 * 或甚至是一個 Immutable.js 資料結構。唯一重要的部分是你
 * 不應該改變 state 物件,而是當 state 變化時回傳一個新的物件。
 *
 * 在這個範例中,我們使用一個 `switch` 陳述句和字串,不過你可以使用一個 helper,
 * 來遵照一個不同的慣例 (例如 function maps),如果它對你的專案有意義。
 */
function counter(state = 0, action) {
  switch (action.type) {
  case 'INCREMENT':
    return state + 1
  case 'DECREMENT':
    return state - 1
  default:
    return state
  }
}

// 建立一個 Redux store 來掌管你的應用程式的 state。
// 它的 API 是 { subscribe, dispatch, getState }。
let store = createStore(counter)

// 你可以手動的去訂閱更新,或是使用跟你的 view layer 之間的綁定。
// 通常你會使用一個 view 綁定 library(例如:React Redux),而不是直接 subscribe()。
// 然而也可以很方便的將目前狀態儲存在 localStorage。
store.subscribe(() =>
  console.log(store.getState())
)

// 變更內部 state 的唯一方法是 dispatch 一個 action。
// actions 可以被 serialized、logged 或是儲存並在之後重播。
store.dispatch({ type: 'INCREMENT' })
// 1
store.dispatch({ type: 'INCREMENT' })
// 2
store.dispatch({ type: 'DECREMENT' })
// 1

你必須指定你想要隨著被稱作 actions 的一般物件而發生的變更,而不是直接改變 state。接著你會寫一個被稱作 reducer 的特別 function,來決定每個 action 如何轉變整個應用程式的 state。

如果你以前使用 Flux,那你需要了解一個重要的差異。Redux 沒有 Dispatcher 也不支援多個 stores。反而是只有一個唯一的 store 和一個唯一的 root reducing function。當你的應用程式變大時,你會把 root reducer 拆分成比較小的獨立 reducers 來在 state tree 的不同部分上操作,而不是添加 stores。 這就像在 React 應用程式中只有一個 root component,但是他是由許多小的 components 組合而成。

這個架構用於一個計數器應用程式可能看似有點矯枉過正,不過這個模式的美妙之處就在於它如何擴展到大型且模雜的應用程式。它也啟用了非常強大的開發工具,因為它可以追蹤每一次的變更和造成變更的 action。你可以記錄使用者的 sessions 並藉由重播每個 action 來重現它們。

從 Redux 的作者學習它

Getting Started with Redux 是一個由 30 部 Dan Abramov 講述的影片組成的影片課程,他是 Redux 的作者。它被設計用來補充文件的「基礎」部分,而帶來有關 immutability、測試、Redux 最佳實踐、與搭配 React 使用 Redux 的額外洞悉。這個課程是免費的,而且是永遠的。

「在 egghead.io 上面由 @dan_abramov 出品的偉大課程 - 不只是展示了如何使用 #redux 給你看,它也展示了如何以及為什麼打造 redux!」 Sandrino Di Mattia

「鑽研過 @dan_abramov 'Getting Started with Redux' - 它藉由影片不知道簡化了多少觀念非常驚人。」 Chris Dhanaraj

「@eggheadio 上面的這系列 @dan_abramov 出品的 Redux 影片非常的驚人!」 Eddie Zaneski

「從名字炒作而來。而留下了堅若磐石的基礎。(感謝,@dan_abramov 和 @eggheadio 做的偉大的事!)」 Dan

「這系列 @dan_abramov 出品的 Redux 影片反覆的讓我留下深刻印象 - 打算做一些認真的重構」 Laurence Roberts

所以,你還在等什麼?

觀看 30 部免費影片!

如果你喜歡我的課程,請考慮藉由購買訂閱來支持 Egghead。訂閱者可以存取我的每一個影片中的範例的原始碼,以及無數的其他主題的進階課程,包括深入 JavaScript、React、Angular、和更多其他的。許多的 Egghead 講師 也是開源 library 的作者,所以購買訂閱是一個感謝他們目前所做的事的好方式。

文件

想要輸出成 PDF、ePub 和 MOBI 以方便離線閱讀的話,關於如何產生它們的說明,請參閱:paulkogel/redux-offline-docs

範例

如果你不熟悉 NPM 生態系並在讓專案運作起來時遇到了困難,或是你不確定要在哪裡貼上上面的程式碼片段,請查看 simplest-redux-example,它把 Redux 和 React、Browserify 結合在一起。

討論

加入 Reactiflux Discord 社群的 #redux 頻道。

致謝

特別感謝 Jamie Paton 它移交了 redux NPM 套件名稱給我們。

Logo

你可以在 Github 上 找到官方的 logo。

變更日誌

這個專案依照 Semantic Versioning。 每一個釋出版本都會伴隨它的遷移說明,被記錄在 Github Releases 頁面上。

贊助者

在 Redux 的工作是由社群出資。 遇到一些卓越的公司使這可以成真:

查看完整的 Redux 贊助者清單。

License

MIT