feat(block-kit): add data_table layout block by zimeg · Pull Request #1613 · slackapi/java-slack-sdk

zimeg · 2026-06-26T23:51:10Z

This pull request adds the data_table layout block to the Java SDK model.

DataTableBlock (data_table) with rows, caption, pageSize, rowHeaderColumnIndex, and blockId.
A shared TableCell interface in com.slack.api.model.block.composition, so rows is List<List<TableCell>>.
RawTextObject (raw_text) and RawNumberObject (raw_number) composition objects that implement TableCell, matching python's RawTextObject/RawNumberObject.
ActionCellObject (action_cell) implements TableCell with a ButtonElement element and an optional fallback (raw_text or raw_number) for clients without action cell support. Action cells only work in data_table, not table.
RichTextBlock (rich_text) now also implements TableCell.
GsonTableCellFactory deserializes cells by type, and unknown cell types parse as UnknownTableCell unless failOnUnknownProperties is set, matching UnknownBlock and UnknownTextObject. It's registered for TableCell in the client GsonFactory and the model test GsonFactory.
DataTableBlock is registered in GsonLayoutBlockFactory.
Builder helpers: Blocks.dataTable(...), plus BlockCompositions.actionCell(...), BlockCompositions.rawText(...) and BlockCompositions.rawNumber(...).
BlockKitTest parses and builds a data_table with all four cell types, and covers unknown cell types.

The table block in #1611 builds on these shared cell types.

Kotlin DSL support is left for a follow-up that covers every block the Kotlin extension doesn't have yet.

Testing

Post a message with a data_table block using chat.postMessage:

import static com.slack.api.model.block.Blocks.*;
import static com.slack.api.model.block.composition.BlockCompositions.*;

ChatPostMessageResponse response = slack.methods(token).chatPostMessage(r -> r
    .channel(channelId)
    .text("A data table")
    .blocks(asBlocks(dataTable(t -> t
        .caption("Quarterly results")
        .pageSize(5)
        .rows(Arrays.asList(
            Arrays.asList(rawText("Team"), rawText("Revenue")),
            Arrays.asList(rawText("Platform"), rawNumber(1234.5, "$1,234.50"))
        ))))));

Confirm response.isOk() and that the table renders in the channel with the caption, a header row, and pagination.
Read the message back with conversations.history and confirm the block parses as a DataTableBlock with RawTextObject and RawNumberObject cells.

🤖 Generated with Claude Code

Add the new `data_table` Block Kit layout block to the model: DataTableBlock plus its cell model (DataTableCell interface with RawTextDataTableCell, RawNumberDataTableCell, and RichTextBlock for rich_text cells), the GsonDataTableCellFactory deserializer, factory registration, and a `dataTable` builder DSL entry. Ref: https://docs.slack.dev/reference/block-kit/blocks/data-table-block Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>

codecov · 2026-06-26T23:57:43Z

Codecov Report

❌ Patch coverage is 71.42857% with 8 lines in your changes missing coverage. Please review.
✅ Project coverage is 73.72%. Comparing base (849d3f7) to head (75b0c01).
✅ All tests successful. No failed tests found.

Files with missing lines	Patch %	Lines
...api/model/block/composition/BlockCompositions.java	0.00%	6 Missing ⚠️
.../com/slack/api/util/json/GsonTableCellFactory.java	89.47%	2 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff              @@
##               main    #1613      +/-   ##
============================================
- Coverage     73.73%   73.72%   -0.01%     
- Complexity     4676     4687      +11     
============================================
  Files           487      488       +1     
  Lines         14667    14695      +28     
  Branches       1528     1529       +1     
============================================
+ Hits          10814    10834      +20     
- Misses         2944     2952       +8     
  Partials        909      909

Flag	Coverage Δ
jdk-14	`73.72% <71.42%> (-0.01%)`	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

…table # Conflicts: # slack-api-model/src/main/java/com/slack/api/util/json/GsonLayoutBlockFactory.java # slack-api-model/src/test/java/test_locally/api/model/block/BlockKitTest.java

Mirror the reviewed node SDK PR (slackapi/node-slack-sdk#2638): - Correct the max row count: the model previously stated up to 100 data rows (101 including header); the reference documents 201 rows (200 data rows plus header). The 100 cap was page_size, not the row maximum. Drop the stale count from the javadoc rather than restate it. - Align each field's javadoc with the data-table-block reference Fields table verbatim (rows, caption, page_size, row_header_column_index). - Trim RawTextDataTableCell / RawNumberDataTableCell to the terse, docs-minimal descriptions (drop the invented sorting/formatting tails); document value and text per the docs. Ref: https://docs.slack.dev/reference/block-kit/blocks/data-table-block Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>

Blocks.java keeps the recently-added blocks (Alert, Card, Carousel, Container, TaskCard) in a cluster at the end rather than slotting them alphabetically into the original core entries. Move the dataTable(...) builder into that cluster (after container, before taskCard) so a net-new block sits with its peers instead of splitting the old core from the new group. Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>

…ta_table The data_table cells (raw_text / raw_number / rich_text) are the same cell model the table block uses. Rather than ship a parallel DataTableCell family, adopt the shared TableCell interface and its RawTextTableCell / RawNumberTableCell implementations in com.slack.api.model.block.composition, deserialized by a single GsonTableCellFactory: - Remove DataTableCell, RawTextDataTableCell, RawNumberDataTableCell, and GsonDataTableCellFactory. - Add TableCell, RawTextTableCell, RawNumberTableCell (in ...block.composition) and GsonTableCellFactory (in ...util.json). - DataTableBlock.rows is now List<List<TableCell>>; RichTextBlock implements TableCell; the client and model-test GsonFactory register TableCell -> GsonTableCellFactory. This is the same cell model the sibling table-block PR (#1611) introduces, placed in the same package with identical definitions, so whichever of the two lands second drops the now-duplicate files in a trivial merge. Mirrors how node (@slack/types composition objects) and python (slack_sdk basic_components) also share one cell model across both blocks. Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>

…bject Rename the concrete TableCell implementations from RawTextTableCell / RawNumberTableCell to RawTextObject / RawNumberObject, matching the composition-object naming used by the other SDKs (python RawTextObject / RawNumberObject) and this repo's own ...Object grammar (PlainTextObject, MarkdownTextObject, OptionObject). The shared TableCell interface is the supertype the list is parameterized on (Java has no union types, so List<List<TableCell>> is how the raw_text | raw_number | rich_text union is expressed); only the implementation names change. Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>

…import - GsonLayoutBlockFactory: move the DataTableBlock case into alphabetical order (between ContextBlock and DividerBlock) instead of after SectionBlock. - RichTextBlock: import com.slack.api.model.block.composition.TableCell and use the simple name in the implements clause rather than the fully qualified type inline. Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>

The raw_number schema marks text as required (required: [type, value, text], text minLength 1) — the javadoc wrongly called it optional. Match the schema: text carries the display representation of the value and must be at least one character long. Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>

Keep the text-is-display + min-length note, drop the "(for example a formatted string)" aside. Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>

Restructure RawNumberObject and RawTextObject to per-field javadoc, mirroring the node @slack/types descriptions and matching this repo's own per-field convention (OptionObject, ConfirmationDialogObject): - class: "Defines an object containing a numeric value." / "...some text." - value: "The numeric value." - text (number): "The text used to display the value. The minimum length is 1 character." - text (text): "The text for the block. The minimum length is 1 character." Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>

Add BlockCompositions.rawText(...) and rawNumber(...) factory helpers for the raw table cell objects, mirroring the plainText / markdownText DSL (configurator overload plus a convenience overload). Gives callers an ergonomic way to build data_table / table cells without the raw builder. Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>

…Text Use the BlockCompositions.rawText(...) helper for the raw_text cells instead of RawTextObject.builder(), per the block-kit AGENTS.md guidance to build composition objects through BlockCompositions.* rather than raw builders. Depends on the rawText/rawNumber helpers added in slackapi/java-slack-sdk#1613. Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>

RawNumberObject.value is a (nullable) Double; the two-arg rawNumber convenience overload took a primitive double, narrowing the model's type. Use Double so the helper mirrors the field exactly. Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>

zimeg

☕ Ideas to share where included I callout a pattern I'm uncertain of around rawText and rawNumber!

zimeg · 2026-09-09T03:18:48Z

🦠 note: I have some confidence this is a consistent shared type but it's not clear if it's meant to be stable because it's not in reference. Hoping to add this here and #1611 for shared implementation!

zimeg · 2026-09-09T04:17:32Z

+    // RawNumberObject
+
+    public static RawNumberObject rawNumber(ModelConfigurator<RawNumberObject.RawNumberObjectBuilder> configurator) {
+        return configurator.configure(RawNumberObject.builder()).build();
+    }
+
+    public static RawNumberObject rawNumber(Double value, String text) {
+        return RawNumberObject.builder().value(value).text(text).build();
+    }


👁️‍🗨️ note: These introduce helper functions to BlockComposition that aren't documented but IMHO are helpful for:

- RawTextObject.builder().text("Name").build() + BlockCompositions.rawText("Name"),

zimeg

🦐 Solid but some notes and questions before requesting actual review.

zimeg · 2026-11-06T01:26:50Z

+    /**
+     * A raw_text or raw_number cell.
+     */
+    private TableCell fallback;


🔭 note: This might be generic to other table cells but we leave validation to the API here.

@see

Save the table block @see links for the table block PR and move the data_table tests to their alphabetical position before task_card. Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com> Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

zimeg

📣 More idea

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com> Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

zimeg and others added 2 commits September 8, 2026 17:15

Merge remote-tracking branch 'origin/main' into chore/block-kit-data-…

a6cc250

…table # Conflicts: # slack-api-model/src/main/java/com/slack/api/util/json/GsonLayoutBlockFactory.java # slack-api-model/src/test/java/test_locally/api/model/block/BlockKitTest.java

zimeg self-assigned this Sep 9, 2026

zimeg added enhancement M-T: A feature request for new functionality semver:minor project:slack-api-model project:slack-api-model project:slack-api-client project:slack-api-client labels Sep 9, 2026

zimeg marked this pull request as ready for review September 9, 2026 00:16

zimeg requested a review from a team as a code owner September 9, 2026 00:16

zimeg marked this pull request as draft September 9, 2026 00:19

zimeg and others added 7 commits September 8, 2026 17:22

docs(block-kit): drop the parenthetical example from RawNumberObject

e417c31

Keep the text-is-display + min-length note, drop the "(for example a formatted string)" aside. Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>

zimeg mentioned this pull request Sep 9, 2026

feat(block-kit): add data table block example slack-samples/bolt-java-examples#82

Draft

zimeg commented Sep 9, 2026

View reviewed changes

zimeg marked this pull request as ready for review September 9, 2026 04:22

zimeg added this to the 1.51.1 milestone Sep 9, 2026

zimeg modified the milestones: 1.52.0, 1.52.1 Oct 1, 2026

zimeg modified the milestones: 1.52.1, 1.53.1 Oct 30, 2026

Merge branch 'main' into chore/block-kit-data-table

088b3db

zimeg modified the milestones: 1.54.0, 1.54.1 Nov 5, 2026

zimeg added 2 commits November 5, 2026 11:38

Merge branch 'main' into chore/block-kit-data-table

e9dd2b0

Merge branch 'main' into chore/block-kit-data-table

3bea79a

zimeg marked this pull request as draft November 5, 2026 22:50

zimeg mentioned this pull request Nov 5, 2026

feat(model): add table Block Kit block #1611

Open

feat(block-kit): support action_cell in data_table rows

dcac25b

zimeg mentioned this pull request Nov 5, 2026

feat(types): support action_cell cells in data_table rows slackapi/node-slack-sdk#2826

Draft

2 tasks done

zimeg commented Nov 6, 2026

View reviewed changes

Comment thread slack-api-model/src/test/java/test_locally/api/model/block/BlockKitTest.java Resolved

zimeg and others added 4 commits November 5, 2026 20:12

test: inline the action cell json in each data_table test

3390832

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com> Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

test: drop the extra action cell without fallback test

75a408b

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com> Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

test: trim extra action cell tests and inline the unknown cell json

47fb8d0

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com> Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

test: fold the action cell into the data_table parse and build tests

75b0c01

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com> Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

zimeg marked this pull request as ready for review November 6, 2026 04:34

Navigation Menu

Repository navigation

feat(block-kit): add data_table layout block - #1613

feat(block-kit): add data_table layout block#1613
zimeg wants to merge 21 commits into
mainfrom
chore/block-kit-data-table

zimeg commented Jun 26, 2026 •

edited

Loading

Uh oh!

codecov Bot commented Jun 26, 2026 •

edited

Loading

Uh oh!

zimeg left a comment

Uh oh!

zimeg Sep 9, 2026

Uh oh!

Uh oh!

zimeg Sep 9, 2026

Uh oh!

zimeg left a comment

Uh oh!

zimeg Nov 6, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

zimeg left a comment

Uh oh!

Uh oh!

This branch has not been deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

zimeg commented Jun 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Testing

Uh oh!

codecov Bot commented Jun 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

zimeg left a comment

Choose a reason for hiding this comment

Uh oh!

zimeg Sep 9, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

zimeg Sep 9, 2026

Choose a reason for hiding this comment

Uh oh!

zimeg left a comment

Choose a reason for hiding this comment

Uh oh!

zimeg Nov 6, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

zimeg left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

This branch has not been deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

zimeg commented Jun 26, 2026 •

edited

Loading

codecov Bot commented Jun 26, 2026 •

edited

Loading