React.js 小書 Lesson25 - 實戰(zhàn)分析:評論功能(四)
轉載請注明出處,保留原文鏈接以及作者信息
在線閱讀:http://huziketang.com/books/react
目前為止,第二階段知識已經基本介紹完,我們已經具備了項目上手實戰(zhàn)必備的 React.js 知識,現(xiàn)在可以把這些知識應用起來。接下來是實戰(zhàn)環(huán)節(jié),我們會繼續(xù)上一階段的例子,把評論功能做得更加復雜一點。
我們在上一階段的評論功能基礎上加上以下功能需求:
- 頁面加載完成自動聚焦到評論輸入框。
- 把用戶名持久化,存放到瀏覽器的 LocalStorage 中。頁面加載時會把用戶名加載出來顯示到輸入框,用戶就不需要重新輸入用戶名了。
- 把已經發(fā)布的評論持久化,存放到瀏覽器的 LocalStorage 中。頁面加載時會把已經保存的評論加載出來,顯示到頁面的評論列表上。
- 評論顯示發(fā)布日期,如“1 秒前”,”30 分鐘前”,并且會每隔 5 秒更新發(fā)布日期。
- 評論可以被刪除。
- 類似 Markdown 的行內代碼塊顯示功能,用戶輸入的用 `` 包含起來的內容都會被處理成用
<code>元素包含。例如輸入 `console.log` 就會處理成<code>console.log</code>再顯示到頁面上。
[圖片上傳失敗...(image-177052-1510227040222)]
大家可以在原來的第一階段代碼的基礎上進行修改,第一、二階段評論功能代碼可以在這里找到: react-naive-book-examples??梢灾苯邮褂米钚碌臉邮轿募?index.css 覆蓋原來的 index.css。
接下來可以分析如何利用第二階段的知識來構建這些功能,在這個過程里面可能會穿插一些小技巧,希望對大家有用。我們回顧一下這個頁面的組成:
[圖片上傳失敗...(image-13ca3-1510227040222)]
我們之前把頁面分成了四種不同的組件:分別是 CommentApp 、CommentInput、CommentList、Comment。我們開始修改這個組件,把上面的需求逐個完成。
自動聚焦到評論框
這個功能是很簡單的,我們需要獲取 textarea 的 DOM 元素然后調用 focus() API 就可以了。我們給輸入框元素加上 ref 以便獲取到 DOM 元素,修改 src/CommentInput.js 文件:
...
<textarea
ref={(textarea) => this.textarea = textarea}
value={this.state.content}
onChange={this.handleContentChange.bind(this)} />
...
組件掛載完以后完成以后就可以調用 this.textarea.focus(),給 CommentInput 組件加上 ComponentDidMount 生命周期:
class CommentInput extends Component {
static propTypes = {
onSubmit: PropTypes.func
}
constructor () {
super()
this.state = {
username: '',
content: ''
}
}
componentDidMount () {
this.textarea.focus()
}
...
這個功能就完成了?,F(xiàn)在體驗還不是很好,接下來我們把用戶名持久化一下,體驗就會好很多。
大家可以注意到我們給原來的 props.onSubmit 參數(shù)加了組件參數(shù)驗證,在這次實戰(zhàn)案例中,我們都會給評論功能的組件加上 propTypes 進行參數(shù)驗證,接下來就不累述。
持久化用戶名
用戶輸入用戶名,然后我們把用戶名保存到瀏覽器的 LocalStorage 當中,當頁面加載的時候再從 LocalStorage 把之前保存的用戶名顯示到用戶名輸入框當中。這樣用戶就不用每次都輸入用戶名了,并且評論框是自動聚焦的,用戶的輸入體驗就好很多。
我們監(jiān)聽用戶名輸入框失去焦點的事件 onBlur:
...
<input
value={this.state.username}
onBlur={this.handleUsernameBlur.bind(this)}
onChange={this.handleUsernameChange.bind(this)} />
...
在 handleUsernameBlur 中我們把用戶的輸入內容保存到 LocalStorage 當中:
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 中我們把用戶輸入的內容傳給了 _saveUsername 私有方法(所有私有方法都以 _ 開頭)。_saveUsername 會設置 LocalStorage 中的 username 字段,用戶名就持久化了。這樣就相當于每當用戶輸入完用戶名以后(輸入框失去焦點的時候),都會把用戶名自動保存一次。
輸入用戶名,然后到瀏覽器里里面看看是否保存了:
[圖片上傳失敗...(image-2c3315-1510227040222)]
然后我們組件掛載的時候把用戶名加載出來。這是一種數(shù)據(jù)加載操作,我們說過,不依賴 DOM 操作的組件啟動的操作都可以放在 componentWillMount 中進行,所以給 CommentInput 添加 componentWillMount 的組件生命周期:
...
componentWillMount () {
this._loadUsername()
}
_loadUsername () {
const username = localStorage.getItem('username')
if (username) {
this.setState({ username })
}
}
_saveUsername (username) {
localStorage.setItem('username', username)
}
...
componentWillMount 會調用 _loadUsername 私有方法,_loadUsername 會從 LocalStorage 加載用戶名并且 setState 到組件的 state.username 中。那么組件在渲染的時候(render 方法)掛載的時候就可以用上用戶名了。
這樣體驗就好多了,刷新頁面,不需要輸入用戶名,并且自動聚焦到了輸入框。我們 1、 2 需求都已經完成。
小貼士
這里插入一些小貼示,大家可以注意到我們組件的命名和方法的擺放順序其實有一定的講究,這里可以簡單分享一下個人的習慣,僅供參考。
組件的私有方法都用 _ 開頭,所有事件監(jiān)聽的方法都用 handle 開頭。把事件監(jiān)聽方法傳給組件的時候,屬性名用 on 開頭。例如:
<CommentInput
onSubmit={this.handleSubmitComment.bind(this)} />
這樣統(tǒng)一規(guī)范處理事件命名會給我們帶來語義化組件的好處,監(jiān)聽(on)CommentInput 的 Submit 事件,并且交給 this 去處理(handle)。這種規(guī)范在多人協(xié)作的時候也會非常方便。
另外,組件的內容編寫順序如下:
- static 開頭的類屬性,如
defaultProps、propTypes。 - 構造函數(shù),
constructor。 - getter/setter(還不了解的同學可以暫時忽略)。
- 組件生命周期。
-
_開頭的私有方法。 - 事件監(jiān)聽方法,
handle*。 -
render*開頭的方法,有時候render()方法里面的內容會分開到不同函數(shù)里面進行,這些函數(shù)都以render*開頭。 -
render()方法。
如果所有的組件都按這種順序來編寫,那么維護起來就會方便很多,多人協(xié)作的時候別人理解代碼也會一目了然。
下一節(jié)中我們將介紹《React.js 小書 Lesson26 - 實戰(zhàn)分析:評論功能(五)》。