@vizuaalog/bulmajs

BulmaJS

This is an unofficial JavaScript extension for the Bulma CSS framework.

BulmaJS is still in development, you can keep track of current, pending, completed and planned tasks on the official Trello board.

tl;dr GIMME THE DOCS! Well here you go.

Bulma is an excellent CSS framework and the perfect alternative to Bootstrap. One of the great things about Bulma is that it's JUST CSS; there is no JavaScript included. This makes it super lightweight. Some components do require JavaScript however, and that is where BulmaJS comes in!

BulmaJS is written in ES6 and provides a plugin based system for adding interaction to the CSS components. BulmaJS is an ongoing project. As new components are added to Bulma, if they require JavaScript then they will also be added to BulmaJS. We are not limited to the core components though. If you have a plugin you would like incorporated, please submit a PR. If you have written a CSS extension to Bulma and would like some JS written, please submit an issue and we may write the JS functionality for you.

Contributing

If you would like to contribute a plugin, fix a bug or fix some horrible typo in the docs, then please submit a PR if you can! Alternatively, create an issue. Please note, while the code base doesn't follow any strict style, try to ensure your PRs follow the general convention that you see. There may be times the convention isn't followed, so if you see this submit an issue/PR and slap me on the wrist :). Any PR/issue at this time will not be rejected but may have some alteration to the code.

If you are submitting a plugin, please also submit the relevant documentation.

Changelog

0.11.0

• Feature Add a getFilename method to the file plugin.
• Feature Add a setActive method to the tabs plugin. This allows for programatically changing the active tab.
• Feature Add the ability to enable / disable a navbar's hide on scroll behavior at any time with enableHideOnScroll and disableHideOnScroll
• Feature Add the ability to enable / disable a navbar's sticky behaviour at any time with enableSticky and disableSticky.
• Feature Allow a plugin instance to be grabbed from an existing element. For example Bulma('.navbar').data('navbar') will return the navbar plugin instance associated with the element.
• Feature #71 The modal plugin can have it's HTML content loaded via an AJAX request using the new bodyUrl option.
• Bug #71 Fixed a typo within the Alert plugin that checks if the alert should be destroyed
• Refactor Adjust how options are internally handled, renaming variables to config and implementing a ConfigBag helper class.
• Refactor Remove the create method in favour of using the plugin's constructor method.
• Refactor Rewrite the API so that you can select an element Bulma(selector) and then call the relevant plugin. The core will then automatically pss the selector element as the root, or create an empty div as the root if nothing is provided.