@nasa-terra/components 0.0.9 → 0.0.10

package/cdn/vscode.html-custom-data.json

@@ -2,6 +2,161 @@
   "$schema": "https://raw.githubusercontent.com/microsoft/vscode-html-languageservice/main/docs/customData.schema.json",
   "version": 1.1,
   "tags": [
+    {
+      "name": "terra-button",
+      "description": "Buttons represent actions that are available to the user.\n---\n\n\n### **Methods:**\n - **click()** - Simulates a click on the button.\n- **focus(options: _FocusOptions_)** - Sets focus on the button.\n- **blur()** - Removes focus from the button.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - _default_ - The button's label.\n- **prefix** - A presentational prefix icon or similar element.\n- **suffix** - A presentational suffix icon or similar element.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **prefix** - The container that wraps the prefix.\n- **label** - The button's label.\n- **suffix** - The container that wraps the suffix.\n- **caret** - The button's caret icon, an `<sl-icon>` element.\n- **spinner** - The spinner that shows when the button is in the loading state.",
+      "attributes": [
+        { "name": "title", "values": [] },
+        {
+          "name": "variant",
+          "description": "The button's theme variant.",
+          "values": [
+            { "name": "" },
+            { "name": "default" },
+            { "name": "primary" },
+            { "name": "success" },
+            { "name": "warning" },
+            { "name": "danger" },
+            { "name": "text" },
+            { "name": "pagelink" }
+          ]
+        },
+        {
+          "name": "size",
+          "description": "The button's size.",
+          "values": [
+            { "name": "small" },
+            { "name": "medium" },
+            { "name": "large" }
+          ]
+        },
+        {
+          "name": "caret",
+          "description": "Draws the button with a caret. Used to indicate that the button triggers a dropdown menu or similar behavior.",
+          "values": []
+        },
+        {
+          "name": "shape",
+          "description": "The button's shape. Used to control the radius edge shape when button is not in a terra-button-group.",
+          "values": [
+            { "name": "square" },
+            { "name": "square-left" },
+            { "name": "square-right" }
+          ]
+        },
+        {
+          "name": "disabled",
+          "description": "Disables the button.",
+          "values": []
+        },
+        {
+          "name": "loading",
+          "description": "Draws the button in a loading state.",
+          "values": []
+        },
+        {
+          "name": "outline",
+          "description": "Draws an outlined button.",
+          "values": []
+        },
+        {
+          "name": "circle",
+          "description": "Draws a circular icon button. When this attribute is present, the button expects a single `<terra-icon>` in the\ndefault slot.",
+          "values": []
+        },
+        {
+          "name": "type",
+          "description": "The type of button. Note that the default value is `button` instead of `submit`, which is opposite of how native\n`<button>` elements behave. When the type is `submit`, the button will submit the surrounding form.",
+          "values": [
+            { "name": "button" },
+            { "name": "submit" },
+            { "name": "reset" }
+          ]
+        },
+        {
+          "name": "name",
+          "description": "The name of the button, submitted as a name/value pair with form data, but only when this button is the submitter.\nThis attribute is ignored when `href` is present.",
+          "values": []
+        },
+        {
+          "name": "value",
+          "description": "The value of the button, submitted as a pair with the button's name as part of the form data, but only when this\nbutton is the submitter. This attribute is ignored when `href` is present.",
+          "values": []
+        },
+        {
+          "name": "href",
+          "description": "When set, the underlying button will be rendered as an `<a>` with this `href` instead of a `<button>`.",
+          "values": []
+        },
+        {
+          "name": "target",
+          "description": "Tells the browser where to open the link. Only used when `href` is present.",
+          "values": [
+            { "name": "_blank" },
+            { "name": "_parent" },
+            { "name": "_self" },
+            { "name": "_top" }
+          ]
+        },
+        {
+          "name": "rel",
+          "description": "When using `href`, this attribute will map to the underlying link's `rel` attribute. Unlike regular links, the\ndefault is `noreferrer noopener` to prevent security exploits. However, if you're using `target` to point to a\nspecific tab/window, this will prevent that from working correctly. You can remove or change the default value by\nsetting the attribute to an empty string or a value of your choice, respectively.",
+          "values": []
+        },
+        {
+          "name": "download",
+          "description": "Tells the browser to download the linked file as this filename. Only used when `href` is present.",
+          "values": []
+        },
+        {
+          "name": "form",
+          "description": "The \"form owner\" to associate the button with. If omitted, the closest containing form will be used instead. The\nvalue of this attribute must be an id of a form in the same document or shadow root as the button.",
+          "values": []
+        },
+        {
+          "name": "formaction",
+          "description": "Used to override the form owner's `action` attribute.",
+          "values": []
+        },
+        {
+          "name": "formenctype",
+          "description": "Used to override the form owner's `enctype` attribute.",
+          "values": [
+            { "name": "" },
+            { "name": "application/x-www-form-urlencoded" },
+            { "name": "multipart/form-data" },
+            { "name": "text/plain" }
+          ]
+        },
+        {
+          "name": "formmethod",
+          "description": "Used to override the form owner's `method` attribute.",
+          "values": [{ "name": "post" }, { "name": "get" }]
+        },
+        {
+          "name": "formnovalidate",
+          "description": "Used to override the form owner's `novalidate` attribute.",
+          "values": []
+        },
+        {
+          "name": "formtarget",
+          "description": "Used to override the form owner's `target` attribute.",
+          "values": [
+            { "name": "" },
+            { "name": "_self" },
+            { "name": "_blank" },
+            { "name": "_parent" },
+            { "name": "_top" }
+          ]
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://disc.gsfc.nasa.gov/components/button"
+        }
+      ]
+    },
     {
       "name": "terra-browse-variables",
       "description": "Browse through the Giovanni catalog.\n---\n\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -225,161 +380,6 @@
         }
       ]
     },
-    {
-      "name": "terra-button",
-      "description": "Buttons represent actions that are available to the user.\n---\n\n\n### **Methods:**\n - **click()** - Simulates a click on the button.\n- **focus(options: _FocusOptions_)** - Sets focus on the button.\n- **blur()** - Removes focus from the button.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - _default_ - The button's label.\n- **prefix** - A presentational prefix icon or similar element.\n- **suffix** - A presentational suffix icon or similar element.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **prefix** - The container that wraps the prefix.\n- **label** - The button's label.\n- **suffix** - The container that wraps the suffix.\n- **caret** - The button's caret icon, an `<sl-icon>` element.\n- **spinner** - The spinner that shows when the button is in the loading state.",
-      "attributes": [
-        { "name": "title", "values": [] },
-        {
-          "name": "variant",
-          "description": "The button's theme variant.",
-          "values": [
-            { "name": "" },
-            { "name": "default" },
-            { "name": "primary" },
-            { "name": "success" },
-            { "name": "warning" },
-            { "name": "danger" },
-            { "name": "text" },
-            { "name": "pagelink" }
-          ]
-        },
-        {
-          "name": "size",
-          "description": "The button's size.",
-          "values": [
-            { "name": "small" },
-            { "name": "medium" },
-            { "name": "large" }
-          ]
-        },
-        {
-          "name": "caret",
-          "description": "Draws the button with a caret. Used to indicate that the button triggers a dropdown menu or similar behavior.",
-          "values": []
-        },
-        {
-          "name": "shape",
-          "description": "The button's shape. Used to control the radius edge shape when button is not in a terra-button-group.",
-          "values": [
-            { "name": "square" },
-            { "name": "square-left" },
-            { "name": "square-right" }
-          ]
-        },
-        {
-          "name": "disabled",
-          "description": "Disables the button.",
-          "values": []
-        },
-        {
-          "name": "loading",
-          "description": "Draws the button in a loading state.",
-          "values": []
-        },
-        {
-          "name": "outline",
-          "description": "Draws an outlined button.",
-          "values": []
-        },
-        {
-          "name": "circle",
-          "description": "Draws a circular icon button. When this attribute is present, the button expects a single `<terra-icon>` in the\ndefault slot.",
-          "values": []
-        },
-        {
-          "name": "type",
-          "description": "The type of button. Note that the default value is `button` instead of `submit`, which is opposite of how native\n`<button>` elements behave. When the type is `submit`, the button will submit the surrounding form.",
-          "values": [
-            { "name": "button" },
-            { "name": "submit" },
-            { "name": "reset" }
-          ]
-        },
-        {
-          "name": "name",
-          "description": "The name of the button, submitted as a name/value pair with form data, but only when this button is the submitter.\nThis attribute is ignored when `href` is present.",
-          "values": []
-        },
-        {
-          "name": "value",
-          "description": "The value of the button, submitted as a pair with the button's name as part of the form data, but only when this\nbutton is the submitter. This attribute is ignored when `href` is present.",
-          "values": []
-        },
-        {
-          "name": "href",
-          "description": "When set, the underlying button will be rendered as an `<a>` with this `href` instead of a `<button>`.",
-          "values": []
-        },
-        {
-          "name": "target",
-          "description": "Tells the browser where to open the link. Only used when `href` is present.",
-          "values": [
-            { "name": "_blank" },
-            { "name": "_parent" },
-            { "name": "_self" },
-            { "name": "_top" }
-          ]
-        },
-        {
-          "name": "rel",
-          "description": "When using `href`, this attribute will map to the underlying link's `rel` attribute. Unlike regular links, the\ndefault is `noreferrer noopener` to prevent security exploits. However, if you're using `target` to point to a\nspecific tab/window, this will prevent that from working correctly. You can remove or change the default value by\nsetting the attribute to an empty string or a value of your choice, respectively.",
-          "values": []
-        },
-        {
-          "name": "download",
-          "description": "Tells the browser to download the linked file as this filename. Only used when `href` is present.",
-          "values": []
-        },
-        {
-          "name": "form",
-          "description": "The \"form owner\" to associate the button with. If omitted, the closest containing form will be used instead. The\nvalue of this attribute must be an id of a form in the same document or shadow root as the button.",
-          "values": []
-        },
-        {
-          "name": "formaction",
-          "description": "Used to override the form owner's `action` attribute.",
-          "values": []
-        },
-        {
-          "name": "formenctype",
-          "description": "Used to override the form owner's `enctype` attribute.",
-          "values": [
-            { "name": "" },
-            { "name": "application/x-www-form-urlencoded" },
-            { "name": "multipart/form-data" },
-            { "name": "text/plain" }
-          ]
-        },
-        {
-          "name": "formmethod",
-          "description": "Used to override the form owner's `method` attribute.",
-          "values": [{ "name": "post" }, { "name": "get" }]
-        },
-        {
-          "name": "formnovalidate",
-          "description": "Used to override the form owner's `novalidate` attribute.",
-          "values": []
-        },
-        {
-          "name": "formtarget",
-          "description": "Used to override the form owner's `target` attribute.",
-          "values": [
-            { "name": "" },
-            { "name": "_self" },
-            { "name": "_blank" },
-            { "name": "_parent" },
-            { "name": "_top" }
-          ]
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://disc.gsfc.nasa.gov/components/button"
-        }
-      ]
-    },
     {
       "name": "terra-map",
       "description": "A map component for visualizing and selecting coordinates.\n---\n",
@@ -492,39 +492,6 @@
         }
       ]
     },
-    {
-      "name": "terra-variable-combobox",
-      "description": "Fuzzy-search for dataset variables in combobox with list autocomplete.\n---\n\n\n### **Events:**\n - **terra-combobox-change** - Emitted when an option is selected.\n\n### **CSS Properties:**\n - **--host-height** - The height of the host element. _(default: undefined)_\n- **--help-height** - The height of the search help element. _(default: undefined)_\n- **--label-height** - The height of the input's label element. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - A `search` element, the component's base.\n- **combobox** - An `input` element used for searching.\n- **button** - A `button` used for toggling the listbox's visibility.\n- **listbox** - A `ul` that holds the clickable options.",
-      "attributes": [
-        {
-          "name": "label",
-          "description": "Label the combobox with this.",
-          "values": []
-        },
-        {
-          "name": "placeholder",
-          "description": "Set a placeholder for the combobox with this.\nDefaults to the label's value.",
-          "values": []
-        },
-        {
-          "name": "hide-help",
-          "description": "Hide the combobox's help text.\nWhen hidden, not rendered at all.",
-          "values": []
-        },
-        {
-          "name": "hide-label",
-          "description": "Hide the combobox's label text.\nWhen hidden, still presents to screen readers.",
-          "values": []
-        },
-        { "name": "value", "values": [] }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://disc.gsfc.nasa.gov/components/variable-combobox"
-        }
-      ]
-    },
     {
       "name": "terra-time-series",
       "description": "A component for visualizing time series data using the GES DISC Giovanni API.\n---\n",
@@ -577,6 +544,39 @@
           "url": "https://disc.gsfc.nasa.gov/components/time-series"
         }
       ]
+    },
+    {
+      "name": "terra-variable-combobox",
+      "description": "Fuzzy-search for dataset variables in combobox with list autocomplete.\n---\n\n\n### **Events:**\n - **terra-combobox-change** - Emitted when an option is selected.\n\n### **CSS Properties:**\n - **--host-height** - The height of the host element. _(default: undefined)_\n- **--help-height** - The height of the search help element. _(default: undefined)_\n- **--label-height** - The height of the input's label element. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - A `search` element, the component's base.\n- **combobox** - An `input` element used for searching.\n- **button** - A `button` used for toggling the listbox's visibility.\n- **listbox** - A `ul` that holds the clickable options.",
+      "attributes": [
+        {
+          "name": "label",
+          "description": "Label the combobox with this.",
+          "values": []
+        },
+        {
+          "name": "placeholder",
+          "description": "Set a placeholder for the combobox with this.\nDefaults to the label's value.",
+          "values": []
+        },
+        {
+          "name": "hide-help",
+          "description": "Hide the combobox's help text.\nWhen hidden, not rendered at all.",
+          "values": []
+        },
+        {
+          "name": "hide-label",
+          "description": "Hide the combobox's label text.\nWhen hidden, still presents to screen readers.",
+          "values": []
+        },
+        { "name": "value", "values": [] }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://disc.gsfc.nasa.gov/components/variable-combobox"
+        }
+      ]
     }
   ]
 }