activeadmin 2.2.0

data/lib/active_admin/views/components/attributes_table.rb

@@ -0,0 +1,94 @@
+module ActiveAdmin
+  module Views
+
+    class AttributesTable < ActiveAdmin::Component
+      builder_method :attributes_table_for
+
+      def build(obj, *attrs)
+        @collection     = Array.wrap(obj)
+        @resource_class = @collection.first.class
+        options = {}
+        options[:for] = @collection.first if single_record?
+        super(options)
+        @table = table
+        build_colgroups
+        rows(*attrs)
+      end
+
+      def rows(*attrs)
+        attrs.each { |attr| row(attr) }
+      end
+
+      def row(*args, &block)
+        title   = args[0]
+        options = args.extract_options!
+        classes = [:row]
+        if options[:class]
+          classes << options[:class]
+        elsif title.present?
+          classes << "row-#{title.to_s.parameterize(separator: "_")}"
+        end
+        options[:class] = classes.join(' ')
+
+        @table << tr(options) do
+          th do
+            header_content_for(title)
+          end
+          @collection.each do |record|
+            td do
+              content_for(record, block || title)
+            end
+          end
+        end
+      end
+
+      protected
+
+      def default_id_for_prefix
+        'attributes_table'
+      end
+
+      # Build Colgroups
+      #
+      # Colgroups are only necessary for a collection of records; not
+      # a single record.
+      def build_colgroups
+        return if single_record?
+        reset_cycle(self.class.to_s)
+        within @table do
+          col # column for row headers
+          @collection.each do |record|
+            classes = Arbre::HTML::ClassList.new
+            classes << cycle(:even, :odd, name: self.class.to_s)
+            classes << dom_class_name_for(record)
+            col(id: dom_id_for(record), class: classes)
+          end
+        end
+      end
+
+      def header_content_for(attr)
+        if @resource_class.respond_to?(:human_attribute_name)
+          @resource_class.human_attribute_name(attr, default: attr.to_s.titleize)
+        else
+          attr.to_s.titleize
+        end
+      end
+
+      def empty_value
+        span I18n.t('active_admin.empty'), class: "empty"
+      end
+
+      def content_for(record, attr)
+        value = helpers.format_attribute record, attr
+        value.blank? && current_arbre_element.children.to_s.empty? ? empty_value : value
+        # Don't add the same Arbre twice, while still allowing format_attribute to call status_tag
+        current_arbre_element << value unless current_arbre_element.children.include? value
+      end
+
+      def single_record?
+        @single_record ||= @collection.size == 1
+      end
+    end
+
+  end
+end

data/lib/active_admin/views/components/blank_slate.rb

@@ -0,0 +1,17 @@
+module ActiveAdmin
+  module Views
+    # Build a Blank Slate
+    class BlankSlate < ActiveAdmin::Component
+      builder_method :blank_slate
+
+      def default_class_name
+        'blank_slate_container'
+      end
+
+      def build(content)
+        super(span(content.html_safe, class: "blank_slate"))
+      end
+
+    end
+  end
+end

data/lib/active_admin/views/components/columns.rb

@@ -0,0 +1,161 @@
+module ActiveAdmin
+  module Views
+
+    # = Columns Component
+    #
+    # The Columns component allows you draw content into scalable columns. All
+    # you need to do is define the number of columns and the component will
+    # take care of the rest.
+    #
+    # == Simple Columns
+    #
+    # To display columns, use the #columns method. Within the block, call the
+    # #column method to create a new column.
+    #
+    # To create a two column layout:
+    #
+    #     columns do
+    #       column do
+    #         span "Column # 1
+    #       end
+    #       column do
+    #         span "Column # 2
+    #       end
+    #     end
+    #
+    #
+    # == Multiple Span Columns
+    #
+    # To make a column span multiple, pass the :span option to the column method:
+    #
+    #     columns do
+    #       column span: 2 do
+    #         span "Column # 1
+    #       end
+    #       column do
+    #         span "Column # 2
+    #       end
+    #     end
+    #
+    # By default, each column spans 1 column. So the above layout would have 2 columns,
+    # the first being 2 time bigger than the second.
+    #
+    #
+    # == Max and Min Column Sizes
+    #
+    # Active Admin is a fluid width layout, which means that columns are all defined
+    # using percentages. Sometimes this can cause issues if you don't want a column
+    # to shrink or expand past a certain point.
+    #
+    # To overcome this, columns include a :max_width and :min_width option.
+    #
+    #     columns do
+    #       column max_width: "200px", min_width: "100px" do
+    #         span "Column # 1
+    #       end
+    #       column do
+    #         span "Column # 2
+    #       end
+    #     end
+    #
+    # Now the first column will not grow bigger than 200px and will not shrink smaller
+    # than 100px.
+    class Columns < ActiveAdmin::Component
+      builder_method :columns
+
+      # For documentation, please take a look at Column#build
+      def column(*args, &block)
+        insert_tag Column, *args, &block
+      end
+
+      # Override add child to set widths
+      def add_child(*)
+        super
+        calculate_columns!
+      end
+
+      protected
+
+      # Override the closing tag to include a clear
+      def closing_tag
+        "<div style=\"clear:both;\"></div>" + super
+      end
+
+      def margin_size
+        2
+      end
+
+      # Calculate our columns sizes and margins
+      def calculate_columns!
+        span_count = columns_span_count
+        columns_count = children.size
+
+        all_margins_width = margin_size * (span_count - 1)
+        column_width = (100.00 - all_margins_width) / span_count
+
+        columns.each_with_index do |column, i|
+          is_last_column = i == (columns_count - 1)
+          column.set_column_styles(column_width, margin_size, is_last_column)
+        end
+      end
+
+      def columns_span_count
+        count = 0
+        columns.each do |column|
+          count += column.span_size
+        end
+
+        count
+      end
+
+      def columns
+        children.select { |child| child.is_a?(Column) }
+      end
+    end
+
+    class Column < ActiveAdmin::Component
+
+      attr_accessor :span_size, :max_width, :min_width
+
+      # @param [Hash] options An options hash for the column
+      #
+      # @option options [Integer] :span The columns this column should span
+      def build(options = {})
+        options = options.dup
+        @span_size = options.delete(:span) || 1
+        @max_width = options.delete(:max_width)
+        @min_width = options.delete(:min_width)
+
+        super(options)
+      end
+
+      def set_column_styles(column_width, margin_width, is_last_column = false)
+        column_with_span_width = (span_size * column_width) + ((span_size - 1) * margin_width)
+
+        styles = []
+
+        styles << "width: #{column_with_span_width}%;"
+
+        if max_width
+          styles << "max-width: #{safe_width(max_width)};"
+        end
+
+        if min_width
+          styles << "min-width: #{safe_width(min_width)};"
+        end
+
+        styles << "margin-right: #{margin_width}%;" unless is_last_column
+
+        set_attribute :style, styles.join(" ")
+      end
+
+      private
+
+      # Converts values without a '%' or 'px' suffix to a pixel value
+      def safe_width(width)
+        width.to_s.gsub(/\A(\d+)\z/, '\1px')
+      end
+
+    end
+  end
+end

data/lib/active_admin/views/components/dropdown_menu.rb

@@ -0,0 +1,71 @@
+module ActiveAdmin
+  module Views
+
+    # Action List - A button with a drop down menu of links
+    #
+    # Creating a new action list:
+    #
+    #     dropdown_menu "Administration" do
+    #       item "Edit Details", edit_details_path
+    #       item "Edit My Account", edit_my_account_path
+    #     end
+    #
+    # This will create a button with the label "Administration" and
+    # a drop down once clicked with 2 options.
+    #
+    class DropdownMenu < ActiveAdmin::Component
+      builder_method :dropdown_menu
+
+      # Build a new action list
+      #
+      # @param [String] name  The name to display in the button
+      #
+      # @param [Hash] options A set of options that get passed along to
+      #                       to the parent dom element.
+      def build(name, options = {})
+        options = options.dup
+
+        # Easily set options for the button or menu
+        button_options = options.delete(:button) || {}
+        menu_options = options.delete(:menu) || {}
+
+        @button = build_button(name, button_options)
+        @menu = build_menu(menu_options)
+
+        super(options)
+      end
+
+      def item(*args)
+        within @menu do
+          li link_to(*args)
+        end
+      end
+
+      private
+
+      def build_button(name, button_options)
+        button_options[:class] ||= ''
+        button_options[:class] << ' dropdown_menu_button'
+
+        button_options[:href] = '#'
+
+        a name, button_options
+      end
+
+      def build_menu(options)
+        options[:class] ||= ''
+        options[:class] << ' dropdown_menu_list'
+
+        menu_list = nil
+
+        div class: 'dropdown_menu_list_wrapper' do
+          menu_list = ul(options)
+        end
+
+        menu_list
+      end
+
+    end
+
+  end
+end

data/lib/active_admin/views/components/index_list.rb

@@ -0,0 +1,69 @@
+require 'active_admin/helpers/collection'
+
+module ActiveAdmin
+  module Views
+
+    # Renders a collection of index views available to the resource
+    # as a list with a separator
+    class IndexList < ActiveAdmin::Component
+      builder_method :index_list_renderer
+
+      include ::ActiveAdmin::Helpers::Collection
+
+      def default_class_name
+        "indexes table_tools_segmented_control"
+      end
+
+      def tag_name
+        'ul'
+      end
+
+      # Builds the links for presenting different index views to the user
+      #
+      # @param [Array] index_classes The class constants that represent index page presenters
+      def build(index_classes)
+        unless current_filter_search_empty?
+          index_classes.each do |index_class|
+            build_index_list(index_class)
+          end
+        end
+      end
+
+      protected
+
+      # Builds the individual link and HTML classes for each index page presenter
+      #
+      # @param [Class] index_class The class on which to build the link and html classes
+      def build_index_list(index_class)
+        li class: classes_for_index(index_class) do
+          params = request.query_parameters.except :page, :commit, :format
+          url_with_params = url_for(params.merge(as: index_class.index_name.to_sym))
+
+          a href: url_with_params, class: "table_tools_button" do
+            name = index_class.index_name
+            I18n.t("active_admin.index_list.#{name}", default: name.to_s.titleize)
+          end
+        end
+      end
+
+      def classes_for_index(index_class)
+        classes = ["index"]
+        classes << "selected" if current_index?(index_class)
+        classes.join(" ")
+      end
+
+      def current_index?(index_class)
+        if params[:as]
+          params[:as] == index_class.index_name
+        else
+          active_admin_config.default_index_class == index_class
+        end
+      end
+
+      def current_filter_search_empty?
+        params.include?(:q) && collection_is_empty?
+      end
+
+    end
+  end
+end

data/lib/active_admin/views/components/menu.rb

@@ -0,0 +1,32 @@
+module ActiveAdmin
+  module Views
+
+    # Renders an ActiveAdmin::Menu as a set of unordered list items.
+    #
+    # This component takes cares of deciding which items should be
+    # displayed given the current context and renders them appropriately.
+    #
+    # The entire component is rendered within one ul element.
+    class Menu < Component
+      attr_reader :menu
+      builder_method :menu
+
+      # @param [ActiveAdmin::Menu] menu the Menu to render
+      # @param [Hash] options the options as passed to the underlying ul element.
+      #
+      def build(menu, options = {})
+        @menu = menu
+        super(options)
+
+        menu.items.each do |item|
+          menu_item(item) if helpers.render_in_context self, item.should_display
+        end
+        children.sort!
+      end
+
+      def tag_name
+        'ul'
+      end
+    end
+  end
+end