diff --git a/modules/ROOT/pages/8.4.0-release-notes.adoc b/modules/ROOT/pages/8.4.0-release-notes.adoc index 9d8d4ba772..d0e3c5e835 100644 --- a/modules/ROOT/pages/8.4.0-release-notes.adoc +++ b/modules/ROOT/pages/8.4.0-release-notes.adoc @@ -120,6 +120,12 @@ For information on using Enhanced Skins & Icon Packs, see: xref:enhanced-skins-a {productname} {release-version} also includes the following addition: +=== New `table_default_header_rows` and `table_default_header_cols` options to set the default header size for new tables +// #TINY-13391 + +In {productname} {release-version}, integrators previously had no way to set default header rows and columns when creating tables through the editor UI. This affected the accessibility of tables and required manual intervention for integrators aiming to meet accessibility standards. The new xref:table-options.adoc#table_default_header_rows[`+table_default_header_rows+`] and xref:table-options.adoc#table_default_header_cols[`+table_default_header_cols+`] options enable integrators to set the number of default header rows and columns for new tables created through the editor's UI, providing a supported way to meet accessibility requirements. + + === // #TINY-vwxyz1 diff --git a/modules/ROOT/pages/table-options.adoc b/modules/ROOT/pages/table-options.adoc index f2a826e75a..96006bef9d 100644 --- a/modules/ROOT/pages/table-options.adoc +++ b/modules/ROOT/pages/table-options.adoc @@ -20,6 +20,10 @@ include::partial$configuration/table_default_attributes.adoc[leveloffset=+1] include::partial$configuration/table_default_styles.adoc[leveloffset=+1] +include::partial$configuration/table_default_header_rows.adoc[leveloffset=+1] + +include::partial$configuration/table_default_header_cols.adoc[leveloffset=+1] + == Interacting with tables include::partial$configuration/table_clone_elements.adoc[leveloffset=+1] diff --git a/modules/ROOT/partials/configuration/table_default_header_cols.adoc b/modules/ROOT/partials/configuration/table_default_header_cols.adoc new file mode 100644 index 0000000000..e070653202 --- /dev/null +++ b/modules/ROOT/partials/configuration/table_default_header_cols.adoc @@ -0,0 +1,18 @@ +[[table_default_header_cols]] +== `+table_default_header_cols+` + +The `+table_default_header_cols+` option sets the number of default header columns for new tables created through the editor UI (for example, via the table picker or insert table dialog). This helps integrators meet accessibility standards by ensuring new tables have header columns by default without manual intervention. + +*Type:* `+Number+` + +*Default value:* `+0+` + +=== Example: using `+table_default_header_cols+` + +[source,js] +---- +tinymce.init({ + selector: 'textarea', // change this value according to your HTML + table_default_header_cols: 1 +}); +---- diff --git a/modules/ROOT/partials/configuration/table_default_header_rows.adoc b/modules/ROOT/partials/configuration/table_default_header_rows.adoc new file mode 100644 index 0000000000..812d519e96 --- /dev/null +++ b/modules/ROOT/partials/configuration/table_default_header_rows.adoc @@ -0,0 +1,18 @@ +[[table_default_header_rows]] +== `+table_default_header_rows+` + +The `+table_default_header_rows+` option sets the number of default header rows for new tables created through the editor UI (for example, via the table picker or insert table dialog). This helps integrators meet accessibility standards by ensuring new tables have header rows by default without manual intervention. + +*Type:* `+Number+` + +*Default value:* `+0+` + +=== Example: using `+table_default_header_rows+` + +[source,js] +---- +tinymce.init({ + selector: 'textarea', // change this value according to your HTML + table_default_header_rows: 1 +}); +----