Skip to content

DOC-2628: Documentation Enhancement: Enhanced Table #3871

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
kemister85 merged 2 commits into from
Sep 29, 2025
Merged

DOC-2628: Documentation Enhancement: Enhanced Table #3871

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
314177b
DOC-2628: Documentation Enhancement: Enhanced Table.
abhinavgandham Sep 29, 2025
33d7cf8
Update modules/ROOT/pages/advtable.adoc
kemister85 Sep 29, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 4 additions & 6 deletions modules/ROOT/pages/advtable.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,15 +9,12 @@

include::partial$misc/admon-premium-plugin.adoc[]

[TIP]
As of {productname} 7.0, the Advanced Tables plugin is now named {pluginname}. When using the {pluginname} plugin in your editor, continue to use {plugincode} in the `+plugins+` list.

The `+advtable+` plugin is a premium plugin that extends the core xref:table.adoc[`+table+` plugin] by adding the following advanced functionality:

* Sort options for rows and columns.
* Row numbering column for tables.

== Try our Enhanced Tables Demo
== Interactive demo

liveDemo::advtable[]

Expand All @@ -35,12 +32,13 @@ tinymce.init({
});
----


== Sorting table rows and columns

Tables can be sorted by row or column values using:

* The *Sort* options in the *Table* menu.
* The *Sort* options in the table contextual menu.
* The *Sort* options in the *Table* contextual menu.
* The *Sort* options in the *Table* toolbar menu button.

*For example:*
Expand All @@ -66,7 +64,7 @@ A numeric and alpha value series are available by default. The available value s

image::advtable-row-numbering.png[Table with numeric row numbering column and row numbering menu open (Numeric item checked)]

A commonly desired customisation of the row-numbering column is that a table’s header and footer rows not be included in the numbering.
A commonly desired customization of the row-numbering column is that a table’s header and footer rows not be included in the numbering.

This can be done using the xref:advtable_value_series[`+advtable_value_series+` option] to specify a custom generator.

Expand Down
7 changes: 3 additions & 4 deletions modules/ROOT/partials/configuration/advtable_value_series.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -125,9 +125,9 @@ tinymce.init({
update: true,
resizable: false,
generator: function(info, rowIndex, colIndex) {
var prevCount = info.prev ? info.prev.count : 0;
let prevCount = info.prev ? info.prev.count : 0;
if (info.sectionType === 'tbody' && info.cellType === 'td') {
var newCount = prevCount + 1;
let newCount = prevCount + 1;
return {
value: newCount,
count: newCount
Expand All @@ -147,5 +147,4 @@ With this custom generator, when a table with a header and footer row already se

image::advtable-row-numbered-table-with-un-numbered-header-and-footer-rows.png[Row-numbered table with un-numbered header and footer rows]

NOTE: This simple custom generator is a demonstration. It has limitations. Perhaps most significant, it requires the header and footer rows be set _before_ row numbers are added to a table. If row numbers are added and then a header row, or a footer row, or both, are set, this generator will _not_ remove existing row numbers from the now-set header and footer rows.

NOTE: This simple custom generator is a demonstration. It has limitations. Perhaps most significant, it requires the header and footer rows be set *before* row numbers are added to a table. If row numbers are added and then a header row, or a footer row, or both, are set, this generator will *not* remove existing row numbers from the now-set header and footer rows.