Versions Compared

Old Version 9

changes.mady.by.user Marcella Marino

Saved on

compared with

New Version 10

changes.mady.by.user Jo Tayler

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Read our guide on using the data table component.

Basic text component – table option

Read our guide on using the basic text component – table option.

Advanced settings

Alignment

Expand
Info

This functionality is currently not working. Please submit a ticket if you require this. We’re working on it!

Most tables should be left-aligned because we read left-to-right. However, tables with financial figures should have any columns with numerals set to right-aligned.

To change the alignment, you need to go into the source code and edit the HTML.

The code options you can use are:

  • align="left"

  • align="right"

  • align="center" (note the US spelling)

  • align="justify"

Remember to always add a space between “th” or “td” and the alignment code snippet, so it looks like this: <th align="right">

How to add the code

In the component with your table, click the Source button. Look for code like this:

<table>
<thead>
<tr>
<th>Year</th>
<th>Total amount ($)</th>
</tr>
</thead>
<tbody>
<tr>
<td>2019</td>
<td>23,100</td>
</tr>
<tr>
<td>2020</td>
<td>19,870</td>
</tr>
<tr>
<td>2021</td>
<td>21,100</td>
</tr>
</tbody>
</table>

The heading cells are coded <th>.

The rest of the cells are coded <td>.

To set right-alignment for the second column (as displayed in the example), you need to add the code snippet into the <th> and all the corresponding <td> tags.

Here's an example, using the code above with the alignment snipped added:

<table>
<thead>
<tr>
<th>Year</th>
<th align="right">Total amount ($)</th>
</tr>
</thead>
<tbody>
<tr>
<td>2019</td>
<td align="right">23,100</td>
</tr>
<tr>
<td>2020</td>
<td align="right">19,870</td>
</tr>
<tr>
<td>2021</td>
<td align="right">21,100</td>
</tr>
</tbody>
</table>

Column width

Expand
Info

This functionality is currently not working. Please submit a ticket if you require this. We’re working on it!

You can set a column width in just the heading row and that setting will then apply to the whole column. (This is different to alignment, which you have to set up in every cell.)

One reason you might want to do this when you have a page with several similar tables and, due to varying lengths of content, they are displaying with varying column widths. In this case, setting the width of the columns should make the page content look better.

How to manually set column width

Width is controlled by our CSS (a style sheet that controls how the web pages look).

In the CSS for vic.gov.au we have pre-set 12 fixed widths that correspond to percentages of the text area on screen (with different widths for different devices: desktop, tablet or mobile).

You want to add this code <th class=:"rpl-table--col-X">Column name</th> to the column you're adjusting, with the X being the relevant number from the options below.

Here are the 12 snippets of code and the percentage they will apply:

Examples of how the different column widths display

Often you just want to set the first column and let the width of the other columns automatically display according to the contents.

This table has the first column set to display at 17% of the table's width.

This table has the first column set to display at 33% of the table's width.

This table has the first column set to display at 50% of the table's width. The fifth column has some longer text and this is affecting how columns 2, 3, 4 and 5 display in relation to each other.

This table has the first column set to display at 75% of the table's width. That doesn't leave much space to display the content in the other columns.

...