Skip to content

Add default to many component properties. #746

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
gspencergoog merged 2 commits into from
Mar 2, 2026
+77 −34
Merged

Add default to many component properties. #746

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
4757a27
Add `default` to many component properties.
jgindin Mar 2, 2026
f6044ec
Remove `min` as a required property since it now has a default.
jgindin Mar 2, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
58 changes: 42 additions & 16 deletions specification/v0_10/json/basic_catalog.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,8 @@
"variant": {
"type": "string",
"description": "A hint for the base text style.",
"enum": ["h1", "h2", "h3", "h4", "h5", "caption", "body"]
"enum": ["h1", "h2", "h3", "h4", "h5", "caption", "body"],
"default": "body"
}
},
"required": ["component", "text"]
Expand All @@ -45,7 +46,8 @@
"fit": {
"type": "string",
"description": "Specifies how the image should be resized to fit its container. This corresponds to the CSS 'object-fit' property.",
"enum": ["contain", "cover", "fill", "none", "scaleDown"]
"enum": ["contain", "cover", "fill", "none", "scaleDown"],
"default": "fill"
},
"variant": {
"type": "string",
Expand All @@ -57,7 +59,8 @@
"mediumFeature",
"largeFeature",
"header"
]
],
"default": "mediumFeature"
}
},
"required": ["component", "url"]
Expand Down Expand Up @@ -224,12 +227,14 @@
"spaceEvenly",
"start",
"stretch"
]
],
"default": "start"
},
"align": {
"type": "string",
"description": "Defines the alignment of children along the cross axis (vertically). This is similar to the CSS 'align-items' property, but uses camelCase values (e.g., 'start').",
"enum": ["start", "center", "end", "stretch"]
"enum": ["start", "center", "end", "stretch"],
"default": "stretch"
}
},
"required": ["component", "children"]
Expand Down Expand Up @@ -262,12 +267,14 @@
"spaceAround",
"spaceEvenly",
"stretch"
]
],
"default": "start"
},
"align": {
"type": "string",
"description": "Defines the alignment of children along the cross axis (horizontally). This is similar to the CSS 'align-items' property.",
"enum": ["center", "end", "start", "stretch"]
"enum": ["center", "end", "start", "stretch"],
"default": "stretch"
}
},
"required": ["component", "children"]
Expand All @@ -291,12 +298,14 @@
"direction": {
"type": "string",
"description": "The direction in which the list items are laid out.",
"enum": ["vertical", "horizontal"]
"enum": ["vertical", "horizontal"],
"default": "vertical"
},
"align": {
"type": "string",
"description": "Defines the alignment of children along the cross axis.",
"enum": ["start", "center", "end", "stretch"]
"enum": ["start", "center", "end", "stretch"],
"default": "stretch"
}
},
"required": ["component", "children"]
Expand Down Expand Up @@ -418,7 +427,8 @@
"variant": {
"type": "string",
"description": "A hint for the button style. If omitted, a default button style is used. 'primary' indicates this is the main call-to-action button. 'borderless' means the button has no visual border or background, making its child content appear like a clickable link.",
"enum": ["primary", "borderless"]
"enum": ["default", "primary", "borderless"],
"default": "default"
},
"action": {
"$ref": "common_types.json#/$defs/Action"
Expand Down Expand Up @@ -450,7 +460,8 @@
"variant": {
"type": "string",
"description": "The type of input field to display.",
"enum": ["longText", "number", "shortText", "obscured"]
"enum": ["longText", "number", "shortText", "obscured"],
"default": "shortText"
}
},
"required": ["component", "label"]
Expand Down Expand Up @@ -500,7 +511,8 @@
"variant": {
"type": "string",
"description": "A hint for how the choice picker should be displayed and behave.",
"enum": ["multipleSelection", "mutuallyExclusive"]
"enum": ["multipleSelection", "mutuallyExclusive"],
"default": "mutuallyExclusive"
},
"options": {
"type": "array",
Expand All @@ -524,6 +536,17 @@
"value": {
"$ref": "common_types.json#/$defs/DynamicStringList",
"description": "The list of currently selected values. This should be bound to a string array in the data model."
},
"displayStyle": {
"type": "string",
"description": "The display style of the component.",
"enum": ["checkbox", "chips"],
"default": "checkbox"
},
"filterable": {
"type": "boolean",
"description": "If true, displays a search input to filter the options.",
"default": false
}
},
"required": ["component", "options", "value"]
Expand All @@ -547,7 +570,8 @@
},
"min": {
"type": "number",
"description": "The minimum value of the slider."
"description": "The minimum value of the slider.",
"default": 0
},
"max": {
"type": "number",
Expand All @@ -558,7 +582,7 @@
"description": "The current value of the slider."
}
},
"required": ["component", "value", "min", "max"]
"required": ["component", "value", "max"]
}
],
"unevaluatedProperties": false
Expand All @@ -579,11 +603,13 @@
},
"enableDate": {
"type": "boolean",
"description": "If true, allows the user to select a date."
"description": "If true, allows the user to select a date.",
"default": false
},
"enableTime": {
"type": "boolean",
"description": "If true, allows the user to select a time."
"description": "If true, allows the user to select a time.",
"default": false
},
"min": {
"allOf": [
Expand Down
53 changes: 35 additions & 18 deletions specification/v0_9/json/basic_catalog.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,8 @@
"variant": {
"type": "string",
"description": "A hint for the base text style.",
"enum": ["h1", "h2", "h3", "h4", "h5", "caption", "body"]
"enum": ["h1", "h2", "h3", "h4", "h5", "caption", "body"],
"default": "body"
}
},
"required": ["component", "text"]
Expand Down Expand Up @@ -57,7 +58,8 @@
"fit": {
"type": "string",
"description": "Specifies how the image should be resized to fit its container. This corresponds to the CSS 'object-fit' property.",
"enum": ["contain", "cover", "fill", "none", "scaleDown"]
"enum": ["contain", "cover", "fill", "none", "scaleDown"],
"default": "fill"
},
"variant": {
"type": "string",
Expand All @@ -69,7 +71,8 @@
"mediumFeature",
"largeFeature",
"header"
]
],
"default": "mediumFeature"
}
},
"required": ["component", "url"]
Expand Down Expand Up @@ -262,12 +265,14 @@
"spaceEvenly",
"start",
"stretch"
]
],
"default": "start"
},
"align": {
"type": "string",
"description": "Defines the alignment of children along the cross axis (vertically). This is similar to the CSS 'align-items' property, but uses camelCase values (e.g., 'start').",
"enum": ["start", "center", "end", "stretch"]
"enum": ["start", "center", "end", "stretch"],
"default": "stretch"
}
},
"required": ["component", "children"]
Expand Down Expand Up @@ -306,12 +311,14 @@
"spaceAround",
"spaceEvenly",
"stretch"
]
],
"default": "start"
},
"align": {
"type": "string",
"description": "Defines the alignment of children along the cross axis (horizontally). This is similar to the CSS 'align-items' property.",
"enum": ["center", "end", "start", "stretch"]
"enum": ["center", "end", "start", "stretch"],
"default": "stretch"
}
},
"required": ["component", "children"]
Expand Down Expand Up @@ -341,12 +348,14 @@
"direction": {
"type": "string",
"description": "The direction in which the list items are laid out.",
"enum": ["vertical", "horizontal"]
"enum": ["vertical", "horizontal"],
"default": "vertical"
},
"align": {
"type": "string",
"description": "Defines the alignment of children along the cross axis.",
"enum": ["start", "center", "end", "stretch"]
"enum": ["start", "center", "end", "stretch"],
"default": "stretch"
}
},
"required": ["component", "children"]
Expand Down Expand Up @@ -500,7 +509,8 @@
"variant": {
"type": "string",
"description": "A hint for the button style. If omitted, a default button style is used. 'primary' indicates this is the main call-to-action button. 'borderless' means the button has no visual border or background, making its child content appear like a clickable link.",
"enum": ["primary", "borderless"]
"enum": ["default", "primary", "borderless"],
"default": "default"
},
"action": {
"$ref": "common_types.json#/$defs/Action"
Expand Down Expand Up @@ -540,7 +550,8 @@
"variant": {
"type": "string",
"description": "The type of input field to display.",
"enum": ["longText", "number", "shortText", "obscured"]
"enum": ["longText", "number", "shortText", "obscured"],
"default": "shortText"
},
"validationRegexp": {
"type": "string",
Expand Down Expand Up @@ -610,7 +621,8 @@
"variant": {
"type": "string",
"description": "A hint for how the choice picker should be displayed and behave.",
"enum": ["multipleSelection", "mutuallyExclusive"]
"enum": ["multipleSelection", "mutuallyExclusive"],
"default": "mutuallyExclusive"
},
"options": {
"type": "array",
Expand Down Expand Up @@ -638,11 +650,13 @@
"displayStyle": {
"type": "string",
"description": "The display style of the component.",
"enum": ["checkbox", "chips"]
"enum": ["checkbox", "chips"],
"default": "checkbox"
},
"filterable": {
"type": "boolean",
"description": "If true, displays a search input to filter the options."
"description": "If true, displays a search input to filter the options.",
"default": false
}
},
"required": ["component", "options", "value"]
Expand Down Expand Up @@ -674,7 +688,8 @@
},
"min": {
"type": "number",
"description": "The minimum value of the slider."
"description": "The minimum value of the slider.",
"default": 0
},
"max": {
"type": "number",
Expand All @@ -685,7 +700,7 @@
"description": "The current value of the slider."
}
},
"required": ["component", "value", "min", "max"]
"required": ["component", "value", "max"]
}
],
"unevaluatedProperties": false
Expand Down Expand Up @@ -714,11 +729,13 @@
},
"enableDate": {
"type": "boolean",
"description": "If true, allows the user to select a date."
"description": "If true, allows the user to select a date.",
"default": false
},
"enableTime": {
"type": "boolean",
"description": "If true, allows the user to select a time."
"description": "If true, allows the user to select a time.",
"default": false
},
"min": {
"allOf": [
Expand Down
Loading