Skip to content

OpalVite Helpers API v1 ​

This directory contains API documentation for OpalVite Concerns v1.

Module Structure ​

All helpers are located in the OpalVite::Concerns::V1 namespace:

ruby
require 'opal_vite/concerns/v1/stimulus_helpers'

class MyController < StimulusController
  include OpalVite::Concerns::V1::StimulusHelpers
end

Available Modules ​

ModuleDescription
StimulusHelpersStimulus controller integration
DomHelpersDOM manipulation utilities
StorableLocalStorage persistence
ToastableToast notification system
JsProxyExJavaScript object wrappers
VueHelpersVue.js 3 integration
ReactHelpersReact integration
URIHelpersURL encoding/decoding utilities
Base64HelpersBase64 encoding/decoding utilities
DebugHelpersDebugging and console logging utilities
ActionCableHelpersActionCable WebSocket integration
TurboHelpersHotwire Turbo integration

opal_stimulus Compatibility Patch ​

opal_stimulus 0.2.x builds some JavaScript property names incorrectly for multi-word names. Require the patch right after opal_stimulus to fix them:

ruby
require 'opal_stimulus/stimulus_controller'
require 'opal_vite/compat/opal_stimulus'

See opal_stimulus_compat.md for details.

Backward Compatibility ​

For backward compatibility, you can still use the old paths:

ruby
require 'opal_vite/concerns/stimulus_helpers'
include OpalVite::Concerns::StimulusHelpers

However, this will show a deprecation warning. Please migrate to the v1 paths.

Global Aliases ​

For convenience, top-level aliases are also available:

ruby
require 'opal_vite/concerns/v1/stimulus_helpers'
include StimulusHelpers  # Same as OpalVite::Concerns::V1::StimulusHelpers

Released under the MIT License.