openproject-primer_view_components 0.11.0 → 0.12.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +75 -0
- data/app/assets/javascripts/app/components/primer/primer.d.ts +1 -1
- data/app/assets/javascripts/primer_view_components.js +1 -1
- data/app/assets/javascripts/primer_view_components.js.map +1 -1
- data/app/assets/styles/primer_view_components.css +1 -1
- data/app/assets/styles/primer_view_components.css.map +1 -1
- data/app/components/primer/alpha/action_menu/action_menu_element.js +2 -1
- data/app/components/primer/alpha/action_menu/action_menu_element.ts +2 -1
- data/app/components/primer/alpha/check_box_group.rb +2 -0
- data/app/components/primer/alpha/dialog/header.rb +12 -0
- data/app/components/primer/alpha/dialog.rb +1 -1
- data/app/components/primer/alpha/nav_list/divider.rb +2 -5
- data/app/components/primer/alpha/nav_list/group.rb +2 -98
- data/app/components/primer/alpha/nav_list/heading.rb +2 -27
- data/app/components/primer/alpha/nav_list/item.rb +2 -147
- data/app/components/primer/alpha/nav_list.rb +2 -205
- data/app/components/primer/alpha/overlay.css +1 -1
- data/app/components/primer/alpha/overlay.css.map +1 -1
- data/app/components/primer/alpha/overlay.pcss +1 -7
- data/app/components/primer/alpha/overlay.rb +6 -4
- data/app/components/primer/alpha/radio_button_group.rb +2 -0
- data/app/components/primer/alpha/text_field.css +1 -1
- data/app/components/primer/alpha/text_field.css.json +4 -1
- data/app/components/primer/alpha/text_field.css.map +1 -1
- data/app/components/primer/alpha/text_field.pcss +18 -3
- data/app/components/primer/alpha/tooltip.rb +3 -1
- data/app/components/primer/beta/button.css +1 -1
- data/app/components/primer/beta/button.css.json +2 -0
- data/app/components/primer/beta/button.css.map +1 -1
- data/app/components/primer/beta/button.pcss +11 -3
- data/app/components/primer/beta/icon_button.html.erb +1 -1
- data/app/components/primer/beta/icon_button.rb +8 -1
- data/app/components/primer/beta/link.css +1 -1
- data/app/components/primer/beta/link.css.json +1 -0
- data/app/components/primer/beta/link.css.map +1 -1
- data/app/components/primer/beta/link.pcss +5 -0
- data/app/components/primer/beta/link.rb +2 -2
- data/app/components/primer/beta/nav_list/divider.rb +14 -0
- data/app/components/primer/beta/nav_list/group.rb +107 -0
- data/app/components/primer/beta/nav_list/heading.rb +36 -0
- data/app/components/primer/beta/nav_list/item.rb +156 -0
- data/app/components/primer/beta/nav_list.rb +212 -0
- data/app/components/primer/focus_group.js +2 -1
- data/app/components/primer/focus_group.ts +2 -1
- data/app/components/primer/open_project/flex_layout.html.erb +23 -0
- data/app/components/primer/open_project/flex_layout.rb +52 -0
- data/app/components/primer/open_project/grid_layout/area.rb +38 -0
- data/app/components/primer/open_project/grid_layout.html.erb +11 -0
- data/app/components/primer/open_project/grid_layout.rb +34 -0
- data/app/components/primer/open_project/page_header.css +1 -1
- data/app/components/primer/open_project/page_header.css.map +1 -1
- data/app/components/primer/open_project/page_header.pcss +4 -0
- data/app/components/primer/primer.d.ts +1 -1
- data/app/components/primer/primer.js +1 -1
- data/app/components/primer/primer.ts +1 -1
- data/app/helpers/primer/form_helper.rb +10 -0
- data/lib/primer/deprecations.yml +20 -0
- data/lib/primer/forms/check_box_group.html.erb +3 -0
- data/lib/primer/forms/dsl/check_box_group_input.rb +1 -5
- data/lib/primer/forms/dsl/check_box_input.rb +5 -0
- data/lib/primer/forms/dsl/radio_button_input.rb +5 -0
- data/lib/primer/forms/form_control.html.erb +1 -4
- data/lib/primer/forms/radio_button_group.html.erb +3 -0
- data/lib/primer/forms/utils.rb +2 -0
- data/lib/primer/forms/validation_message.html.erb +4 -0
- data/lib/primer/forms/validation_message.rb +14 -0
- data/lib/primer/forms.rb +16 -0
- data/lib/primer/view_components/version.rb +2 -2
- data/lib/primer/yard/component_manifest.rb +4 -0
- data/previews/primer/alpha/check_box_group_preview.rb +13 -0
- data/previews/primer/alpha/dialog_preview/with_header.html.erb +5 -0
- data/previews/primer/alpha/dialog_preview.rb +17 -0
- data/previews/primer/alpha/overlay_preview.rb +1 -1
- data/previews/primer/alpha/radio_button_group_preview.rb +13 -0
- data/previews/primer/alpha/radio_button_preview.rb +1 -1
- data/previews/primer/alpha/text_field_preview/input_group_leading_action_menu.html.erb +21 -0
- data/previews/primer/alpha/text_field_preview/input_group_leading_button.html.erb +18 -0
- data/previews/primer/alpha/text_field_preview/input_group_trailing_button.html.erb +18 -0
- data/previews/primer/alpha/text_field_preview.rb +21 -0
- data/previews/primer/beta/button_preview.rb +1 -1
- data/previews/primer/{alpha → beta}/nav_list_preview/trailing_action.html.erb +1 -1
- data/previews/primer/{alpha → beta}/nav_list_preview.rb +5 -5
- data/previews/primer/open_project/flex_layout_preview.rb +73 -0
- data/previews/primer/open_project/grid_layout_preview.rb +37 -0
- data/static/arguments.json +260 -6
- data/static/audited_at.json +8 -0
- data/static/classes.json +3 -0
- data/static/constants.json +35 -0
- data/static/info_arch.json +1235 -505
- data/static/previews.json +192 -7
- data/static/statuses.json +13 -5
- metadata +30 -11
- /data/app/assets/javascripts/app/components/primer/{alpha → beta}/nav_list.d.ts +0 -0
- /data/app/components/primer/{alpha → beta}/nav_list/group.html.erb +0 -0
- /data/app/components/primer/{alpha → beta}/nav_list/item.html.erb +0 -0
- /data/app/components/primer/{alpha → beta}/nav_list.d.ts +0 -0
- /data/app/components/primer/{alpha → beta}/nav_list.html.erb +0 -0
- /data/app/components/primer/{alpha → beta}/nav_list.js +0 -0
- /data/app/components/primer/{alpha → beta}/nav_list.ts +0 -0
@@ -0,0 +1,107 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
module Primer
|
4
|
+
module Beta
|
5
|
+
class NavList
|
6
|
+
# A logical grouping of navigation links with an optional heading.
|
7
|
+
#
|
8
|
+
# See <%= link_to_component(Primer::Beta::NavList) %> for usage examples.
|
9
|
+
class Group < Primer::Alpha::ActionList
|
10
|
+
# A special "show more" list item that appears at the bottom of the group. Clicking
|
11
|
+
# the item will fetch the next page of results from the URL passed in the `src` argument
|
12
|
+
# and append the resulting chunk of HTML to the group.
|
13
|
+
#
|
14
|
+
# @param src [String] The URL to query for additional pages of list items.
|
15
|
+
# @param pages [Integer] The total number of pages in the result set.
|
16
|
+
# @param component_klass [Class] A component class to use instead of the default `Primer::Beta::NavList::Item` class.
|
17
|
+
# @param system_arguments [Hash] The arguments accepted by <%= link_to_component(Primer::Beta::NavList::Item) %>.
|
18
|
+
renders_one :show_more_item, lambda { |src:, pages:, component_klass: NavList::Item, **system_arguments|
|
19
|
+
system_arguments[:classes] = class_names(
|
20
|
+
@item_classes,
|
21
|
+
system_arguments[:classes]
|
22
|
+
)
|
23
|
+
system_arguments[:tag] = :div
|
24
|
+
system_arguments[:id] ||= self.class.generate_id(base_name: "item")
|
25
|
+
system_arguments[:hidden] = true
|
26
|
+
system_arguments[:href] = "#"
|
27
|
+
system_arguments[:data] ||= {}
|
28
|
+
system_arguments[:data][:target] = "nav-list.showMoreItem"
|
29
|
+
system_arguments[:data][:action] = "click:nav-list#showMore"
|
30
|
+
system_arguments[:data][:current_page] = "1"
|
31
|
+
system_arguments[:data][:total_pages] = pages.to_s
|
32
|
+
system_arguments[:label_arguments] = {
|
33
|
+
**system_arguments[:label_arguments] || {},
|
34
|
+
color: :accent
|
35
|
+
}
|
36
|
+
|
37
|
+
system_arguments[:content_arguments] = {
|
38
|
+
**system_arguments[:content_arguments] || {},
|
39
|
+
tag: :button
|
40
|
+
}
|
41
|
+
|
42
|
+
system_arguments[:content_arguments][:data] = merge_data(
|
43
|
+
system_arguments[:content_arguments],
|
44
|
+
data: { list_id: id }
|
45
|
+
)
|
46
|
+
|
47
|
+
component_klass.new(list: self, src: src, **system_arguments)
|
48
|
+
}
|
49
|
+
|
50
|
+
# @private
|
51
|
+
def self.custom_element_name
|
52
|
+
Primer::Beta::NavList.custom_element_name
|
53
|
+
end
|
54
|
+
|
55
|
+
# @param selected_item_id [Symbol] The ID of the currently selected item. Used internally.
|
56
|
+
# @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
|
57
|
+
def initialize(selected_item_id: nil, **system_arguments)
|
58
|
+
@system_arguments = system_arguments
|
59
|
+
@selected_item_id = selected_item_id
|
60
|
+
|
61
|
+
super(**@system_arguments)
|
62
|
+
end
|
63
|
+
|
64
|
+
# Cause this group to show its list of sub items when rendered.
|
65
|
+
# :nocov:
|
66
|
+
def expand!
|
67
|
+
@expanded = true
|
68
|
+
end
|
69
|
+
# :nocov:
|
70
|
+
|
71
|
+
# @!parse
|
72
|
+
# # Items.
|
73
|
+
# #
|
74
|
+
# # @param system_arguments [Hash] The arguments accepted by <%= link_to_component(Primer::Beta::NavList::Item) %>.
|
75
|
+
# renders_many :items
|
76
|
+
|
77
|
+
# @private
|
78
|
+
def build_item(component_klass: NavList::Item, **system_arguments)
|
79
|
+
super(
|
80
|
+
component_klass: component_klass,
|
81
|
+
selected_item_id: @selected_item_id,
|
82
|
+
**system_arguments
|
83
|
+
)
|
84
|
+
end
|
85
|
+
|
86
|
+
# @private
|
87
|
+
def build_avatar_item(component_klass: NavList::Item, **system_arguments)
|
88
|
+
super(
|
89
|
+
component_klass: component_klass,
|
90
|
+
selected_item_id: @selected_item_id,
|
91
|
+
**system_arguments
|
92
|
+
)
|
93
|
+
end
|
94
|
+
|
95
|
+
def kind
|
96
|
+
:group
|
97
|
+
end
|
98
|
+
|
99
|
+
def before_render
|
100
|
+
super
|
101
|
+
|
102
|
+
raise ArgumentError, "NavList groups are required to have headings" unless heading?
|
103
|
+
end
|
104
|
+
end
|
105
|
+
end
|
106
|
+
end
|
107
|
+
end
|
@@ -0,0 +1,36 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
module Primer
|
4
|
+
module Beta
|
5
|
+
class NavList
|
6
|
+
# The heading placed above a `NavList`'s items.
|
7
|
+
#
|
8
|
+
# See <%= link_to_component(Primer::Beta::NavList) %> for usage examples.
|
9
|
+
class Heading < Primer::Component
|
10
|
+
attr_reader :title, :id, :heading_level, :system_arguments
|
11
|
+
|
12
|
+
# @param title [String] The text content of the heading.
|
13
|
+
# @param id [String] The value of the ID HTML attribute. Auto-generated by default.
|
14
|
+
# @param heading_level [Integer] The heading level, i.e. 2 for an `<h2>`, 3 for an `<h3>`, etc.
|
15
|
+
# @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
|
16
|
+
def initialize(title:, id: self.class.generate_id, heading_level: 2, **system_arguments)
|
17
|
+
@title = title
|
18
|
+
@id = id
|
19
|
+
@heading_level = heading_level
|
20
|
+
@system_arguments = system_arguments
|
21
|
+
end
|
22
|
+
|
23
|
+
def call
|
24
|
+
render(
|
25
|
+
Primer::BaseComponent.new(
|
26
|
+
tag: :"h#{heading_level}",
|
27
|
+
id: id,
|
28
|
+
classes: "ActionListHeader",
|
29
|
+
**system_arguments
|
30
|
+
).with_content(title)
|
31
|
+
)
|
32
|
+
end
|
33
|
+
end
|
34
|
+
end
|
35
|
+
end
|
36
|
+
end
|
@@ -0,0 +1,156 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
module Primer
|
4
|
+
module Beta
|
5
|
+
class NavList
|
6
|
+
# Items are rendered as styled links. They can optionally include leading and/or trailing visuals,
|
7
|
+
# such as icons, avatars, and counters. Items are selected by ID. IDs can be specified via the
|
8
|
+
# `selected_item_ids` argument, which accepts a list of valid IDs for the item. Items can also
|
9
|
+
# themselves contain sub items. Sub items are rendered collapsed by default.
|
10
|
+
class Item < Primer::Alpha::ActionList::Item
|
11
|
+
attr_reader :selected_by_ids, :sub_item
|
12
|
+
|
13
|
+
# @param system_arguments [Hash] The arguments accepted by <%= link_to_component(Primer::Alpha::ActionList::Item) %>.
|
14
|
+
renders_many :items, lambda { |**system_arguments|
|
15
|
+
raise "Items can only be nested 2 levels deep" if sub_item?
|
16
|
+
|
17
|
+
@list.build_item(parent: self, sub_item: true, **system_arguments).tap do |item|
|
18
|
+
@list.will_add_item(item)
|
19
|
+
end
|
20
|
+
}
|
21
|
+
|
22
|
+
# Whether or not this item is nested under a parent item.
|
23
|
+
#
|
24
|
+
# @return [Boolean]
|
25
|
+
alias sub_item? sub_item
|
26
|
+
|
27
|
+
# @param selected_item_id [Symbol] The ID of the currently selected list item. Used internally.
|
28
|
+
# @param selected_by_ids [Array<Symbol>] The list of IDs that select this item. In other words, if the `selected_item_id` attribute on the parent `NavList` is set to one of these IDs, the item will appear selected.
|
29
|
+
# @param expanded [Boolean] Whether this item shows (expands) or hides (collapses) its list of sub items.
|
30
|
+
# @param sub_item [Boolean] Whether or not this item is nested under a parent item. Used internally.
|
31
|
+
# @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
|
32
|
+
def initialize(selected_item_id: nil, selected_by_ids: [], sub_item: false, expanded: false, **system_arguments)
|
33
|
+
@selected_item_id = selected_item_id
|
34
|
+
@selected_by_ids = Array(selected_by_ids)
|
35
|
+
@expanded = expanded
|
36
|
+
@sub_item = sub_item
|
37
|
+
|
38
|
+
system_arguments[:classes] = class_names(
|
39
|
+
system_arguments[:classes],
|
40
|
+
"ActionListItem--subItem" => @sub_item
|
41
|
+
)
|
42
|
+
|
43
|
+
@sub_list_arguments = {
|
44
|
+
classes: class_names(
|
45
|
+
"ActionList",
|
46
|
+
"ActionList--subGroup"
|
47
|
+
)
|
48
|
+
}
|
49
|
+
|
50
|
+
@list = system_arguments[:list]
|
51
|
+
|
52
|
+
@sub_list_arguments["data-action"] = "keydown:#{@list.custom_element_name}#handleItemWithSubItemKeydown" if @list
|
53
|
+
|
54
|
+
overrides = { "data-item-id": @selected_by_ids.join(" ") }
|
55
|
+
|
56
|
+
super(**system_arguments, **overrides)
|
57
|
+
end
|
58
|
+
|
59
|
+
def active?
|
60
|
+
item_active?(self) && items.empty?
|
61
|
+
end
|
62
|
+
|
63
|
+
# Cause this item to show its list of sub items when rendered.
|
64
|
+
def expand!
|
65
|
+
@expanded = true
|
66
|
+
end
|
67
|
+
|
68
|
+
def before_render
|
69
|
+
if active_sub_item?
|
70
|
+
expand!
|
71
|
+
|
72
|
+
@content_arguments[:classes] = class_names(
|
73
|
+
@content_arguments[:classes],
|
74
|
+
"ActionListContent--hasActiveSubItem"
|
75
|
+
)
|
76
|
+
else
|
77
|
+
@system_arguments[:classes] = class_names(
|
78
|
+
@system_arguments[:classes],
|
79
|
+
"ActionListItem--navActive" => active?
|
80
|
+
)
|
81
|
+
end
|
82
|
+
|
83
|
+
@content_arguments[:"aria-current"] = "page" if active?
|
84
|
+
|
85
|
+
super
|
86
|
+
|
87
|
+
raise "Cannot render a trailing action for an item with subitems" if items.present? && trailing_action.present?
|
88
|
+
|
89
|
+
raise "Cannot pass `selected_by_ids:` for an item with subitems, since parent items cannot be selected" if items.present? && @selected_by_ids.present?
|
90
|
+
|
91
|
+
return if items.blank?
|
92
|
+
|
93
|
+
@sub_list_arguments[:aria] = merge_aria(
|
94
|
+
@sub_list_arguments,
|
95
|
+
{ aria: { labelledby: id } }
|
96
|
+
)
|
97
|
+
|
98
|
+
raise ArgumentError, "Items with sub-items cannot have hrefs" if href.present?
|
99
|
+
|
100
|
+
@content_arguments[:tag] = :button
|
101
|
+
@content_arguments[:"aria-expanded"] = @expanded.to_s
|
102
|
+
@content_arguments[:"data-action"] = "
|
103
|
+
click:#{@list.custom_element_name}#handleItemWithSubItemClick
|
104
|
+
keydown:#{@list.custom_element_name}#handleItemWithSubItemKeydown
|
105
|
+
"
|
106
|
+
|
107
|
+
with_private_trailing_action_icon(:"chevron-down", classes: "ActionListItem-collapseIcon")
|
108
|
+
|
109
|
+
@system_arguments[:classes] = class_names(
|
110
|
+
@system_arguments[:classes],
|
111
|
+
"ActionListItem--hasSubItem"
|
112
|
+
)
|
113
|
+
end
|
114
|
+
|
115
|
+
def kind
|
116
|
+
:item
|
117
|
+
end
|
118
|
+
|
119
|
+
private
|
120
|
+
|
121
|
+
# Normally it would be easier to simply ask each item for its active status, eg.
|
122
|
+
# items.any?(&:active?), but unfortunately the view context is not set on each
|
123
|
+
# item until _after_ the parent's before_render, etc methods have been called.
|
124
|
+
# This means helper methods like current_page? will blow up with an error, since
|
125
|
+
# `helpers` is simply an alias for the view context (i.e. an instance of
|
126
|
+
# ActionView::Base). Since we know the view context for the parent object must
|
127
|
+
# be set before `before_render` is invoked, we can call helper methods here in
|
128
|
+
# the parent and bypass the problem entirely. Maybe not the most OO approach,
|
129
|
+
# but it works.
|
130
|
+
def item_active?(item)
|
131
|
+
if item.selected_by_ids.present?
|
132
|
+
item.selected_by_ids.include?(@selected_item_id)
|
133
|
+
elsif item.href
|
134
|
+
current_page?(item.href)
|
135
|
+
else
|
136
|
+
# :nocov:
|
137
|
+
false
|
138
|
+
# :nocov:
|
139
|
+
end
|
140
|
+
end
|
141
|
+
|
142
|
+
def active_sub_item?
|
143
|
+
items.any? { |subitem| item_active?(subitem) }
|
144
|
+
end
|
145
|
+
|
146
|
+
def current_page?(url)
|
147
|
+
helpers.current_page?(url)
|
148
|
+
end
|
149
|
+
|
150
|
+
def list_class
|
151
|
+
Primer::Beta::NavList
|
152
|
+
end
|
153
|
+
end
|
154
|
+
end
|
155
|
+
end
|
156
|
+
end
|
@@ -0,0 +1,212 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
module Primer
|
4
|
+
module Beta
|
5
|
+
# `NavList` provides a simple way to render side navigation, i.e. navigation
|
6
|
+
# that appears to the left or right side of some main content. Each group in a
|
7
|
+
# nav list is a list of links.
|
8
|
+
#
|
9
|
+
# Nav list groups can contain sub items. Rather than navigating to a URL, groups
|
10
|
+
# with sub items expand and collapse on click. To indicate this functionality, the
|
11
|
+
# group will automatically render with a trailing chevron icon that changes direction
|
12
|
+
# when the group expands and collapses.
|
13
|
+
#
|
14
|
+
# Nav list items appear visually active when selected. Each nav item must have one
|
15
|
+
# or more ID values that determine which item will appear selected. Use the
|
16
|
+
# `selected_item_id` argument to select the appropriate item.
|
17
|
+
class NavList < Primer::Component
|
18
|
+
status :beta
|
19
|
+
audited_at "2023-07-10"
|
20
|
+
|
21
|
+
# @private
|
22
|
+
def self.custom_element_name
|
23
|
+
"nav-list"
|
24
|
+
end
|
25
|
+
|
26
|
+
# The heading for the list at large. Accepts the arguments accepted by <%= link_to_component(Primer::Beta::NavList::Heading) %>.
|
27
|
+
#
|
28
|
+
renders_one :heading, Primer::Beta::NavList::Heading
|
29
|
+
|
30
|
+
# @!parse
|
31
|
+
# # Adds an item to the list.
|
32
|
+
# #
|
33
|
+
# # @param component_klass [Class] The class to use instead of the default <%= link_to_component(Primer::Beta::NavList::Item) %>
|
34
|
+
# # @param system_arguments [Hash] These arguments are forwarded to <%= link_to_component(Primer::Beta::NavList::Item) %>, or whatever class is passed as the `component_klass` argument.
|
35
|
+
# def with_item(component_klass: Primer::Beta::NavList::Item, **system_arguments, &block)
|
36
|
+
# end
|
37
|
+
|
38
|
+
# @!parse
|
39
|
+
# # Adds an avatar item to the list. Avatar items are a convenient way to accessibly add an item with a leading avatar image.
|
40
|
+
# #
|
41
|
+
# # @param src [String] The source url of the avatar image.
|
42
|
+
# # @param username [String] The username associated with the avatar.
|
43
|
+
# # @param full_name [String] Optional. The user's full name.
|
44
|
+
# # @param full_name_scheme [Symbol] Optional. How to display the user's full name. <%= one_of(Primer::Alpha::ActionList::Item::DESCRIPTION_SCHEME_OPTIONS) %>
|
45
|
+
# # @param component_klass [Class] The class to use instead of the default <%= link_to_component(Primer::Beta::NavList::Item) %>
|
46
|
+
# # @param avatar_arguments [Hash] Optional. The arguments accepted by <%= link_to_component(Primer::Beta::Avatar) %>
|
47
|
+
# # @param system_arguments [Hash] These arguments are forwarded to <%= link_to_component(Primer::Beta::NavList::Item) %>, or whatever class is passed as the `component_klass` argument.
|
48
|
+
# def with_avatar_item(src:, username:, full_name: nil, full_name_scheme: Primer::Alpha::ActionList::Item::DEFAULT_DESCRIPTION_SCHEME, component_klass: Primer::Beta::NavList::Item, avatar_arguments: {}, **system_arguments, &block)
|
49
|
+
# end
|
50
|
+
|
51
|
+
# @!parse
|
52
|
+
# # Adds a group to the list. A group is a list of links and a (required) heading.
|
53
|
+
# #
|
54
|
+
# # @param system_arguments [Hash] The arguments accepted by <%= link_to_component(Primer::Beta::NavList::Group) %>.
|
55
|
+
# def with_group(**system_arguments, &block)
|
56
|
+
# end
|
57
|
+
|
58
|
+
# @!parse
|
59
|
+
# # Adds a divider to the list. Dividers visually separate items and groups.
|
60
|
+
# #
|
61
|
+
# # @param system_arguments [Hash] The arguments accepted by <%= link_to_component(Primer::Beta::NavList::Divider) %>.
|
62
|
+
# def with_divider(**system_arguments, &block)
|
63
|
+
# end
|
64
|
+
|
65
|
+
# Items. Items can be individual items, dividers, or groups. See the documentation for `#with_item`, `#with_divider`, and `#with_group` respectively for more information.
|
66
|
+
#
|
67
|
+
renders_many :items, types: {
|
68
|
+
item: {
|
69
|
+
renders: lambda { |**system_arguments, &block|
|
70
|
+
build_item(**system_arguments, &block)
|
71
|
+
},
|
72
|
+
|
73
|
+
as: :item
|
74
|
+
},
|
75
|
+
|
76
|
+
avatar_item: {
|
77
|
+
renders: lambda { |**system_arguments|
|
78
|
+
build_avatar_item(**system_arguments)
|
79
|
+
},
|
80
|
+
|
81
|
+
as: :avatar_item
|
82
|
+
},
|
83
|
+
|
84
|
+
divider: {
|
85
|
+
renders: Primer::Beta::NavList::Divider,
|
86
|
+
as: :divider
|
87
|
+
},
|
88
|
+
|
89
|
+
group: {
|
90
|
+
renders: lambda { |**system_arguments, &block|
|
91
|
+
Primer::Beta::NavList::Group.new(
|
92
|
+
selected_item_id: @selected_item_id,
|
93
|
+
**system_arguments,
|
94
|
+
&block
|
95
|
+
)
|
96
|
+
},
|
97
|
+
|
98
|
+
as: :group
|
99
|
+
}
|
100
|
+
}
|
101
|
+
|
102
|
+
# @param selected_item_id [Symbol] The ID of the currently selected item. The default is `nil`, meaning no item is selected.
|
103
|
+
# @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
|
104
|
+
def initialize(selected_item_id: nil, **system_arguments)
|
105
|
+
@system_arguments = system_arguments
|
106
|
+
@selected_item_id = selected_item_id
|
107
|
+
end
|
108
|
+
|
109
|
+
# Builds a new item but does not add it to the list. Use this method
|
110
|
+
# instead of the `#with_item` slot if you need to render an item outside
|
111
|
+
# the context of a list, eg. if rendering additional items to append to
|
112
|
+
# an existing list, perhaps via a separate HTTP request.
|
113
|
+
#
|
114
|
+
# @param component_klass [Class] The class to use instead of the default <%= link_to_component(Primer::Beta::NavList::Item) %>
|
115
|
+
# @param system_arguments [Hash] These arguments are forwarded to <%= link_to_component(Primer::Beta::NavList::Item) %>, or whatever class is passed as the `component_klass` argument.
|
116
|
+
def build_item(component_klass: Primer::Beta::NavList::Item, **system_arguments, &block)
|
117
|
+
component_klass.new(
|
118
|
+
list: top_level_group,
|
119
|
+
selected_item_id: @selected_item_id,
|
120
|
+
**system_arguments,
|
121
|
+
&block
|
122
|
+
)
|
123
|
+
end
|
124
|
+
|
125
|
+
# Builds a new avatar item but does not add it to the list. Avatar items
|
126
|
+
# are a convenient way to accessibly add an item with a leading avatar
|
127
|
+
# image. Use this method instead of the `#with_avatar_item` slot if you
|
128
|
+
# need to render an avatar item outside the context of a list, eg. if
|
129
|
+
# rendering additional items to append to an existing list, perhaps via
|
130
|
+
# a separate HTTP request.
|
131
|
+
#
|
132
|
+
# @param src [String] The source url of the avatar image.
|
133
|
+
# @param username [String] The username associated with the avatar.
|
134
|
+
# @param full_name [String] Optional. The user's full name.
|
135
|
+
# @param full_name_scheme [Symbol] Optional. How to display the user's full name. <%= one_of(Primer::Alpha::ActionList::Item::DESCRIPTION_SCHEME_OPTIONS) %>
|
136
|
+
# @param component_klass [Class] The class to use instead of the default <%= link_to_component(Primer::Beta::NavList::Item) %>
|
137
|
+
# @param avatar_arguments [Hash] Optional. The arguments accepted by <%= link_to_component(Primer::Beta::Avatar) %>
|
138
|
+
# @param system_arguments [Hash] These arguments are forwarded to <%= link_to_component(Primer::Beta::NavList::Item) %>, or whatever class is passed as the `component_klass` argument.
|
139
|
+
def build_avatar_item(src:, username:, full_name: nil, full_name_scheme: Primer::Alpha::ActionList::Item::DEFAULT_DESCRIPTION_SCHEME, component_klass: Primer::Beta::NavList::Item, avatar_arguments: {}, **system_arguments)
|
140
|
+
component_klass.new(
|
141
|
+
list: top_level_group,
|
142
|
+
selected_item_id: @selected_item_id,
|
143
|
+
label: username,
|
144
|
+
description_scheme: full_name_scheme,
|
145
|
+
**system_arguments
|
146
|
+
).tap do |item|
|
147
|
+
item.with_leading_visual_raw_content do
|
148
|
+
# no alt text necessary
|
149
|
+
item.render(Primer::Beta::Avatar.new(src: src, **avatar_arguments, role: :presentation, size: 16))
|
150
|
+
end
|
151
|
+
|
152
|
+
item.with_description_content(full_name) if full_name
|
153
|
+
end
|
154
|
+
end
|
155
|
+
|
156
|
+
private
|
157
|
+
|
158
|
+
def before_render
|
159
|
+
if heading?
|
160
|
+
raise ArgumentError, "Please don't set an aria-label if a heading is provided" if aria(:label, @system_arguments)
|
161
|
+
|
162
|
+
@system_arguments[:aria] = merge_aria(
|
163
|
+
@system_arguments,
|
164
|
+
{ aria: { labelledby: heading.id } }
|
165
|
+
)
|
166
|
+
else
|
167
|
+
raise ArgumentError, "When no heading is provided, an aria-label must be given" unless aria(:label, @system_arguments)
|
168
|
+
end
|
169
|
+
end
|
170
|
+
|
171
|
+
# Lists that contain top-level items (i.e. items outside of a group) should be wrapped in a <ul>
|
172
|
+
def render_outer_list?
|
173
|
+
items.any? { |item| !group?(item) }
|
174
|
+
end
|
175
|
+
|
176
|
+
def render_divider_between?(item1, item2)
|
177
|
+
return false if either_is_divider?(item1, item2)
|
178
|
+
|
179
|
+
both_are_groups?(item1, item2) || heterogeneous?(item1, item2)
|
180
|
+
end
|
181
|
+
|
182
|
+
def both_are_groups?(item1, item2)
|
183
|
+
group?(item1) && group?(item2)
|
184
|
+
end
|
185
|
+
|
186
|
+
def heterogeneous?(item1, item2)
|
187
|
+
kind(item1) != kind(item2)
|
188
|
+
end
|
189
|
+
|
190
|
+
def either_is_divider?(item1, item2)
|
191
|
+
divider?(item1) || divider?(item2)
|
192
|
+
end
|
193
|
+
|
194
|
+
def group?(item)
|
195
|
+
kind(item) == :group
|
196
|
+
end
|
197
|
+
|
198
|
+
def divider?(item)
|
199
|
+
kind(item) == :divider
|
200
|
+
end
|
201
|
+
|
202
|
+
def kind(item)
|
203
|
+
item.respond_to?(:kind) ? item.kind : :item
|
204
|
+
end
|
205
|
+
|
206
|
+
def top_level_group
|
207
|
+
# dummy group for the list: argument in the item slot above
|
208
|
+
@top_level_group ||= Primer::Beta::NavList::Group.new(selected_item_id: @selected_item_id)
|
209
|
+
end
|
210
|
+
end
|
211
|
+
end
|
212
|
+
end
|
@@ -11,7 +11,8 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
|
|
11
11
|
};
|
12
12
|
var _FocusGroupElement_instances, _FocusGroupElement_abortController, _FocusGroupElement_items_get;
|
13
13
|
import '@oddbird/popover-polyfill';
|
14
|
-
const
|
14
|
+
const validSelectors = ['[role="menuitem"]', '[role="menuitemcheckbox"]', '[role="menuitemradio"]'];
|
15
|
+
const menuItemSelector = validSelectors.map(selector => `:not([hidden]) > ${selector}`).join(', ');
|
15
16
|
const getMnemonicFor = (item) => { var _a; return (_a = item.textContent) === null || _a === void 0 ? void 0 : _a.trim()[0].toLowerCase(); };
|
16
17
|
const printable = /^\S$/;
|
17
18
|
export default class FocusGroupElement extends HTMLElement {
|
@@ -1,6 +1,7 @@
|
|
1
1
|
import '@oddbird/popover-polyfill'
|
2
2
|
|
3
|
-
const
|
3
|
+
const validSelectors = ['[role="menuitem"]', '[role="menuitemcheckbox"]', '[role="menuitemradio"]']
|
4
|
+
const menuItemSelector = validSelectors.map(selector => `:not([hidden]) > ${selector}`).join(', ')
|
4
5
|
|
5
6
|
const getMnemonicFor = (item: Element) => item.textContent?.trim()[0].toLowerCase()
|
6
7
|
|
@@ -0,0 +1,23 @@
|
|
1
|
+
<% if rows.any? %>
|
2
|
+
<%= render(Primer::Box.new(**@system_arguments.merge(direction: :column))) do %>
|
3
|
+
<% rows.each do |row| %>
|
4
|
+
<%= row %>
|
5
|
+
<% end %>
|
6
|
+
<% end %>
|
7
|
+
<% end %>
|
8
|
+
|
9
|
+
<% if columns.any? %>
|
10
|
+
<%= render(Primer::Box.new(**@system_arguments.merge(direction: :row))) do %>
|
11
|
+
<% columns.each do |column| %>
|
12
|
+
<%= column %>
|
13
|
+
<% end %>
|
14
|
+
<% end %>
|
15
|
+
<% end %>
|
16
|
+
|
17
|
+
<% if boxes.any? %>
|
18
|
+
<%= render(Primer::Box.new(**@system_arguments)) do %>
|
19
|
+
<% boxes.each do |box| %>
|
20
|
+
<%= box %>
|
21
|
+
<% end %>
|
22
|
+
<% end %>
|
23
|
+
<% end %>
|
@@ -0,0 +1,52 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
module Primer
|
4
|
+
module OpenProject
|
5
|
+
# A layouting component used to arrange multiple components next / below each other
|
6
|
+
class FlexLayout < Primer::Component
|
7
|
+
status :open_project
|
8
|
+
|
9
|
+
renders_many :rows, lambda { |**system_arguments, &block|
|
10
|
+
child_component(system_arguments, &block)
|
11
|
+
}
|
12
|
+
renders_many :columns, lambda { |**system_arguments, &block|
|
13
|
+
child_component(system_arguments, &block)
|
14
|
+
}
|
15
|
+
# boxes are used when direction is set to row or column based on responsive breakpoints
|
16
|
+
renders_many :boxes, lambda { |**system_arguments, &block|
|
17
|
+
child_component(system_arguments, &block)
|
18
|
+
}
|
19
|
+
|
20
|
+
# @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
|
21
|
+
def initialize(**system_arguments)
|
22
|
+
super
|
23
|
+
|
24
|
+
@system_arguments = deny_tag_argument(**system_arguments) || {}
|
25
|
+
@system_arguments[:display] = :flex
|
26
|
+
end
|
27
|
+
|
28
|
+
private
|
29
|
+
|
30
|
+
def render?
|
31
|
+
# no slot provided
|
32
|
+
raise ArgumentError, "You have to provide either rows, columns or boxes as a slot" if rows.empty? && columns.empty? && boxes.empty?
|
33
|
+
|
34
|
+
if [rows, columns, boxes].count { |arr| !arr.empty? } == 1
|
35
|
+
# only rows or columns or boxes are used
|
36
|
+
true
|
37
|
+
elsif [rows, columns, boxes].count { |arr| !arr.empty? } > 1
|
38
|
+
# rows, columns and boxes are used together, which is not allowed
|
39
|
+
raise ArgumentError, "You can't mix row, column and box slots"
|
40
|
+
end
|
41
|
+
end
|
42
|
+
|
43
|
+
def child_component(system_arguments, &block)
|
44
|
+
if system_arguments[:flex_layout] == true
|
45
|
+
Primer::OpenProject::FlexLayout.new(**system_arguments.except(:flex_layout), &block)
|
46
|
+
else
|
47
|
+
Primer::Box.new(**system_arguments || {})
|
48
|
+
end
|
49
|
+
end
|
50
|
+
end
|
51
|
+
end
|
52
|
+
end
|
@@ -0,0 +1,38 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
module Primer
|
4
|
+
module OpenProject
|
5
|
+
class GridLayout
|
6
|
+
# GridLayout::Area is an internal component that wraps the items in a div with the given new class and responding "grid-area"
|
7
|
+
class Area < Primer::Component
|
8
|
+
status :open_project
|
9
|
+
|
10
|
+
DEFAULT_TAG = :div
|
11
|
+
TAG_OPTIONS = [DEFAULT_TAG, :span].freeze
|
12
|
+
|
13
|
+
# @param css_class [String] The basic css class applied on the grid-container
|
14
|
+
# @param area_name [Symbol] The specific area name, used for creating the element class and the "grid-area" style
|
15
|
+
# @param component [ViewComponent::Base] The instance of the component to be rendered.
|
16
|
+
# @param tag [Symbol] <%= one_of(Primer::OpenProject::GridLayout::Area::TAG_OPTIONS) %>
|
17
|
+
# @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
|
18
|
+
def initialize(css_class, area_name, component = ::Primer::BaseComponent, tag: DEFAULT_TAG, **system_arguments)
|
19
|
+
@component = component
|
20
|
+
@system_arguments = system_arguments
|
21
|
+
@styles = [
|
22
|
+
"grid-area: #{area_name}"
|
23
|
+
]
|
24
|
+
@system_arguments[:tag] = fetch_or_fallback(TAG_OPTIONS, tag, DEFAULT_TAG)
|
25
|
+
@system_arguments[:style] = join_style_arguments(@system_arguments[:style], *@styles)
|
26
|
+
@system_arguments[:classes] = class_names(
|
27
|
+
@system_arguments[:classes],
|
28
|
+
"#{css_class}--#{area_name}"
|
29
|
+
)
|
30
|
+
end
|
31
|
+
|
32
|
+
def call
|
33
|
+
render(@component.new(**@system_arguments)) { content }
|
34
|
+
end
|
35
|
+
end
|
36
|
+
end
|
37
|
+
end
|
38
|
+
end
|