Helpers: Custom Helpers
In the overview section, we introduced the design for helpers. They are modules that enrich views behaviors. Because they are just Ruby modules, we can create our own helpers.
Imagine we need (for some reason) a helper that shuffles the characters of a string and we want it to be available in our views.
As first thing, let’s define the module.
# app/web/helpers/shuffler.rb module Web module Helpers module Shuffler private SEPARATOR = ''.freeze def shuffle(string) string .encode(Encoding::UTF_8, invalid: :replace) .split(SEPARATOR).shuffle.join end end end end
There is NO convention between the file name and the name of the module. We can define this code, where and how we want.
Then let’s add that directory to the load paths of the application, so it can be eagerly loaded. As third step, we include the module in all the views. See View’s Share Code section for low level details.
# apps/web/application.rb module Web class Application < Hanami::Application configure do # ... load_paths << [ 'helpers', 'controllers', 'views' ] # ... view.prepare do include Hanami::Helpers include Web::Helpers::Shuffler end end end end
Please note that our custom helper will work even if we remove
include Hanami::Helpers line, because it's just Ruby.