React.js 小書 Lesson25 - 實(shí)戰(zhàn)分析：評(píng)論功能（四）

本文作者：胡子大哈
本文原文：http://huziketang.com/books/react/lesson25

轉(zhuǎn)載請(qǐng)注明出處，保留原文鏈接以及作者信息

在線閱讀：http://huziketang.com/books/react

目前為止，第二階段知識(shí)已經(jīng)基本介紹完，我們已經(jīng)具備了項(xiàng)目上手實(shí)戰(zhàn)必備的 React.js 知識(shí)，現(xiàn)在可以把這些知識(shí)應(yīng)用起來(lái)。接下來(lái)是實(shí)戰(zhàn)環(huán)節(jié)，我們會(huì)繼續(xù)上一階段的例子，把評(píng)論功能做得更加復(fù)雜一點(diǎn)。

我們?cè)谏弦浑A段的評(píng)論功能基礎(chǔ)上加上以下功能需求：

1. 頁(yè)面加載完成自動(dòng)聚焦到評(píng)論輸入框。
2. 把用戶名持久化，存放到瀏覽器的 LocalStorage 中。頁(yè)面加載時(shí)會(huì)把用戶名加載出來(lái)顯示到輸入框，用戶就不需要重新輸入用戶名了。
3. 把已經(jīng)發(fā)布的評(píng)論持久化，存放到瀏覽器的 LocalStorage 中。頁(yè)面加載時(shí)會(huì)把已經(jīng)保存的評(píng)論加載出來(lái)，顯示到頁(yè)面的評(píng)論列表上。
4. 評(píng)論顯示發(fā)布日期，如“1 秒前”，”30 分鐘前”，并且會(huì)每隔 5 秒更新發(fā)布日期。
5. 評(píng)論可以被刪除。
6. 類似 Markdown 的行內(nèi)代碼塊顯示功能，用戶輸入的用 `` 包含起來(lái)的內(nèi)容都會(huì)被處理成用 <code> 元素包含。例如輸入 `console.log` 就會(huì)處理成 <code>console.log</code> 再顯示到頁(yè)面上。

[圖片上傳失敗...(image-177052-1510227040222)]

在線演示地址。

大家可以在原來(lái)的第一階段代碼的基礎(chǔ)上進(jìn)行修改，第一、二階段評(píng)論功能代碼可以在這里找到： react-naive-book-examples。可以直接使用最新的樣式文件 index.css 覆蓋原來(lái)的 index.css。

接下來(lái)可以分析如何利用第二階段的知識(shí)來(lái)構(gòu)建這些功能，在這個(gè)過程里面可能會(huì)穿插一些小技巧，希望對(duì)大家有用。我們回顧一下這個(gè)頁(yè)面的組成：

[圖片上傳失敗...(image-13ca3-1510227040222)]

我們之前把頁(yè)面分成了四種不同的組件：分別是 CommentApp 、CommentInput、CommentList、Comment。我們開始修改這個(gè)組件，把上面的需求逐個(gè)完成。

自動(dòng)聚焦到評(píng)論框

這個(gè)功能是很簡(jiǎn)單的，我們需要獲取 textarea 的 DOM 元素然后調(diào)用 focus() API 就可以了。我們給輸入框元素加上 ref 以便獲取到 DOM 元素，修改 src/CommentInput.js 文件：

...
    <textarea
      ref={(textarea) => this.textarea = textarea}
      value={this.state.content}
      onChange={this.handleContentChange.bind(this)} />
...

組件掛載完以后完成以后就可以調(diào)用 this.textarea.focus()，給 CommentInput 組件加上 ComponentDidMount 生命周期：

class CommentInput extends Component {
  static propTypes = {
    onSubmit: PropTypes.func
  }

  constructor () {
    super()
    this.state = {
      username: '',
      content: ''
    }
  }

  componentDidMount () {
    this.textarea.focus()
  }
...

這個(gè)功能就完成了。現(xiàn)在體驗(yàn)還不是很好，接下來(lái)我們把用戶名持久化一下，體驗(yàn)就會(huì)好很多。

大家可以注意到我們給原來(lái)的 props.onSubmit 參數(shù)加了組件參數(shù)驗(yàn)證，在這次實(shí)戰(zhàn)案例中，我們都會(huì)給評(píng)論功能的組件加上 propTypes 進(jìn)行參數(shù)驗(yàn)證，接下來(lái)就不累述。

持久化用戶名

用戶輸入用戶名，然后我們把用戶名保存到瀏覽器的 LocalStorage 當(dāng)中，當(dāng)頁(yè)面加載的時(shí)候再?gòu)?LocalStorage 把之前保存的用戶名顯示到用戶名輸入框當(dāng)中。這樣用戶就不用每次都輸入用戶名了，并且評(píng)論框是自動(dòng)聚焦的，用戶的輸入體驗(yàn)就好很多。

我們監(jiān)聽用戶名輸入框失去焦點(diǎn)的事件 onBlur：

...
    <input
      value={this.state.username}
      onBlur={this.handleUsernameBlur.bind(this)}
      onChange={this.handleUsernameChange.bind(this)} />
...

在 handleUsernameBlur 中我們把用戶的輸入內(nèi)容保存到 LocalStorage 當(dāng)中：

class CommentInput extends Component {
  constructor () {
    super()
    this.state = {
      username: '',
      content: ''
    }
  }

  componentDidMount () {
    this.textarea.focus()
  }

  _saveUsername (username) {
    localStorage.setItem('username', username)
  }

  handleUsernameBlur (event) {
    this._saveUsername(event.target.value)
  }
...

在 handleUsernameBlur 中我們把用戶輸入的內(nèi)容傳給了 _saveUsername 私有方法（所有私有方法都以 _ 開頭）。_saveUsername 會(huì)設(shè)置 LocalStorage 中的 username 字段，用戶名就持久化了。這樣就相當(dāng)于每當(dāng)用戶輸入完用戶名以后（輸入框失去焦點(diǎn)的時(shí)候），都會(huì)把用戶名自動(dòng)保存一次。

輸入用戶名，然后到瀏覽器里里面看看是否保存了：

[圖片上傳失敗...(image-2c3315-1510227040222)]

然后我們組件掛載的時(shí)候把用戶名加載出來(lái)。這是一種數(shù)據(jù)加載操作，我們說(shuō)過，不依賴 DOM 操作的組件啟動(dòng)的操作都可以放在 componentWillMount 中進(jìn)行，所以給 CommentInput 添加 componentWillMount 的組件生命周期：

...
  componentWillMount () {
    this._loadUsername()
  }

  _loadUsername () {
    const username = localStorage.getItem('username')
    if (username) {
      this.setState({ username })
    }
  }

  _saveUsername (username) {
    localStorage.setItem('username', username)
  }
...

componentWillMount 會(huì)調(diào)用 _loadUsername 私有方法，_loadUsername 會(huì)從 LocalStorage 加載用戶名并且 setState 到組件的 state.username 中。那么組件在渲染的時(shí)候（render 方法）掛載的時(shí)候就可以用上用戶名了。

這樣體驗(yàn)就好多了，刷新頁(yè)面，不需要輸入用戶名，并且自動(dòng)聚焦到了輸入框。我們 1、 2 需求都已經(jīng)完成。

小貼士

這里插入一些小貼示，大家可以注意到我們組件的命名和方法的擺放順序其實(shí)有一定的講究，這里可以簡(jiǎn)單分享一下個(gè)人的習(xí)慣，僅供參考。

組件的私有方法都用 _ 開頭，所有事件監(jiān)聽的方法都用 handle 開頭。把事件監(jiān)聽方法傳給組件的時(shí)候，屬性名用 on 開頭。例如：

<CommentInput
  onSubmit={this.handleSubmitComment.bind(this)} />

這樣統(tǒng)一規(guī)范處理事件命名會(huì)給我們帶來(lái)語(yǔ)義化組件的好處，監(jiān)聽（on）CommentInput 的 Submit 事件，并且交給 this 去處理（handle）。這種規(guī)范在多人協(xié)作的時(shí)候也會(huì)非常方便。

另外，組件的內(nèi)容編寫順序如下：

1. static 開頭的類屬性，如 defaultProps、propTypes。
2. 構(gòu)造函數(shù)，constructor。
3. getter/setter（還不了解的同學(xué)可以暫時(shí)忽略）。
4. 組件生命周期。
5. _ 開頭的私有方法。
6. 事件監(jiān)聽方法，handle*。
7. render*開頭的方法，有時(shí)候 render() 方法里面的內(nèi)容會(huì)分開到不同函數(shù)里面進(jìn)行，這些函數(shù)都以 render* 開頭。
8. render() 方法。

如果所有的組件都按這種順序來(lái)編寫，那么維護(hù)起來(lái)就會(huì)方便很多，多人協(xié)作的時(shí)候別人理解代碼也會(huì)一目了然。

下一節(jié)中我們將介紹《React.js 小書 Lesson26 - 實(shí)戰(zhàn)分析：評(píng)論功能（五）》。