collective.flowplayer_toolbar 0.2.1

A Plone module which add an accessible Javascript controlsbar to collective.flowplayer

How it works

This product use basic feature given to you from Flowplayer.

You must know that installing collective.flowplayer in your Plone site give you all the Flowplayer power. Unluckily the native Flowplayer’s controlsbar is not always accessible (recent releases sometimes are quite usable with keyboard, but not on every browser…), but a Flowplayer plugin gives you the power to create and handle the player with an alternative Javascript controlsbar.

This product does exactly this task. The default Flash controlsbar of the player will be disabled and a new, Javascript based, ones will be shown providing some WAI ARIA attributes.

If needed you can also enable again the native Flash controlsbar (as far as only there you can access feature like the fullscreen view of your videos, due to security reasons). To do this, put to True the toolbar_flash_controlsbar property in the flowplayer_properties property sheet.

The controlsbar plugin provided is not the original one you can find on Flowplayer site, but is fixed to be more accessible and fully usable using keyboard.

You can move around using the TAB key (and SHIFT+TAB for moving backward) and trigger button with ENTER.

When the focus is on the slider that indicate the video progress, you can:

• move forward/back for 5 seconds with right/left keys

• move forward/back for 1 minute with PAGE DOWN/PAGE UP keys

• move at the beginning of the video with HOME key

• move at the end of the video with END key

Multiple players inside a page.

If you don’t care about accessibility of your videos, you don’t need this package (but obviously you are a bad guy).

This product has been tested on collective.flowplayer 3.0rc1 with:

• Plone 3.3

• Plone 4.0

Accessible slider help text

When you navigate with keyboard to the slider, giving it the focus, an help tooltips will be displayed with instruction on how to use the slider with keyboard.

How help text looks like (Plone 4).

The help text is provided in english (default), italian and danish. To support additional languages you can modify the product source or (better) provide an additional Javascript registered after the flowplayer.accessible.controls.js:

jQuery.flowplayer_toolbar.slider_guide.xx = {
         intro:             'How to control the slider',
         left_arrow_label:  'Left arrow',
         left_arrow_help:   'backward 5 seconds',
         right_arrow_label: 'Right arrow',
         right_arrow_help:  'forward 5 seconds',
         page_up_label:     'Page up',
         page_up_help:      'backward 1 minute',
         page_down_label:   'Page down',
         page_down_help:    'forward 1 minute',
         home_label:        'Home key',
         home_help:         'go to beginning of clip',
         end_label:         'End key',
         end_help:          'go to end of clip'
};

Change xx above with the 2-letters code of your language and customize other strings. Language loaded is taken from the language of the site (for any problem, fallback on english).

If you like, send me your translation and see them becoming part of next release.

Dependencies

• collective.flowplayer

Credits

• Jacopo Deyla, from Regione Emilia Romagna, for fixing the accessibility of the controlsbar plugin and giving help about WAI-ARIA technology and tests with the toolbar.

• T.C. Mogensen (tmog) for providing danish translation and doing tests with older Plone releases.

Changelog

0.2.1 (2010-11-05)

• Fix a Javascript error that break the controlsbar using IE [keul]

• Added danish translation [tmog]

• Removed “Plone” egg dependency to be again compatible with Plone < 3.2 [keul]

• Code validated with JSLint [keul]

• Better UI audio support (right now with MP3 you’ll suffer a bug) [keul]

0.2.0 (2010-05-09)

• Fixed Javascript order issue; now place controlsbar’s code files after Flowplayer ones [keul]

• Controlbars auto-generated id handled in a better way, using “each” jQuery method [keul]

• Added support the the WAI-ARIA progressbar role [keul]

• Provide a way to keep the Flash controlsbar [keul]

• Now providing the Javascript controlsbar only if the Flash ones is available [keul]

• Tested on Plone 4 [keul]

• Increased controlsbar z-index so it will not go under other HTML elements [keul]

• Added hover effect of buttons even for keyboard navigation [keul]

• Added a slider accessible using keyboard, for control the video progress [keul]

• Added support the the WAI-ARIA slider role [keul]

• Fixed many focus CSS effects [keul]

• Fixes CSS issues when Flowplayer is used for multiple clips [keul]

0.1.0 (2009-12-08)

• Initial release