react draft api 简介
draft.js api
https://draftjs.org/docs/quic...
基礎API
這個文檔提供了一些基礎的draftapi概覽。
Controlled Input
Editor組件構建了一個可控的可編輯的組件。這個組件提供了一個頂級api模型與react的可控Input組件相似的api.
做一個簡短的回顧,可控input組件包括兩個關鍵:
1.一個value代表input的狀態
2.一個onChange函數屬性,使input更新。
這個方法允許組合input組件來嚴格控制Input的狀態,于此同時仍然允許更新DOM來展示用戶已經輸入的信息。
頂級的組件能通過value屬性的state值來保持控制輸入狀態。
Controlling Rich Text
在react富文本腳本中有兩個顯著的問題:
1.一段純文本不足以展示富文本編輯器的復雜狀態
2.在可編輯的元素總,沒有像onChange的這樣的事件可用。
State因此被表示為一個不可變的EditorState對象。并且onChange被Editor的內部代碼實現來提供一個state的值給上層。
這個EditorState對象是一個復雜的Editor的 state的快照。包括內容,光標和撤消/重做歷史記錄。所有在編輯器內部對內容和選擇的修改都會創建一個新的EditorState對象。請注意,由于不可變對象上的數據持續存在,這仍然是有效的。
對于在編輯器DOM中發生的任何編輯或選擇更改,您的onChange處理程序將根據這些更改使用最新的EditorState對象執行。
Rich Styling
現在我們已經確定了基本的頂層api,我們可以進一步的思考怎么可以給Draft編輯器添加一些基本的樣式。
EditorState: Yours to Command
以前的文章介紹了EditorState對象作為編輯器的完整狀態的快照,由編輯器核心通過onChange支持提供。
然而,你的頂層的React組件是負責維護狀態的,你還可以以任何你認為合適的方式將更改應用于該EditorState對象。
對于inline和block樣式,例如,RichUntils模塊提供了一些可用的方法來幫助操作這些狀態。
相似的,Modifier模塊也提供了一些常見的操作來使你的編輯生效,包括對文本,樣式的修改等等。這個模塊是一系列由更小的,更簡單的編輯函數組成的編輯函數來返回所需的EditorState對象。
對于這個例子,我們將堅持使用RichUtils來演示如何在頂級組件中應用基本的豐富樣式。
RichUtils and Key Commands
RichUtils 有一些對于web編輯器來說可用的核心關鍵命令,例如: Cmd+B (加粗), Cmd+I (斜體), 等等.
我們可以觀察并且處理關鍵命令通過我們可以通過handleKeyCommand prop來觀察和處理關鍵命令,并將它們綁定到RichUtils中以應用或刪除所需的樣式。
handleKeyCommand
傳給handleKeyCommand的command參數是一個字符串值,即需要被運行命令的名字。這是從DOM鍵盤事件映射的。
Styling Controls in UI
在React組件中,你可以添加按鈕或者其他的控制來允許用戶在編輯器中修改文本樣式。
總結
以上是生活随笔為你收集整理的react draft api 简介的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: Java SHAA加密
- 下一篇: 往篇博文更新日志