static/arguments.json in primer_view_components-0.9.0 vs static/arguments.json in primer_view_components-0.10.0
- old
+ new
@@ -771,10 +771,22 @@
"type": "String",
"default": "N/A",
"description": "A string describing the field and what sorts of input it expects. Displayed below the group."
},
{
+ "name": "invalid",
+ "type": "Boolean",
+ "default": "N/A",
+ "description": "If set to `true`, the input will be marked as invalid. Implied if `validation_message` is truthy. This option is set to `true` automatically if the model object associated with the form reports that the input is invalid via Rails validations. It is provided for cases where the form does not have an associated model. If the input is invalid as determined by Rails validations, setting `invalid` to `false` will have no effect."
+ },
+ {
+ "name": "validation_message",
+ "type": "String",
+ "default": "N/A",
+ "description": "A string displayed between the caption and the input indicating the input's contents are invalid. This option is, by default, set to the first Rails validation message for the input (assuming the form is associated with a model object). Use `validation_message` to override the default or to provide a validation message in case there is no associated model object."
+ },
+ {
"name": "label_arguments",
"type": "Hash",
"default": "N/A",
"description": "Attributes that will be passed to Rails' `builder.label` method. These can be HTML attributes or any of the other label options Rails supports. They will appear as HTML attributes on the `<label>` tag."
}
@@ -883,10 +895,16 @@
"short_name": "DialogHeader",
"source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/dialog/header.rb",
"lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/dialog/header/default/",
"parameters": [
{
+ "name": "id",
+ "type": "String",
+ "default": "N/A",
+ "description": "The HTML element's ID value."
+ },
+ {
"name": "title",
"type": "String",
"default": "N/A",
"description": "Describes the content of the dialog."
},
@@ -907,10 +925,16 @@
"type": "Boolean",
"default": "`false`",
"description": "Visually hide the `title` while maintaining a label for assistive technologies."
},
{
+ "name": "variant",
+ "type": "Symbol",
+ "default": "`:medium`",
+ "description": "One of `:large` or `:medium`."
+ },
+ {
"name": "system_arguments",
"type": "Hash",
"default": "N/A",
"description": "[System arguments](/system-arguments)"
}
@@ -1418,11 +1442,11 @@
}
]
},
{
"component": "NavList",
- "status": "alpha",
+ "status": "deprecated",
"a11y_reviewed": true,
"short_name": "NavList",
"source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/nav_list.rb",
"lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/nav_list/default/",
"parameters": [
@@ -1440,11 +1464,11 @@
}
]
},
{
"component": "NavList::Divider",
- "status": "alpha",
+ "status": "deprecated",
"a11y_reviewed": false,
"short_name": "NavListDivider",
"source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/nav_list/divider.rb",
"lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/nav_list/divider/default/",
"parameters": [
@@ -1462,11 +1486,11 @@
}
]
},
{
"component": "NavList::Group",
- "status": "alpha",
+ "status": "deprecated",
"a11y_reviewed": true,
"short_name": "NavListGroup",
"source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/nav_list/group.rb",
"lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/nav_list/group/default/",
"parameters": [
@@ -1484,11 +1508,11 @@
}
]
},
{
"component": "NavList::Heading",
- "status": "alpha",
+ "status": "deprecated",
"a11y_reviewed": false,
"short_name": "NavListHeading",
"source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/nav_list/heading.rb",
"lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/nav_list/heading/default/",
"parameters": [
@@ -1518,11 +1542,11 @@
}
]
},
{
"component": "NavList::Item",
- "status": "alpha",
+ "status": "deprecated",
"a11y_reviewed": false,
"short_name": "NavListItem",
"source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/nav_list/item.rb",
"lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/nav_list/item/default/",
"parameters": [
@@ -1965,10 +1989,22 @@
"type": "String",
"default": "N/A",
"description": "A string describing the field and what sorts of input it expects. Displayed below the group."
},
{
+ "name": "invalid",
+ "type": "Boolean",
+ "default": "N/A",
+ "description": "If set to `true`, the input will be marked as invalid. Implied if `validation_message` is truthy. This option is set to `true` automatically if the model object associated with the form reports that the input is invalid via Rails validations. It is provided for cases where the form does not have an associated model. If the input is invalid as determined by Rails validations, setting `invalid` to `false` will have no effect."
+ },
+ {
+ "name": "validation_message",
+ "type": "String",
+ "default": "N/A",
+ "description": "A string displayed between the caption and the input indicating the input's contents are invalid. This option is, by default, set to the first Rails validation message for the input (assuming the form is associated with a model object). Use `validation_message` to override the default or to provide a validation message in case there is no associated model object."
+ },
+ {
"name": "label_arguments",
"type": "Hash",
"default": "N/A",
"description": "Attributes that will be passed to Rails' `builder.label` method. These can be HTML attributes or any of the other label options Rails supports. They will appear as HTML attributes on the `<label>` tag."
}
@@ -3645,11 +3681,11 @@
"description": "Uses light gray for Link color, and blue on hover."
},
{
"name": "underline",
"type": "Boolean",
- "default": "`true`",
+ "default": "`false`",
"description": "Whether or not to underline the link."
},
{
"name": "system_arguments",
"type": "Hash",
@@ -3669,9 +3705,149 @@
{
"name": "tag",
"type": "Symbol",
"default": "`:div`",
"description": "One of `:article`, `:div`, or `:td`."
+ },
+ {
+ "name": "system_arguments",
+ "type": "Hash",
+ "default": "N/A",
+ "description": "[System arguments](/system-arguments)"
+ }
+ ]
+ },
+ {
+ "component": "NavList",
+ "status": "beta",
+ "a11y_reviewed": true,
+ "short_name": "NavList",
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/nav_list.rb",
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/nav_list/default/",
+ "parameters": [
+ {
+ "name": "selected_item_id",
+ "type": "Symbol",
+ "default": "`nil`",
+ "description": "The ID of the currently selected item. The default is `nil`, meaning no item is selected."
+ },
+ {
+ "name": "system_arguments",
+ "type": "Hash",
+ "default": "N/A",
+ "description": "[System arguments](/system-arguments)"
+ }
+ ]
+ },
+ {
+ "component": "NavList::Divider",
+ "status": "alpha",
+ "a11y_reviewed": false,
+ "short_name": "NavListDivider",
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/nav_list/divider.rb",
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/nav_list/divider/default/",
+ "parameters": [
+ {
+ "name": "scheme",
+ "type": "Symbol",
+ "default": "`:subtle`",
+ "description": "Display a background color if scheme is `filled`."
+ },
+ {
+ "name": "system_arguments",
+ "type": "Hash",
+ "default": "N/A",
+ "description": "[System arguments](/system-arguments)"
+ }
+ ]
+ },
+ {
+ "component": "NavList::Group",
+ "status": "alpha",
+ "a11y_reviewed": true,
+ "short_name": "NavListGroup",
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/nav_list/group.rb",
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/nav_list/group/default/",
+ "parameters": [
+ {
+ "name": "selected_item_id",
+ "type": "Symbol",
+ "default": "`nil`",
+ "description": "The ID of the currently selected item. Used internally."
+ },
+ {
+ "name": "system_arguments",
+ "type": "Hash",
+ "default": "N/A",
+ "description": "[System arguments](/system-arguments)"
+ }
+ ]
+ },
+ {
+ "component": "NavList::Heading",
+ "status": "alpha",
+ "a11y_reviewed": false,
+ "short_name": "NavListHeading",
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/nav_list/heading.rb",
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/nav_list/heading/default/",
+ "parameters": [
+ {
+ "name": "title",
+ "type": "String",
+ "default": "N/A",
+ "description": "The text content of the heading."
+ },
+ {
+ "name": "id",
+ "type": "String",
+ "default": "`self.class.generate_id`",
+ "description": "The value of the ID HTML attribute. Auto-generated by default."
+ },
+ {
+ "name": "heading_level",
+ "type": "Integer",
+ "default": "`2`",
+ "description": "The heading level, i.e. 2 for an `<h2>`, 3 for an `<h3>`, etc."
+ },
+ {
+ "name": "system_arguments",
+ "type": "Hash",
+ "default": "N/A",
+ "description": "[System arguments](/system-arguments)"
+ }
+ ]
+ },
+ {
+ "component": "NavList::Item",
+ "status": "alpha",
+ "a11y_reviewed": false,
+ "short_name": "NavListItem",
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/nav_list/item.rb",
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/nav_list/item/default/",
+ "parameters": [
+ {
+ "name": "selected_item_id",
+ "type": "Symbol",
+ "default": "`nil`",
+ "description": "The ID of the currently selected list item. Used internally."
+ },
+ {
+ "name": "selected_by_ids",
+ "type": "Array<Symbol>",
+ "default": "`[]`",
+ "description": "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."
+ },
+ {
+ "name": "expanded",
+ "type": "Boolean",
+ "default": "`false`",
+ "description": "Whether this item shows (expands) or hides (collapses) its list of sub items."
+ },
+ {
+ "name": "sub_item",
+ "type": "Boolean",
+ "default": "`false`",
+ "description": "Whether or not this item is nested under a parent item. Used internally."
},
{
"name": "system_arguments",
"type": "Hash",
"default": "N/A",