Community Central
Community Central
(Clarified description of "arrows" that allow adding rows or columns to tables.)
Tags: Visual edit Help
(minor thing, basically fine as-is)
(16 intermediate revisions by 12 users not shown)
Line 1: Line 1:
'''Tables''' are a great way to organize and display data. They can be created in the [[Help:VisualEditor|VisualEditor]], by using [[Help:Wikitext|wikitext]], and in the [[Help:Editing|classic editor]]'s visual mode.
+
'''Tables''' are a great way to organize and display data. They can be created in the [[Help:VisualEditor|VisualEditor]] or by using [[Help:Wikitext|wikitext]] in the [[Help:Source editor|source editor]].
   
It is important to carefully consider [[#Best practices with tables|what tables are truly meant to do]] and use them primarily for displaying data. For help with sortable tables see [[Help:Sorting]].
+
It is important to carefully consider [[#Best practices with tables|what tables are truly meant to do]] and use them primarily for displaying data. For help with sortable tables, see [[Help:Sorting]].
   
 
== In the VisualEditor ==
 
== In the VisualEditor ==
 
The [[Help:VisualEditor|VisualEditor]] offers a simple experience of creating a table.
 
The [[Help:VisualEditor|VisualEditor]] offers a simple experience of creating a table.
 
# Open a page in the VisualEditor.
 
# Open a page in the VisualEditor.
# Under the '''insert''' dropdown, choose '''table'''.[[File:Adding table in VisualEditor.png|thumb|150px|none|4x4 appears after inserting table]]
+
# Under the '''insert''' dropdown, choose '''table'''.[[File:TableEdit.PNG|thumb|180px|4x4 appears after inserting table]]
 
# A 4 X 4 grid will appear. Click on a cell and enter either your label or your data.
 
# A 4 X 4 grid will appear. Click on a cell and enter either your label or your data.
# If you want to expand or contract the grid, you must first highlight a cell in the leftmost column. Then an almost invisible arrow will appear next to that cell, or above it if it is in the top row. This arrow does NOT look like the ones in this diagram; it is a very faint light blue > symbol on the white background. Click on that > symbol next to the highlighted cell and you'll get a dropdown that will offer you the chance to alter the structure of your table.[[File:VE-TableControls.png|thumb|none|150px|Hit the arrows to make a change]]
+
# If you want to expand or contract the grid, click on arrows surrounding the table and you'll get a dropdown that will offer you the chance alter the structure of your table.[[File:TableCollumChange.PNG|thumb|180px|Hit the arrows to make a change]]
# Hit '''Save page''' when ready to publish.
+
# Hit '''Save page''' when ready to publish.[[File:TableProperties.PNG|thumb|180px|There is also a Properties menu to set additional attributes]]
  +
 
== In source editor ==
 
For advanced editors, editing tables in source mode can allow greater manipulation of table content. [[Help:Wikitext|Wikitext]] is, in many ways, just a shortcut for [[Help:HTML|HTML]]. If you're familiar with HTML, you probably already know how to build a wikitext table. Here's a chart that will help you understand the connection between wikitext and HTML:
   
== In source mode ==
 
For advanced editors, editing tables in source mode can allow greater manipulation of table content. [[Help:Wikitext|Wikitext]] is, in many ways, just a shortcut for [[Help:HTML|HTML]]. If you're familiar with HTML, you probably already know how to build a wikitext table. Here's a chart that will help you understand the connection between wikitext and HTML:
 
 
{| class="article-table"
 
{| class="article-table"
 
|-
 
|-
Line 20: Line 21:
 
|Begin table<br />(equivalent to <code>&lt;table&gt;</code>)
 
|Begin table<br />(equivalent to <code>&lt;table&gt;</code>)
 
|<code>&#123;&#124;</code>
 
|<code>&#123;&#124;</code>
  +
|-
  +
|Table caption<br />(equivalent to <code>&lt;caption&gt;</code>)
  +
|<code>&#124;+</code>
 
|-
 
|-
 
|Begin table row<br />(equivalent to <code>&lt;tr&gt;</code>)
 
|Begin table row<br />(equivalent to <code>&lt;tr&gt;</code>)
Line 32: Line 36:
 
|End table<br />(equivalent to <code>&lt;/table&gt;</code>)
 
|End table<br />(equivalent to <code>&lt;/table&gt;</code>)
 
|<code>&#124;&#125;</code>
 
|<code>&#124;&#125;</code>
  +
|-
  +
|Table prerequisites in [[Help:Tabber|Tabber]]s
  +
|<code><nowiki>{{{!}}</nowiki></code>
 
|}
 
|}
 
More advanced wikitext is described in the [[Help:Tables/Wikitext]] page.
 
More advanced wikitext is described in the [[Help:Tables/Wikitext]] page.
 
== In the classic editor's visual mode ==
 
To create a table using the classic editor's visual mode, click on the table button on the right rail. [[File:Table button.png|50px|link=|]]
 
# In edit mode, click on the table button under the '''Insert''' section of the editing toolbar.[[File:Edit toolbar table highlighted.png|thumb|none|400px|Click the '''table''' button]]
 
# A pop-up box will appear, allowing you to choose the parameters you want for your table.[[File:Table properties.png|thumb|none|190px|Create your table]]
 
# Once you click OK, a table will appear in your text. You can now input content.
 
# Should you need to change the table parameters, simply right click, and make the needed changes.[[File:Table editor.png|thumb|none|300px|Right click to edit]]
 
   
 
== Best practices with tables ==
 
== Best practices with tables ==
Line 56: Line 56:
 
== Further help and feedback ==
 
== Further help and feedback ==
 
{{Help and feedback section}}
 
{{Help and feedback section}}
  +
 
[[de:Hilfe:Tabellen]]
 
[[de:Hilfe:Tabellen]]
 
[[es:Ayuda:Tablas]]
 
[[es:Ayuda:Tablas]]
Line 71: Line 72:
 
[[vi:Trợ giúp:Bảng]]
 
[[vi:Trợ giúp:Bảng]]
 
[[zh:Help:表格]]
 
[[zh:Help:表格]]
[[Category:Editing]]
 
 
[[Category:Help]]
 
[[Category:Help]]
 
[[Category:Editing]]
 
[[Category:Tables & templates]]
 
[[Category:Tables & templates]]

Revision as of 16:53, 17 August 2021

Tables are a great way to organize and display data. They can be created in the VisualEditor or by using wikitext in the source editor.

It is important to carefully consider what tables are truly meant to do and use them primarily for displaying data. For help with sortable tables, see Help:Sorting.

In the VisualEditor

The VisualEditor offers a simple experience of creating a table.

  1. Open a page in the VisualEditor.
  2. Under the insert dropdown, choose table.
    TableEdit

    4x4 appears after inserting table

  3. A 4 X 4 grid will appear. Click on a cell and enter either your label or your data.
  4. If you want to expand or contract the grid, click on arrows surrounding the table and you'll get a dropdown that will offer you the chance alter the structure of your table.
    TableCollumChange

    Hit the arrows to make a change

  5. Hit Save page when ready to publish.
    TableProperties

    There is also a Properties menu to set additional attributes

In source editor

For advanced editors, editing tables in source mode can allow greater manipulation of table content. Wikitext is, in many ways, just a shortcut for HTML. If you're familiar with HTML, you probably already know how to build a wikitext table. Here's a chart that will help you understand the connection between wikitext and HTML:

Description You type
Begin table
(equivalent to <table>)
{|
Table caption
(equivalent to <caption>)
|+
Begin table row
(equivalent to <tr>)
|-
Table header (part of a row; equivalent to <th>) ! or !!
Table cell (part of a row; equivalent to <td>) | or ||
End table
(equivalent to </table>)
|}
Table prerequisites in Tabbers {{{!}}

More advanced wikitext is described in the Help:Tables/Wikitext page.

Best practices with tables

Although tables can be used for design, they shouldn't be. The results on mobile devices are awkward because tables aren't very responsive. That is, on different sized displays, tables look different—and often are ugly. Throw pictures into tables and the results can easily become unreadable on a phone. And if you're making whole pages or sections of articles out of tables, it'd probably be good to rethink that strategy.

Instead, as has been argued since at least 2004, tables should be about data only.

Here are some specific things to consider when using tables:

  • As you increase the number of columns, you increase the chances that your table isn't going to display correctly on a mobile device. Think carefully about whether you need all those columns.
  • Some games use icons liberally, meaning there's a case to be made that icons are necessary and often helpful. If you run a wiki like this, make sure all the images you use in your tables are cut to the same size, and make that size no larger than you need them to be. Anything much above 25px widths could bring problems. Additionally, make sure to use text adjacent to the icons, so those unfamiliar with what the icons mean will understand.
  • It's very common for wikis to make notices on the top of pages—things like {{delete}}—using table markup. These are typically problematic on phones, and most readers on mobile devices don't care about them. You can skirt the issue by making sure they have a template type of Notice.
  • Similar to the above, it is very common for wikis to make navigation boxes (Navboxes) that provide links to related articles at the end of articles using table markup. Ensure that these have the template type Navbox.
  • Always check what your table looks like on a phone.

Further help and feedback