Add latest changes from gitlab-org/gitlab@13-12-stable-eev13.12.0-rc42

1 files changed, 60 insertions, 0 deletions

diff --git a/lib/sidebars/concerns/container_with_html_options.rb b/lib/sidebars/concerns/container_with_html_options.rb
new file mode 100644
index 00000000000..873cb5b0de9
--- /dev/null
+++ b/lib/sidebars/concerns/container_with_html_options.rb
@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module Sidebars
+  module Concerns
+    module ContainerWithHtmlOptions
+      # The attributes returned from this method
+      # will be applied to helper methods like
+      # `link_to` or the div containing the container.
+      def container_html_options
+        {
+          aria: { label: title }
+        }.merge(extra_container_html_options)
+      end
+
+      # Classes will override mostly this method
+      # and not `container_html_options`.
+      def extra_container_html_options
+        {}
+      end
+
+      # The attributes returned from this method
+      # will be applied to helper methods like
+      # `link_to` or the div containing the container
+      # when it is collapsed.
+      def collapsed_container_html_options
+        {
+          aria: { label: title }
+        }.merge(extra_collapsed_container_html_options)
+      end
+
+      # Classes should mostly override this method
+      # and not `collapsed_container_html_options`.
+      def extra_collapsed_container_html_options
+        {}
+      end
+
+      # Attributes to pass to the html_options attribute
+      # in the helper method that sets the active class
+      # on each element.
+      def nav_link_html_options
+        {}
+      end
+
+      def title
+        raise NotImplementedError
+      end
+
+      # The attributes returned from this method
+      # will be applied right next to the title,
+      # for example in the span that renders the title.
+      def title_html_options
+        {}
+      end
+
+      def link
+        raise NotImplementedError
+      end
+    end
+  end
+end