8
0
Просмотр исходного кода

Update injectTableHeadingRowsRefreshPostFixer() documentation.

Maciej Gołaszewski 5 лет назад
Родитель
Сommit
13c9fd8122

+ 4 - 3
packages/ckeditor5-table/src/converters/table-heading-rows-refresh-post-fixer.js

@@ -10,10 +10,11 @@
 /**
  * Injects a table post-fixer into the model which marks the table in the differ to have it re-rendered.
  *
- * Table heading rows are represented in model just by `headingRows` attribute but in the view it's rendered as separate
- * sections of the table (`thead`, `tbody`) so any change of that attribute would trigger a lot changes in view.
+ * Table heading rows are represented in the model by a `headingRows` attribute. However, in the view, it's represented as separate
+ * sections of the table (`<thead>` or `<tbody>`) and changing `headingRows` attribute requires moving table rows between two sections.
+ * This causes problems with structural changes in a table (like adding and removing rows) thus atomic converters cannot be used.
  *
- * When table `headingRows` attribute changes, entire table is re-rendered.
+ * When table `headingRows` attribute changes, the entire table is re-rendered.
  *
  * @param {module:engine/model/model~Model} model
  */