Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/elia/receptive
The perfect toolkit to lighten up your existing HTML
https://github.com/elia/receptive
javascript jquery opal rails ruby
Last synced: about 1 month ago
JSON representation
The perfect toolkit to lighten up your existing HTML
- Host: GitHub
- URL: https://github.com/elia/receptive
- Owner: elia
- License: mit
- Created: 2018-02-14T11:00:51.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2024-01-28T19:11:35.000Z (about 1 year ago)
- Last Synced: 2024-12-25T12:02:22.619Z (about 1 month ago)
- Topics: javascript, jquery, opal, rails, ruby
- Language: JavaScript
- Homepage:
- Size: 27.3 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Receptive
Receptive is a toolkit that will help you add behavior to your existing, server-generated HTML. It's not intended for single-page-application but rather about taking care of specific DOM nodes.
This is perfect for you if:
- **you already generate all your views from the server** (and don't want to throw everything away following the latest JavaScript fad)
- **you need your site to work without JavaScript** for SEO or any other reasons
- **you have a bunch of jQuery stuff around** and always wanted to organize it properly
- **you like Ruby** and don't want to get caught by all the subtle quirks of JavaScript
## Installation
Add this line to your application's Gemfile:
```ruby
gem 'receptive'
```
And then execute:
$ bundle
## How it works
Just keep your HTML as it is:
```html
Greet
```
Then write a view with a reference to it:
```rb
class HelloWorld
extend Receptive::View
self.selector = ".hello-world"
on(:click, 'button') do |event|
@greeting_text = find('input').text
render!
end
def self.render
find('.output').text = @greeting_text
end
end
```
Read on in the [handbook](./HANDBOOK.md)
## Other features
- script[async] compatible
- pjax/turbolinks compatible
## Development
After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/elia/receptive.
## License
The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).