Using Mobility with Forms

A common use case involves translating content using a form (in Rails). Here we look at some issues with this use case and ways to solve them.

Fallbacks / Default

If you define fallbacks or a default value on your model, you will see the fallback locale value or default value of an attribute in the form if the value in the current locale is not available. Submitting the form will then save this fallback or default value, which is not generally what you would want. (See this issue for reference).

To solve this, you can pass a fallback and/or default option to the attribute reader to disable using fallbacks/default:

post.title(fallback: false, default: nil)
#=> returns the actual value of the title, in the current locale, or nil if it is nil

In your form, you can set this as the default value for every translatable attribute:

<%= form_for @post do |f| %>

  ...
  <%= f.label :title %>:
  <%= f.text_field :title, value: @post.title(fallback: false, default: nil) %><br />
  ...

  <%= f.submit %>
<% end %>

This may become cumbersome if you have many translated attributes and many forms. To make this default, use this form builder, which will automatically disable fallbacks on all translated attributes:

class FallbacksDisabledFormBuilder < ActionView::Helpers::FormBuilder
  %w[text_field text_area].each do |field_name|
    define_method field_name do |attribute, options={}|
      if @object.translated_attribute_names.include?(attribute)
        super(attribute, options.merge(value: @object.send(attribute, fallback: false, default: nil)))
      else
        super(attribute, options)
      end
    end
  end
end

You can use the builder in your form with builder: FallbacksDisabledFormBuilder, like this:

<%= form_for @post, builder: FormBuilderWithFallbacksDisabled do |f| %>

  ...
  <%= f.label :title %>:
  <%= f.text_field :title %><br />
  ...

  <%= f.submit %>
<% end %>

For more on form builders, see the rails docs.

SimpleForm

By default, SimpleForm will not use textarea form fields for text-valued translated attributes. To get around this, use SipleForm's as argument to specify the attribute's type:

= f.input :content, as: :text

See also: https://github.com/shioyama/mobility/issues/109