Skip to content

Renames and API improvements for html table wrappers #24264

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

Open
mstahv wants to merge 12 commits into
base: main
Choose a base branch
from
Open

Renames and API improvements for html table wrappers #24264

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
0a7e9cc
feat: introduce Table API with spec-compliant child types
mstahv May 5, 2026
f29a108
feat: add colgroup, shared TableCell base, caption/row-header shortcuts
mstahv May 5, 2026
57fb4f7
feat: add headers attribute helpers to TableCell
mstahv May 5, 2026
37340ff
docs: flesh out javadocs for new Table API
mstahv May 5, 2026
0b8e31a
style: spotless reformat of Native* and Table sibling files
mstahv May 5, 2026
d5f1ab8
refactor: rename TableRow.getAllCells() to getCells()
mstahv May 5, 2026
5e487f0
feat: add Table.getRows() and Table.removeAllRows() shortcuts
mstahv May 5, 2026
769b251
refactor: tighten TableRow cell types from Component to TableCell
mstahv May 5, 2026
10e6fef
refactor: drop redundant indexed accessors on TableRow
mstahv May 5, 2026
27a049e
refactor: drop redundant indexed accessors from Table and TableRowCon…
mstahv May 5, 2026
8fd2e41
feat: TableRow constructor and addCells auto-wrap non-cell components
mstahv May 5, 2026
bc0c26a
feat: List overloads for every varargs method/constructor in Table API
mstahv May 5, 2026
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: 10 additions & 0 deletions flow-html-components/src/main/java/com/vaadin/flow/component/html/NativeTable.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,9 +26,19 @@

/**
* Component representing a <code>&lt;table&gt;</code> element.
* <p>
* <b>Deprecated.</b> This component extends {@link HtmlContainer} and therefore
* exposes a generic {@code add(Component)} API that allows constructing
* structurally invalid tables. Use {@link Table} instead, which extends
* {@link com.vaadin.flow.component.HtmlComponent} and exposes only
* spec-compliant operations (see
* <a href="https://html.spec.whatwg.org/multipage/tables.html">WHATWG
* HTML</a>).
*
* @since 24.4
* @deprecated since 25.2; use {@link Table} instead.
*/
@Deprecated
@Tag(Tag.TABLE)
public class NativeTable extends HtmlContainer
implements ClickNotifier<NativeTable> {
Expand Down
2 changes: 2 additions & 0 deletions flow-html-components/src/main/java/com/vaadin/flow/component/html/NativeTableBody.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,9 @@
* Component representing a <code>&lt;tbody&gt;</code> element.
*
* @since 24.4
* @deprecated since 25.2; use {@link TableBody} instead.
*/
@Deprecated
@Tag(Tag.TBODY)
public class NativeTableBody extends HtmlContainer
implements NativeTableRowContainer, ClickNotifier<NativeTableBody> {
Expand Down
2 changes: 2 additions & 0 deletions flow-html-components/src/main/java/com/vaadin/flow/component/html/NativeTableCaption.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,9 @@
* Represents the table caption element ({@code <caption>}).
*
* @since 24.4
* @deprecated since 25.2; use {@link TableCaption} instead.
*/
@Deprecated
@Tag(Tag.CAPTION)
public class NativeTableCaption extends HtmlContainer {
}
2 changes: 2 additions & 0 deletions flow-html-components/src/main/java/com/vaadin/flow/component/html/NativeTableCell.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,9 @@
* Component representing a <code>&lt;td&gt;</code> element.
*
* @since 24.4
* @deprecated since 25.2; use {@link TableDataCell} instead.
*/
@Deprecated
@Tag(Tag.TD)
public class NativeTableCell extends HtmlContainer
implements ClickNotifier<NativeTableCell> {
Expand Down
2 changes: 2 additions & 0 deletions flow-html-components/src/main/java/com/vaadin/flow/component/html/NativeTableFooter.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,9 @@
* Component representing a <code>&lt;tfoot&gt;</code> element.
*
* @since 24.4
* @deprecated since 25.2; use {@link TableFoot} instead.
*/
@Deprecated
@Tag(Tag.TFOOT)
public class NativeTableFooter extends HtmlContainer
implements NativeTableRowContainer, ClickNotifier<NativeTableFooter> {
Expand Down
2 changes: 2 additions & 0 deletions flow-html-components/src/main/java/com/vaadin/flow/component/html/NativeTableHeader.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,9 @@
* Component representing a <code>&lt;thead&gt;</code> element.
*
* @since 24.4
* @deprecated since 25.2; use {@link TableHead} instead.
*/
@Deprecated
@Tag(Tag.THEAD)
public class NativeTableHeader extends HtmlContainer
implements NativeTableRowContainer, ClickNotifier<NativeTableHeader> {
Expand Down
2 changes: 2 additions & 0 deletions flow-html-components/src/main/java/com/vaadin/flow/component/html/NativeTableHeaderCell.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,9 @@
* Component representing a <code>&lt;th&gt;</code> element.
*
* @since 24.4
* @deprecated since 25.2; use {@link TableHeaderCell} instead.
*/
@Deprecated
@Tag(Tag.TH)
public class NativeTableHeaderCell extends HtmlContainer
implements ClickNotifier<NativeTableHeaderCell> {
Expand Down
2 changes: 2 additions & 0 deletions flow-html-components/src/main/java/com/vaadin/flow/component/html/NativeTableRow.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,9 @@
* Component representing a <code>&lt;tr&gt;</code> element.
*
* @since 24.4
* @deprecated since 25.2; use {@link TableRow} instead.
*/
@Deprecated
@Tag(Tag.TR)
public class NativeTableRow extends HtmlContainer
implements HasOrderedComponents, ClickNotifier<NativeTableRow> {
Expand Down
4 changes: 4 additions & 0 deletions ...html-components/src/main/java/com/vaadin/flow/component/html/NativeTableRowContainer.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,11 @@
* A container of <code>&lt;tr&gt;</code> elements.
*
* @since 24.4
* @deprecated since 25.2; use {@link TableRowContainer} (and the corresponding
* {@link TableHead}, {@link TableBody}, and {@link TableFoot}
* components) instead.
*/
@Deprecated
interface NativeTableRowContainer extends HasOrderedComponents {

/**
Expand Down
Loading
Loading