# 配置項
Quill允許通過多種方式來定制它以適應你的需求。本節致力于調整現有的功能。請參閱[模塊(Modules)](http://www.hmoore.net/dissembler/quill/913594)部分添加新功能和[主題(Themes)](http://www.hmoore.net/dissembler/quill/913600)添加主題。
## 容器
Quill需要在編輯器中追加一個容器。你可以傳入css選擇器或者DOM對象。
~~~
var editor = new Quill('.editor'); // 將使用第一個匹配的元素
~~~
~~~
var container = document.getElementById('editor'); //通過id選擇器獲取對象
var editor = new Quill(container);
~~~
~~~
var container = $('.editor').get(0); //類選擇器獲取對象
var editor = new Quill(container);
~~~
## 配置項
通過傳入一個配置項對象來配置Quill。
~~~
var options = {
debug: 'info', //調試信息打印選項
modules: {
toolbar: '#toolbar'
},
placeholder: 'Compose an epic...', //編輯器無內容時占位符
readOnly: true, //只讀模式
theme: 'snow', //主題
formats:['bold','italic'], //格式白名單
};
var editor = new Quill('#editor', options);
~~~
以下的配置參數會被識別:
**bounds**
* Default:`document.body`
DOM元素或者一個DOM元素的css選擇器,其中編輯器的UI元素(例如:tooltips)應該被包含其中。目前,只考慮左右邊界。
**debug**
* Default:`warn`
* Options:['error', 'warn', 'log', 'info']
debug的開關。注意:`debug`是一個靜態方法并且會影響同一個頁面的其它編輯器實例。只有警告和錯誤信息是默認啟用的。
**formats**
* Default:All formats
在編輯器中允許的格式白名單。請參閱[格式化](http://www.hmoore.net/dissembler/quill/913584)以獲取完整列表。
**modules**
包含的模塊和相應的選項。請參閱[模塊](http://www.hmoore.net/dissembler/quill/913594)以獲取更多信息。
**placeholder**
* Default:none
編輯器為空時顯示的占位符。
**readOnly**
* Default:`false`
是否將編輯器是實例設置為只讀模式。
**scrollingContainer**
* Default:`null`
DOM元素或者一個DOM元素的css選擇器,指定該容器具有滾動條(例如:`overflow-y: auto`),如果已經被用戶自定義了默認的`ql-editor`。當Quill設置為自動適應高度時,需要修復滾動跳轉的bug,并且另一個父容器負責滾動。
> 注意:當使用body時,一些瀏覽器仍然會跳轉。可以使用一個單獨的div子節點來避免這種情況。
**theme**
使用的主題名稱。內置的選項有“bubble”和“snow”。無效或者假的值將加載默認的最小主題。注意:主題的特定樣式仍然需要手動包含。請參閱[主題](http://www.hmoore.net/dissembler/quill/913600)了解更多信息。