References to computationally-generated sub-tables/sub-figures

[connorp]

Per the docs, we can create sub-tables and sub-figures with captions and cross-references if we create them manually. We can also create sub-tables and sub-figures programmatically, including specifying sub-captions. However, it's not clear to me whether I can reference those sub-figures/tables. I tried something like this:

```{r}
#| label: many-tables
#| tbl-cap: So many tables!
#| tbl-subcap: 
#|   - Table One {#tbl-one}
#|   - Table Two {#tbl-two}
#|   - Table Three {#tbl-three}

... # some code

```

But that did not succeed. Is this possible currently, and if not, can we come up with a way to do that?

[jjallaire]

Yikes, I don't think we actually show that in the docs for tables! Analogous to how we handle figures (which is documented, https://quarto.org/docs/authoring/cross-references.html#computations) we auto-generate the sub-table labels off of a master label. So for example:

```{r}
#| label: tbl-so-many
#| tbl-cap: So many tables!
#| tbl-subcap: 
#|   - Table One 
#|   - Table Two 
#|   - Table Three

... # some code

```

See @tbl-so-many-1 and @tbl-so-many-2

Note that you need to use the tbl prefix in your label to create a cross-referencable table.

[connorp]

ah, perfect. thanks!