This repository (loco-rails-core) is no longer maintained.
- Why: the main purpose of this gem was adding a Rails helper (
Loco::Core::Helpers#loco_body_data) that generates<body>data-*attributes used to resolve controller/action metadata (seelib/loco/core/helpers.rb). - Bottom line: there’s no reason to maintain a dedicated gem just for that helper
- What changed: the JavaScript companion library Loco-JS-Core received additional features (including Components), has been renamed to Simplicit, and was transferred to Art of Code Labs:
- Recommendation: migrate from Loco-JS-Core to Simplicit and generate controller metadata in Rails using the helper snippet from Simplicit’s README section "Ruby on Rails: generating
<body>data attributes":
Loco-Rails-Core is a Rails plugin that has been extracted from Loco-Rails. The reason for this extraction was to pull out functionality that can be used as a stand-alone lib. This functionality was the origin of the Loco-Rails project.
I wanted to provide a logical structure for a JavaScript code that corresponds to Rails` controllers and views. The same controller's action that renders a response for a given request on the Rails side would be called on the JavaScript level. By "the same" - I mean action with the same name and defined in an (optionally namespaced) controller with the corresponding name as the one on the server-side.
The Loco-Rails-Core, by itself, does not provide a lot of value. Historically it was used with its JavaScript complementary library Loco-JS-Core, which has since been renamed and transferred to Simplicit: Simplicit (formerly Loco-JS-Core).
Loco-Rails-Core's single generator adds Loco::Core::Helpers module to ApplicationHelper.
It also updates the application.html.erb layout by adding data-* attributes to HTML <body> element.
Loco-Rails-Core does this via methods defined in the mentioned above Loco::Core::Helpers module.
These attributes store the information about the namespace, controller, and action names involved in handing a given request. Simplicit looks at these attributes to call out a method from the corresponding location but inside the JavaScript code. In other words - Simplicit calls a JavaScript controller's action with the same name and located inside the same namespace.
Example:
Given that the index action from Main::PagesControllers handles a given request.
<body>'s data attributes are gonna look like this:
<body data-namespace="Main" data-controller="Pages" data-action="index">
</body>Simplicit will act similarly (simplified version):
// all JavaScript controllers are assigned to the Controllers object
namespaceController = new Controllers.Main;
namespaceController.initialize();
controller = new Controllers.Main.Pages;
controller.initialize();
controller.index();If you don't define a namespace controller - it will be skipped.
If you don't define an initialize or index actions - Simplicit won't call them.
You can define JavaScript counterparts only for those actions that you want to augment with JavaScript features.
Loco-Rails-Core is the right choice if you don't need all features that Loco-Rails provides.
Add this line to your application's Gemfile:
gem 'loco-rails-core'And then execute:
$ bundle$ bin/rails generate loco:core:file_injector$ bin/testThe gem is available as open source under the terms of the MIT License.
Zbigniew Humeniuk from Art of Code