Sha256: 4387fed0747e048a090d0980c60fb41d2a60315274c328c4013d71c951d794d6

Contents?: true

Size: 1.21 KB

Versions: 21

Compression:

Stored size: 1.21 KB

Contents

# frozen_string_literal: true

module Primer
  module Beta
    # Use `ClipboardCopy` to copy element text content or input values to the clipboard.
    #
    # @accessibility
    #   Always set an accessible label to help the user interact with the component.
    class ClipboardCopy < Primer::Component
      status :beta

      # @param aria-label [String] String that will be read to screenreaders when the component is focused
      # @param value [String] Text to copy into the users clipboard when they click the component.
      # @param for [String] Element id from where to get the copied value.
      # @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
      def initialize(value: nil, **system_arguments)
        @system_arguments = deny_tag_argument(**system_arguments)
        @value = value

        validate!

        @system_arguments[:tag] = "clipboard-copy"
        @system_arguments[:value] = value if value.present?
      end

      # :nodoc:
      def before_render
        validate_aria_label if content.blank?
      end

      private

      def validate!
        raise ArgumentError, "Must provide either `value` or `for`" if @value.nil? && @system_arguments[:for].nil?
      end
    end
  end
end

Version data entries

21 entries across 21 versions & 2 rubygems

Version Path
openproject-primer_view_components-0.16.0 app/components/primer/beta/clipboard_copy.rb
openproject-primer_view_components-0.15.0 app/components/primer/beta/clipboard_copy.rb
openproject-primer_view_components-0.14.0 app/components/primer/beta/clipboard_copy.rb
openproject-primer_view_components-0.13.1 app/components/primer/beta/clipboard_copy.rb
primer_view_components-0.13.2 app/components/primer/beta/clipboard_copy.rb
primer_view_components-0.13.1 app/components/primer/beta/clipboard_copy.rb
openproject-primer_view_components-0.13.0 app/components/primer/beta/clipboard_copy.rb
primer_view_components-0.13.0 app/components/primer/beta/clipboard_copy.rb
primer_view_components-0.12.0 app/components/primer/beta/clipboard_copy.rb
primer_view_components-0.11.0 app/components/primer/beta/clipboard_copy.rb
openproject-primer_view_components-0.12.1 app/components/primer/beta/clipboard_copy.rb
primer_view_components-0.10.0 app/components/primer/beta/clipboard_copy.rb
openproject-primer_view_components-0.11.0 app/components/primer/beta/clipboard_copy.rb
openproject-primer_view_components-0.10.0 app/components/primer/beta/clipboard_copy.rb
primer_view_components-0.9.0 app/components/primer/beta/clipboard_copy.rb
openproject-primer_view_components-0.9.1 app/components/primer/beta/clipboard_copy.rb
openproject-primer_view_components-0.9.0 app/components/primer/beta/clipboard_copy.rb
openproject-primer_view_components-0.8.0 app/components/primer/beta/clipboard_copy.rb
primer_view_components-0.8.0 app/components/primer/beta/clipboard_copy.rb
primer_view_components-0.7.0 app/components/primer/beta/clipboard_copy.rb