/bootstrap3_player

An HTML5 Audio Player Skin For Twitter Bootstrap 3

Primary LanguageJavaScriptApache License 2.0Apache-2.0

NOTE: This is a fork to support dynamicly created elements, such as with jquery.

For example:

 $("<audio/>", {
            "id": data.id,
            controls: "controls",
            "data-info-album-art": "image.png",
            "data-info-id": data.info.id,
            "data-info-album-title": data.title,
            "data-info-artist": data.artist,
            "data-info-title": data.info.title,
            "data-info-label": data.label, "),
            "data-info-year": data.year,
            "data-info-att": data.attr,
            "data-info-att-link": "/",
            html: "An html5-capable browser is required to play this audio.",
        }).appendTo("#body");

        $("<source>", {
            src: 'my-mp3file.mp3',
            type: "audio/mpeg",
        }).appendTo('#' + data.id);

        // this method initializes the bootstrap3_player
        $("#" + data.id).bootAudio();

End.

bootstrap3_player

An HTML5 Audio Player Skin For Twitter Bootstrap 3

Requires:

How to use

Clone or download this repo; then open the included index.html file:

  • with your browser to:
  • with your text editor to:
    • see all the css and js files you need to link to
    • see the <audio> tags in use

Styling caveat

Works best when the player is not enclosed in too narrow a container in your page otherwise the player controls can appear jumbled. Both the seek and volume sliders are hidden on narrow (xs) viewports. A good strategy is to start "mobile-first" as usual by enclosing your audio block in a row that uses all twelve grid colums of the page's outer container in an xs viewport. Then, on wider viewports, the player can occupy fewer of the page's grid columns. See the example row widths in index.html and the corresponding live demo.

Forked from William Randol's bootstrap-player
  • bootstrap-player is great for Bootstrap 2
  • All the functionality of William Randol's player is preserved
    (QUnit / FuncUnit test suite in progress 🌒)
  • bootstrap3_player updates the styling of bootstrap-player; has fewer dependencies; uses Bootstrap 3

For some info on the differences between bootstrap-player and bootstrap3_player, see here.

See a live demo

  • Audio with no additional data

  • Audio with data - collapsed

  • Audio with data - expanded