Add an optional default arrow for unsorted fields

README.md

@@ -200,13 +200,18 @@ initially sorting the `last_name` field by ascending order, and the
 
 The sort link order indicator arrows may be globally customized by setting a
 `custom_arrows` option in an initializer file like
-`config/initializers/ransack.rb`:
+`config/initializers/ransack.rb`.
+
+You can also enable a `default_arrow` which is displayed on all sortable fields
+which are not currently used in the sorting. This is disabled by default so
+nothing will be displayed:
 
 ```ruby
 Ransack.configure do |c|
   c.custom_arrows = {
     up_arrow: '<i class="custom-up-arrow-icon"></i>',
-    down_arrow: 'U+02193'
+    down_arrow: 'U+02193',
+    default_arrow: '<i class="default-arrow-icon"></i>'
   }
 end
 ```

lib/ransack/configuration.rb

@@ -12,6 +12,7 @@ module Configuration
       :hide_sort_order_indicators => false,
       :up_arrow => '▼'.freeze,
       :down_arrow => '▲'.freeze,
+      :default_arrow => nil,
       :sanitize_scope_args => true
     }
 
@@ -83,20 +84,25 @@ def ignore_unknown_conditions=(boolean)
     #   up_arrow:   '▼'
     #   down_arrow: '▲'
     #
-    # One or both defaults may be globally overridden in an initializer file
+    # There is also a default arrow which is displayed if a column is not sorted.
+    # By default this is nil so nothing will be displayed.
+    #
+    # Any of the defaults may be globally overridden in an initializer file
     # like `config/initializers/ransack.rb` as follows:
     #
     # Ransack.configure do |config|
-    #   # Globally set the up arrow to an icon and the down arrow to unicode.
+    #   # Globally set the up arrow to an icon, and the down and default arrows to unicode.
     #   config.custom_arrows = {
     #     up_arrow:   '<i class="fa fa-long-arrow-up"></i>',
-    #     down_arrow: 'U+02193'
+    #     down_arrow: 'U+02193',
+    #     default_arrow: 'U+11047'
     #   }
     # end
     #
     def custom_arrows=(opts = {})
       self.options[:up_arrow] = opts[:up_arrow].freeze if opts[:up_arrow]
       self.options[:down_arrow] = opts[:down_arrow].freeze if opts[:down_arrow]
+      self.options[:default_arrow] = opts[:default_arrow].freeze if opts[:default_arrow]
     end
 
     # Ransack sanitizes many values in your custom scopes into booleans.

lib/ransack/helpers/form_helper.rb

@@ -117,6 +117,10 @@ def down_arrow
           Ransack.options[:down_arrow]
         end
 
+        def default_arrow
+          Ransack.options[:default_arrow]
+        end
+
         def name
           [ERB::Util.h(@label_text), order_indicator]
           .compact
@@ -209,7 +213,8 @@ def default_sort_order(attr_name)
           end
 
           def order_indicator
-            return if @hide_indicator || no_sort_direction_specified?
+            return if @hide_indicator
+            return default_arrow if no_sort_direction_specified?
             if @current_dir == 'desc'.freeze
               up_arrow
             else

spec/ransack/configuration_spec.rb

@@ -48,6 +48,7 @@ module Ransack
     it 'should have default values for arrows' do
       expect(Ransack.options[:up_arrow]).to eq '▼'
       expect(Ransack.options[:down_arrow]).to eq '▲'
+      expect(Ransack.options[:default_arrow]).to eq nil
     end
 
     it 'changes the default value for the up arrow only' do
@@ -72,17 +73,31 @@ module Ransack
       Ransack.options = default
     end
 
-    it 'changes the default value for both arrows' do
+    it 'changes the default value for the default arrow only' do
+      default, new_default_arrow  = Ransack.options.clone, '<i class="default"></i>'
+
+      Ransack.configure { |c| c.custom_arrows = { default_arrow: new_default_arrow } }
+
+      expect(Ransack.options[:up_arrow]).to eq default[:up_arrow]
+      expect(Ransack.options[:down_arrow]).to eq default[:down_arrow]
+      expect(Ransack.options[:default_arrow]).to eq new_default_arrow
+
+      Ransack.options = default
+    end
+
+    it 'changes the default value for all arrows' do
       default        = Ransack.options.clone
       new_up_arrow   = '<i class="fa fa-long-arrow-up"></i>'
       new_down_arrow = 'U+02193'
+      new_default_arrow = 'defaultarrow'
 
       Ransack.configure do |c|
-        c.custom_arrows = { up_arrow: new_up_arrow, down_arrow: new_down_arrow }
+        c.custom_arrows = { up_arrow: new_up_arrow, down_arrow: new_down_arrow, default_arrow: new_default_arrow }
       end
 
       expect(Ransack.options[:up_arrow]).to eq new_up_arrow
       expect(Ransack.options[:down_arrow]).to eq new_down_arrow
+      expect(Ransack.options[:default_arrow]).to eq new_default_arrow
 
       Ransack.options = default
     end

spec/ransack/helpers/form_helper_spec.rb

@@ -727,11 +727,36 @@ module Helpers
         it { should match /Full Name ▼/ }
       end
 
+      describe '#sort_link with config set to show arrows and a default arrow set' do
+        before do
+          Ransack.configure do |c|
+            c.hide_sort_order_indicators = false
+            c.custom_arrows = { default_arrow: "defaultarrow"}
+          end
+        end
+
+        after do
+          Ransack.configure do |c|
+            c.custom_arrows = { default_arrow: nil}
+          end
+        end
+
+        subject { @controller.view_context
+          .sort_link(
+            [:main_app, Person.search],
+            :name,
+            controller: 'people'
+          )
+        }
+
+        it { should match /Full Name defaultarrow/ }
+      end
+
       describe '#sort_link w/config to hide arrows + custom arrow, hides all' do
         before do
           Ransack.configure do |c|
             c.hide_sort_order_indicators = true
-            c.custom_arrows = { down_arrow: 'down' }
+            c.custom_arrows = { down_arrow: 'down', default_arrow: "defaultarrow" }
           end
         end
 
@@ -750,7 +775,7 @@ module Helpers
           )
         }
 
-        it { should_not match /▼|down/ }
+        it { should_not match /▼|down|defaultarrow/ }
       end
 
       describe '#sort_link with config set to show arrows + custom arrow' do