Contents

# frozen_string_literal: true

module Primer
  # Use `Spinner` to let users know that content is being loaded.
  class SpinnerComponent < Primer::Component
    status :beta

    DEFAULT_SIZE = :medium
    SIZE_MAPPINGS = {
      :small => 16,
      DEFAULT_SIZE => 32,
      :large => 64
    }.freeze
    SIZE_OPTIONS = SIZE_MAPPINGS.keys
    # Setting `box-sizing: content-box` allows consumers to add padding
    # to the spinner without shrinking the icon
    DEFAULT_STYLE = "box-sizing: content-box; color: var(--color-icon-primary);"

    #
    # @example Default
    #   <%= render(Primer::SpinnerComponent.new) %>
    #
    # @example Small
    #   <%= render(Primer::SpinnerComponent.new(size: :small)) %>
    #
    # @example Large
    #   <%= render(Primer::SpinnerComponent.new(size: :large)) %>
    #
    # @param size [Symbol] <%= one_of(Primer::SpinnerComponent::SIZE_MAPPINGS) %>
    def initialize(size: DEFAULT_SIZE, style: DEFAULT_STYLE, **system_arguments)
      @system_arguments = system_arguments
      @system_arguments[:tag] = :svg
      @system_arguments[:style] ||= style
      @system_arguments[:animation] = :rotate
      @system_arguments[:width] = SIZE_MAPPINGS[fetch_or_fallback(SIZE_OPTIONS, size, DEFAULT_SIZE)]
      @system_arguments[:height] = SIZE_MAPPINGS[fetch_or_fallback(SIZE_OPTIONS, size, DEFAULT_SIZE)]
      @system_arguments[:viewBox] = "0 0 16 16"
      @system_arguments[:fill] = :none
    end
  end
end

Version data entries

4 entries across 4 versions & 1 rubygems

Version	Path
primer_view_components-0.0.43	app/components/primer/spinner_component.rb
primer_view_components-0.0.42	app/components/primer/spinner_component.rb
primer_view_components-0.0.41	app/components/primer/spinner_component.rb
primer_view_components-0.0.40	app/components/primer/spinner_component.rb