rome-rails wraps the Rome (GitHub) javascript library for use in a Ruby on Rails project.
Rome is a customizable date (and time) picker.
Rome depends on moment,
which is bundled by default.
If you're already using moment,
you can use a version of Rome that doesn't bundle moment.
It doesn't depend on jQuery or other frameworks, though.
Add the following to your Gemfile:
gem "rome-rails"
Rome rails includes a bundled version of moment.js.
Add the following directive to your Javascript manifest file (application.js):
//= require rome
If you're already using moment,
(perhaps with the
momentjs-rails gem?)
you can included a standalone version of Rome.
Just make sure you require moment before rome-standalone
in your Javascript manifest file (application.js).
//= require moment
//= require rome.standalone
Add the following directive to your Stylesheets manifest file (application.css):
//= require rome
If you're using sass-rails, and your manifest file is application.**scss**,
then you should use Sass's style @import functions
@import "rome";
Once you have the files required, write some javascript (likely in a new file) to create a calendar.
Follow the examples from the rome homepage.
Remember: rome doesn't require jQuery, so it takes a native DOM element, not a jQuery element.
The version of this gem will match the version of the underlying Rome library.
After checking out the repo, run bundle to install dependencies.
Then, run rake spec to run the tests.
Bug reports, pull requests, support queries are welcome on GitHub at https://github.com/cllns/rome-rails. This project actively pursues maintaining a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
The gem is available as open source under the terms of the MIT License.