ガイド: 1.0へのアップグレード Github で編集する

1.0へのアップグレード

Quill 1.0 では、Quill のカスタマイズ機能の向上を目的とした大きな変更が導入されています。インターフェイスは可能な限り同じままであり、それ以外の場合はこのガイドがギャップを埋めるのに役立ちます。

1.0 の利点を最大限に理解するには、Quille 1.0 を新たに捉え、このドキュメント サイトの基本的なトピックにも再アクセスすることをお勧めします。多くの場合、古い方法で物事を行うことができたとしても、より良い新しい方法があることに気づくでしょう。

構成

  • styles 削除されました- 以前のバージョンの Quill では、カスタム CSS を挿入できました。<style>追加。このオプションは次の理由により削除されましたコンテンツセキュリティポリシー。代わりに、外部 CSS を直接使用する必要があります。

API

  • getHTML 削除されました- 以前のバージョンの Quill では、行を識別するためにクラス名を使用する必要がありました。ql-lineid特定の行を識別する属性。これは要件ではなくなり、カスタム API 呼び出しによって DOM の既存の innerHTML に値が追加されることはなくなりました。

  • setHTML 削除されました- Quill は、DOM の上にデータ層を持つ多くのエディターと同様に、基礎となる HTML を任意に変更することを許可しません。以前は Quill が不正な状態を検出して修正していましたが、これにより setHTML という名前が不誠実になり、修正の背後にある理由が直感的ではなくなりました。ほとんどの使用例は、setHTML新しいものを使用すると、適切に対応または改善できます (カーソルの保存がはるかに優れているため)。pasteHTML

  • addModule 削除されました- モジュールは初期 Quill に基づいて初期化されるようになりました構成、別の機能を持つ代わりに。

  • onModuleLoad 削除されました- モジュールの読み込みはテーマによって処理され、同様の動作はテーマを拡張することで実現する必要があります。

  • destroy 削除されました- Quill がエディター インスタンスへの参照を保持しなくなったため、不要になり、JavaScript ガベージ コレクターが期待どおりに動作できるようになりました。

  • prepareFormat 名前が変更されました- 新しい APIformat以前にカバーされていたものも含め、すべての選択状態に対して書式設定機能が提供されるようになりました。prepareFormat

  • 一貫性を保つために、すべての位置はインデックスと長さに基づいていますが、開始と終了の表現は時々使用されます。deleteTextformatTextformatLine、および などの選択 API で使用される Range オブジェクトgetSelectionsetSelection、 そしてそのselection-changeイベント。

  • registerModule 名前が変更されました- 新しい APIregisterすべてのモジュール、テーマ、フォーマットを登録するために使用されるようになりました。

  • require 名前が変更されました- に名前変更されましたimportES6との一貫性を保つため。

  • addContainer 修正された-2番目のパラメータエディターだけでなく、任意のコンテナーの前に挿入できるように変更されました。したがって、オプションのブール値の代わりに、オプションの HTMLElement になりました。

モジュール

  • ツールバーをカスタム HTML 要素で初期化する場合、ボタンは実際の HTMLButtonElement である必要があります。以前は、適切なクラス名を持つ任意の要素が許可されていました。

  • ツールバーは追加または使用されなくなりましたql-format-separatorそして名前を変更しましたql-format-groupql-formats

  • 著者権限およびマルチカーソル モジュールは一時的に削除されました。同様の機能は、個別に、またはバンドルされたコラボレーション モジュールとして、後で再追加される予定です。

  • UndoManager の名前が次のように変更されました。歴史

  • PasteManager の名前が次のように変更されました。クリップボード、カスタムのコピー&ペースト動作を提供します。

  • LinkTooltip はテーマ固有のものに移動されました。を追加して、バブルそしてビデオと数式の場合、リンク用に別のツールチップを独自の一般的な UI 要素として開くことは意味がなくなりました。古いツールチップの動作は Snow にまだ存在していますが、現在はそのテーマに固有のものになっています。

  • ImageTooltip は、よりシンプルでネイティブなフローを優先して削除されました。画像ボタンを押すと OS ファイル ピッカーが開き、選択した画像ファイルが Base64 イメージとしてエディタに挿入されます。

デルタ

デフォルトデルタ一部のコンテンツの表現が変更されました。すべての場合において、入力としてデルタを使用するメソッドでは古い形式が引き続きサポートされます。setContentsupdateContents。ただし、出力されたデルタ(たとえば、text-changegetContents新しい形になります。以来羊皮紙カスタム コンテンツとフォーマットが可能になり、これらのデルタ表現を完全にカスタマイズできるようになりました。

var newImage = {
  insert: { image: 'url' }
};
var oldImage = {
  insert: 1,
  attributes: {
    image: 'url'
  }
};

var newOrderedList = {
  insert: '\n',
  attributes: {
    list: 'ordered'
  }
};
var oldOrderedList = {
  insert: '\n',
  attributes: {
    list: true
  }
};

var newBullettedList = {
  insert: '\n',
  attributes: {
    list: 'bullet'
  }
};
var oldBullettedList = {
  insert: '\n',
  attributes: {
    bullet: true
  }
};

デフォルト

  • Quill は以前、フォント ファミリーとサイズを実装するためにインライン スタイルを使用していました。クラス実装がデフォルトになりました。これを元に戻すには、次を参照してください。コンテンツとフォーマット

ブラウザ

  • Quill は現在、他の主要なオープン ソース ライブラリに続いて、主要なブラウザ リリースの最後の 2 つのバージョンをサポートしています。 IE9 と IE10 のサポートが終了し、MS Edge が追加されました。

  • Android ブラウザのサポートは、Google が段階的にサポートを終了した標準の Android ブラウザではなく、Android 上の Chrome に適用されるようになりました。

改善点

  • 新しい形式やコンテンツを追加したり、既存のものを変更したりする機能羊皮紙。

  • ネストされたリスト、上付き文字、下付き文字、インライン コード、コード ブロック、ヘッダー、ブロック引用符、テキスト方向、ビデオ、およびフォーラムのサポートのサポートが追加されました。

  • インライン スタイルの代わりにクラスを使用して書式設定する機能。

  • と呼ばれる新しいツールチップベースのテーマバブル

  • 改善されましたツールバーフォーマット配列による初期化とカスタム値によるカスタマイズ。

  • ツールバーのアイコンでは、インライン PNG の代わりに SVG が使用されるようになり、明瞭さを維持しながらアイコンのサイズを自由に変更できるようになりました。 CSS を使用して、デフォルトの #06c 青の代わりにアクティブ状態の色を簡単に変更することもできるようになりました。

  • ペーストの解釈をカスタマイズする機能の向上クリップボード

  • カスタマイズ機能の向上キーボードハンドラー

  • プレースホルダー構成オプション。

  • 編集可能構文強調表示されたコードブロック。

  • いくつかの新しいAPI

  • 非常に多くのバグ修正。


オープンソースプロジェクト

Quill は次によって開発および保守されています。スラブ。 BSD の下で寛容にライセンスされています。個人または商業プロジェクトで自由に使用してください。
8,000