Help:Broadtable format

From semantic-mediawiki.org
Jump to: navigation, search
Broadtable format
Outputs the result in a broad table.
Further Information
Provided by: Semantic MediaWiki
Added: 0.4
Removed: still supported
Requirements: none
Format name: broadtable
Enabled by default:info.pngIndicates whether the result format is enabled by default upon installation of the respective extension. yes
Authors: Markus Krötzsch
Categories: misc
Table of Contents

The result format broadtable is used to format query results as tables. It is identical to the table format except that the broadtable stretches the table to 100% of the available width.

Parameters

Parameter Type Default Description
intro Text empty The text to display before the query results, if there are any
outro Text empty The text to display after the query results, if there are any
default Text empty The text to display if there are no query results
class Text sortable wikitable smwtable An additional CSS class to set for the table

There are no inline query parameters specific to the broadtable format. The parameter headers=hide is specifically useful for hiding the header of tables (in most other cases, it is enough to use empty printout labels to hide the titles of printout statements).

Example

{{#ask: [[Category:City]] [[located in::Germany]] 
| ?population
| ?area#km² = Size in km²
| format=broadtable
}}

This produces the following output:

  Population Size in km²
Berlin 3,391,409 891.85 km²344.343 sqmi
Frankfurt 679,664 248.31 km²95.872 sqmi
Munich 1,353,186 310.43 km²119.857 sqmi
Stuttgart 606,588 207.36 km²80.062 sqmi

Applying CSS formatting

As of version 1.6.2 SMW uses the native MediaWiki sortable tables. Thus this format now provides several ways for custom formatting to be applied to tables:

  • One or more overall CSS classes can be set for the table, using the "class=" parameter.
  • Each column in the table gets a class name that derives from the column name. For instance, if a column is titled "Capital city", the column's class will be "Capital-city".
  • Rows in the table each get either the class "row-odd" or "row-even", depending on whether the row is odd or even.

In this way, specific formatting, like colors and font sizes, can be set across a single table, or for a specific column, or can be set for alternating rows. (The recommended way to set any custom CSS in the wiki is by modifying the page "MediaWiki:Common.css".)

Example for alternating row colours

The example below will result in the display of alternating rows.

/* even and odd in tables*/
.smwtable .row-even {background-color:#FFF;}
.smwtable .row-odd {background-color:#CDE6EA;}

Remarks

Tables have a special feature for sorting their contents by any of the columns in the table. See Help:Selecting pages for general comments on sorting and a comparison to the wiki's query result sorting. Browsers without JavaScript enabled will not see the buttons for sorting at all.



This documentation page applies to all SMW versions from 1.6.2 to the most current version.
Other versions: 0.4 – 1.6.1       Other languages: defrzh-hans

Help:Broadtable format en 1.6.2


Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox