What is Responsive Scrolling Tables (RST)?

RST is a plugin for your Joomla! website that prevents tables from breaking your responsive layout.

Who is RST for?

RST is for anyone wishing to use tables in a mobile friendly way without having to add classes or special formatting to the table. It's aimed at WYSIWYG users to help them focus more on the content and worry less about the mobile display.

What does RST do?

It detects when tables are bigger then their containers and makes them scroll instead of flowing over the boundary of the container.

Please see screen shots for examples.

Why create RST?

We created RST because our clients like to write their own content and sometimes it is necessary to use tables. We respect that our clients are not HTML masters and learning HTML is often not one of their long term goals, so we needed an easy to use way of making their tables display correctly and easily on mobile devices.

How does RST work?

It inserts a JavaScript file into the document that detects if the document contains any tables. With each table it finds, it checks whether the table's width is larger then its parent, when a table is going to break the display of a page and makes it scroll instead by inserting a scrollable parent around the table. It also runs when the page is resized allowing users to maintain usability even after the page has loaded.

The plugin doesn't work

The first step is to make sure that you have activated the Responsive Scrolling Tables plugin.

1.2.1

• Moved from overriding the document.onreadystatechange to using document.addEventListener

1.2.0

• Changed to use wp_enqueue_script

1.1.0

• Removing the 'echo' that outputed the RST file location within the plugin

1.0.0

• Initial release of RST

This section describes how to install the plugin and get it working.

e.g.

1. Upload responsivescrollingtables-wordpress-version.zip via the plugin installer
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Sit back and relax