@oracle/oraclejet-core-pack 14.0.0

package/oj-c/Button.json

@@ -0,0 +1,536 @@
+[
+  {
+    "pack": "oj-c",
+    "id": "oj-c.Button",
+    "name": "Button",
+    "memberof": "oj-c",
+    "longname": "oj-c.Button",
+    "kind": "class",
+    "classdesc": "<h3 id=\"buttonOverview-section\">\n  JET Button\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#buttonOverview-section\"></a>\n</h3>\n\n<p>Description: Themeable, WAI-ARIA-compliant push buttons, with appropriate styles for hover, active, and disabled.\n\n<pre class=\"prettyprint\"><code>&lt;oj-c-button id=\"myButton\" label=\"My Button\">\n&lt;/oj-c-button>\n&lt;oj-c-button label=\"start icon\">\n  &lt;span slot='startIcon' class='myIconClass'>&lt;/span>\n&lt;/oj-c-button>\n &lt;oj-c-button label=\"end icon\">\n  &lt;span slot='endIcon' class='myIconClass'>&lt;/span>\n&lt;/oj-c-button>\n</code></pre>\n\n<h3 id=\"pushButtons-section\">\n  Push Buttons\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#pushButtons-section\"></a>\n</h3>\n\n<p>Push buttons are ordinary buttons that do not stay pressed in when clicked.\nPush buttons are created from <code class=\"prettyprint\">oj-c-button</code> elements.\n\n<h3 id=\"touch-section\">\n  Touch End User Information\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#touch-section\"></a>\n</h3>\n\n<table class=\"keyboard-table\">\n  <thead>\n    <tr>\n      <th>Target</th>\n      <th>Gesture</th>\n      <th>Action</th>\n    </tr>\n  </thead>\n  <tbody>\n    <tr>\n      <td>Push Button</td>\n      <td><kbd>Tap</kbd></td>\n      <td>Push the button.</td>\n    </tr>\n  </tbody>\n</table>\n\n<h3 id=\"keyboard-section\">\n  Keyboard End User Information\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#keyboard-section\"></a>\n</h3>\n\n<table class=\"keyboard-table\">\n  <thead>\n    <tr>\n      <th>Target</th>\n      <th>Key</th>\n      <th>Action</th>\n    </tr>\n  </thead>\n  <tbody>\n    <tr>\n      <td>Push Button</td>\n      <td><kbd>Enter</kbd> or <kbd>Space</kbd></td>\n      <td>Push the button.</td>\n    </tr>\n  </tbody>\n</table>\n\n<h3 id=\"a11y-section\">\n  Accessibility\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#a11y-section\"></a>\n</h3>\n\n<p>For accessibility, it is not required to set an aria label on a JET button as it uses the label text to generate an aria label.\nTherefore the label should be specified even if the button is <a href=\"#display\">icon-only (display=icons)</a>. However,\nyou can override the default behavior by setting <code class=\"prettyprint\">aria-label</code>.\nThe label can be hidden using the display attribute.\n\n<p>Disabled content: JET supports an accessible luminosity contrast ratio,\nas specified in <a href=\"http://www.w3.org/TR/WCAG20/#visual-audio-contrast-contrast\">WCAG 2.0 - Section 1.4.3 \"Contrast\"</a>,\nin the themes that are accessible.  (See the \"Theming\" chapter of the JET Developer Guide for more information on which\nthemes are accessible.)  Note that Section 1.4.3 says that text or images of text that are part of an inactive user\ninterface component have no contrast requirement.  Because disabled content may not meet the minimum contrast ratio\nrequired of enabled content, it cannot be used to convey meaningful information.<p>",
+    "scope": "static",
+    "tagWithoutBrackets": "oj-c-button",
+    "tagWithBrackets": "<oj-c-button>",
+    "domInterface": "CButtonElement",
+    "ojPageTitle": "&lt;oj-c-button>",
+    "ojcomponent": true,
+    "isvcomponent": true,
+    "camelCaseName": "Button",
+    "ojPageTitlePrefix": "Element: ",
+    "ojtsvcomponent": true,
+    "tstype": {
+      "target": "Type",
+      "value": "interface CButtonElement extends JetElement<ButtonElementSettableProperties>"
+    },
+    "ojsignature": [
+      {
+        "target": "Type",
+        "value": "interface CButtonElement extends JetElement<ButtonElementSettableProperties>"
+      }
+    ],
+    "since": "13.0.0",
+    "meta": {
+      "filename": "button.tsx",
+      "path": "/home/jenkins/uitech/workspace/OJET_Code_14.0.0/packages/oraclejet-core-pack/web/components/oj-c/button"
+    },
+    "ojmodule": "button"
+  },
+  {
+    "memberof": "oj-c.Button",
+    "id": "oj-c.Button#label",
+    "name": "label",
+    "kind": "member",
+    "longname": "oj-c.Button#label",
+    "optional": false,
+    "scope": "instance",
+    "description": "Text to show in the button.",
+    "meta": {
+      "filename": "button.tsx",
+      "path": "/home/jenkins/uitech/workspace/OJET_Code_14.0.0/packages/oraclejet-core-pack/web/components/oj-c/button"
+    },
+    "type": {
+      "names": [
+        "string"
+      ]
+    }
+  },
+  {
+    "memberof": "oj-c.Button",
+    "id": "oj-c.Button#disabled",
+    "name": "disabled",
+    "kind": "member",
+    "longname": "oj-c.Button#disabled",
+    "optional": true,
+    "scope": "instance",
+    "description": "Specifies that the button element should be disabled.",
+    "meta": {
+      "filename": "button.tsx",
+      "path": "/home/jenkins/uitech/workspace/OJET_Code_14.0.0/packages/oraclejet-core-pack/web/components/oj-c/button"
+    },
+    "defaultvalue": false,
+    "type": {
+      "names": [
+        "boolean"
+      ]
+    }
+  },
+  {
+    "memberof": "oj-c.Button",
+    "id": "oj-c.Button#width",
+    "name": "width",
+    "kind": "member",
+    "longname": "oj-c.Button#width",
+    "optional": true,
+    "scope": "instance",
+    "description": "Specifies that the button style width",
+    "meta": {
+      "filename": "button.tsx",
+      "path": "/home/jenkins/uitech/workspace/OJET_Code_14.0.0/packages/oraclejet-core-pack/web/components/oj-c/button"
+    },
+    "type": {
+      "names": [
+        "number|string"
+      ]
+    },
+    "tstype": [
+      {
+        "target": "Type",
+        "value": "Size",
+        "jsdocOverride": true
+      }
+    ]
+  },
+  {
+    "memberof": "oj-c.Button",
+    "id": "oj-c.Button#display",
+    "name": "display",
+    "kind": "member",
+    "longname": "oj-c.Button#display",
+    "optional": true,
+    "scope": "instance",
+    "description": "Display just the label, the icons, or all. Label is used as tooltip and should be set in all cases.",
+    "meta": {
+      "filename": "button.tsx",
+      "path": "/home/jenkins/uitech/workspace/OJET_Code_14.0.0/packages/oraclejet-core-pack/web/components/oj-c/button"
+    },
+    "ojvalues": [
+      {
+        "name": "all",
+        "description": "Display both the label and icons.",
+        "displayName": "All",
+        "type": {
+          "names": [
+            "string"
+          ]
+        }
+      },
+      {
+        "name": "icons",
+        "description": "Display only the icons.",
+        "displayName": "Icons",
+        "type": {
+          "names": [
+            "string"
+          ]
+        }
+      },
+      {
+        "name": "label",
+        "description": "Display only the text label.",
+        "displayName": "label",
+        "type": {
+          "names": [
+            "string"
+          ]
+        }
+      }
+    ],
+    "defaultvalue": "\"all\"",
+    "type": {
+      "names": [
+        "\"label\"",
+        "\"icons\"",
+        "\"all\""
+      ]
+    }
+  },
+  {
+    "memberof": "oj-c.Button",
+    "id": "oj-c.Button#size",
+    "name": "size",
+    "kind": "member",
+    "longname": "oj-c.Button#size",
+    "optional": true,
+    "scope": "instance",
+    "description": "Size of button",
+    "meta": {
+      "filename": "button.tsx",
+      "path": "/home/jenkins/uitech/workspace/OJET_Code_14.0.0/packages/oraclejet-core-pack/web/components/oj-c/button"
+    },
+    "ojvalues": [
+      {
+        "name": "sm",
+        "description": "Display a small button.",
+        "displayName": "Small",
+        "type": {
+          "names": [
+            "string"
+          ]
+        }
+      },
+      {
+        "name": "md",
+        "description": "Display a default size button.",
+        "displayName": "Medium",
+        "type": {
+          "names": [
+            "string"
+          ]
+        }
+      },
+      {
+        "name": "lg",
+        "description": "Display a large button.",
+        "displayName": "Large",
+        "type": {
+          "names": [
+            "string"
+          ]
+        }
+      }
+    ],
+    "defaultvalue": "\"md\"",
+    "type": {
+      "names": [
+        "\"sm\"",
+        "\"md\"",
+        "\"lg\""
+      ]
+    }
+  },
+  {
+    "memberof": "oj-c.Button",
+    "id": "oj-c.Button#edge",
+    "name": "edge",
+    "kind": "member",
+    "longname": "oj-c.Button#edge",
+    "optional": true,
+    "scope": "instance",
+    "description": "Specifies whether the button is attached to an edge. For example setting edge='bottom' can be used to attach a button to the bottom of a card. The button is then stretched to 100% width, and borders adjusted.",
+    "meta": {
+      "filename": "button.tsx",
+      "path": "/home/jenkins/uitech/workspace/OJET_Code_14.0.0/packages/oraclejet-core-pack/web/components/oj-c/button"
+    },
+    "ojvalues": [
+      {
+        "name": "none",
+        "description": "Display a default standalone button.",
+        "displayName": "Small",
+        "type": {
+          "names": [
+            "string"
+          ]
+        }
+      },
+      {
+        "name": "bottom",
+        "description": "Stretch the button to 100% width and adjust borders for usage at bottom of container.",
+        "displayName": "bottom",
+        "type": {
+          "names": [
+            "string"
+          ]
+        }
+      }
+    ],
+    "defaultvalue": "\"none\"",
+    "type": {
+      "names": [
+        "\"none\"",
+        "\"bottom\""
+      ]
+    }
+  },
+  {
+    "memberof": "oj-c.Button",
+    "id": "oj-c.Button#chroming",
+    "name": "chroming",
+    "kind": "member",
+    "longname": "oj-c.Button#chroming",
+    "optional": true,
+    "scope": "instance",
+    "description": "Indicates in what states the button has variants in background and border.",
+    "meta": {
+      "filename": "button.tsx",
+      "path": "/home/jenkins/uitech/workspace/OJET_Code_14.0.0/packages/oraclejet-core-pack/web/components/oj-c/button"
+    },
+    "ojvalues": [
+      {
+        "name": "borderless",
+        "description": "Borderless buttons are the least prominent variation. Borderless buttons are useful for supplemental actions that require minimal emphasis.",
+        "displayName": "Borderless",
+        "type": {
+          "names": [
+            "string"
+          ]
+        }
+      },
+      {
+        "name": "outlined",
+        "description": "Outlined buttons are salient, but lighter weight than solid buttons. Outlined buttons are useful for secondary actions.",
+        "displayName": "Outlined",
+        "type": {
+          "names": [
+            "string"
+          ]
+        }
+      },
+      {
+        "name": "solid",
+        "description": "Solid buttons stand out, and direct the user's attention to the most important actions in the UI.",
+        "displayName": "Solid",
+        "type": {
+          "names": [
+            "string"
+          ]
+        }
+      },
+      {
+        "name": "callToAction",
+        "description": "A Call To Action (CTA) button guides the user to take or complete the action that is the main goal of the page or page section. There should only be one CTA button on a page at any given time.",
+        "displayName": "Call To Action",
+        "type": {
+          "names": [
+            "string"
+          ]
+        }
+      },
+      {
+        "name": "danger",
+        "description": "A Danger button alerts the user to a dangerous situation.",
+        "displayName": "Danger",
+        "type": {
+          "names": [
+            "string"
+          ]
+        }
+      }
+    ],
+    "defaultvalue": "\"outlined\"",
+    "type": {
+      "names": [
+        "\"borderless\"",
+        "\"outlined\"",
+        "\"solid\"",
+        "\"callToAction\"",
+        "\"danger\""
+      ]
+    }
+  },
+  {
+    "memberof": "oj-c.Button",
+    "id": "oj-c.Button#blur",
+    "name": "blur",
+    "kind": "function",
+    "longname": "oj-c.Button#blur",
+    "description": "blurs the button",
+    "ojhidden": true,
+    "meta": {
+      "filename": "button.tsx",
+      "path": "/home/jenkins/uitech/workspace/OJET_Code_14.0.0/packages/oraclejet-core-pack/web/components/oj-c/button"
+    },
+    "scope": "instance",
+    "returns": [
+      {
+        "type": {
+          "names": [
+            "any"
+          ]
+        }
+      }
+    ]
+  },
+  {
+    "memberof": "oj-c.Button",
+    "id": "oj-c.Button#focus",
+    "name": "focus",
+    "kind": "function",
+    "longname": "oj-c.Button#focus",
+    "description": "focuses the button",
+    "ojhidden": true,
+    "meta": {
+      "filename": "button.tsx",
+      "path": "/home/jenkins/uitech/workspace/OJET_Code_14.0.0/packages/oraclejet-core-pack/web/components/oj-c/button"
+    },
+    "scope": "instance",
+    "returns": [
+      {
+        "type": {
+          "names": [
+            "any"
+          ]
+        }
+      }
+    ]
+  },
+  {
+    "memberof": "oj-c.Button",
+    "id": "oj-c.Button#setProperty",
+    "name": "setProperty",
+    "kind": "function",
+    "longname": "oj-c.Button#setProperty",
+    "description": "Sets a property or a single subproperty for complex properties and notifies the component of the change, triggering a corresponding event.",
+    "meta": {
+      "filename": "button.tsx",
+      "path": "/home/jenkins/uitech/workspace/OJET_Code_14.0.0/packages/oraclejet-core-pack/web/components/oj-c/button"
+    },
+    "scope": "instance",
+    "params": [
+      {
+        "name": "property",
+        "description": "The property name to set. Supports dot notation for subproperty access.",
+        "type": "string"
+      },
+      {
+        "name": "value",
+        "description": "The new value to set the property to.",
+        "type": "any"
+      }
+    ],
+    "returns": [
+      {
+        "type": {
+          "names": [
+            "void"
+          ]
+        }
+      }
+    ]
+  },
+  {
+    "memberof": "oj-c.Button",
+    "id": "oj-c.Button#getProperty",
+    "name": "getProperty",
+    "kind": "function",
+    "longname": "oj-c.Button#getProperty",
+    "description": "Retrieves the value of a property or a subproperty.",
+    "meta": {
+      "filename": "button.tsx",
+      "path": "/home/jenkins/uitech/workspace/OJET_Code_14.0.0/packages/oraclejet-core-pack/web/components/oj-c/button"
+    },
+    "scope": "instance",
+    "params": [
+      {
+        "name": "property",
+        "description": "The property name to get. Supports dot notation for subproperty access.",
+        "type": "string"
+      }
+    ],
+    "returns": [
+      {
+        "type": {
+          "names": [
+            "any"
+          ]
+        }
+      }
+    ]
+  },
+  {
+    "memberof": "oj-c.Button",
+    "id": "oj-c.Button#setProperties",
+    "name": "setProperties",
+    "kind": "function",
+    "longname": "oj-c.Button#setProperties",
+    "description": "Performs a batch set of properties.",
+    "meta": {
+      "filename": "button.tsx",
+      "path": "/home/jenkins/uitech/workspace/OJET_Code_14.0.0/packages/oraclejet-core-pack/web/components/oj-c/button"
+    },
+    "scope": "instance",
+    "params": [
+      {
+        "name": "properties",
+        "description": "An object containing the property and value pairs to set.",
+        "type": "object"
+      }
+    ],
+    "returns": [
+      {
+        "type": {
+          "names": [
+            "void"
+          ]
+        }
+      }
+    ]
+  },
+  {
+    "memberof": "oj-c.Button",
+    "id": "oj-c.Button#event:ojAction",
+    "name": "ojAction",
+    "kind": "event",
+    "longname": "oj-c.Button#event:ojAction",
+    "description": "Triggered when a button is clicked, whether by keyboard, mouse, or touch events. To meet accessibility requirements, the only supported way to react to the click of a button is to listen for this event.",
+    "meta": {
+      "filename": "button.tsx",
+      "path": "/home/jenkins/uitech/workspace/OJET_Code_14.0.0/packages/oraclejet-core-pack/web/components/oj-c/button"
+    },
+    "scope": "instance"
+  },
+  {
+    "memberof": "oj-c.Button",
+    "id": "oj-c.Button#startIcon",
+    "name": "startIcon",
+    "kind": "member",
+    "longname": "oj-c.Button#startIcon",
+    "description": "The startIcon slot is the button's start icon. The oj-c-button element accepts DOM nodes as children with the startIcon slot.",
+    "meta": {
+      "filename": "button.tsx",
+      "path": "/home/jenkins/uitech/workspace/OJET_Code_14.0.0/packages/oraclejet-core-pack/web/components/oj-c/button"
+    },
+    "scope": "instance",
+    "ojchild": false,
+    "ojslot": true
+  },
+  {
+    "memberof": "oj-c.Button",
+    "id": "oj-c.Button#endIcon",
+    "name": "endIcon",
+    "kind": "member",
+    "longname": "oj-c.Button#endIcon",
+    "description": "The endIcon slot is the button's end icon. The oj-c-button element accepts DOM nodes as children with the endIcon slot.",
+    "meta": {
+      "filename": "button.tsx",
+      "path": "/home/jenkins/uitech/workspace/OJET_Code_14.0.0/packages/oraclejet-core-pack/web/components/oj-c/button"
+    },
+    "scope": "instance",
+    "ojchild": false,
+    "ojslot": true
+  },
+  {
+    "id": "oj-c.Button.touchDoc",
+    "name": "touchDoc",
+    "kind": "member",
+    "longname": "oj-c.Button.touchDoc",
+    "description": "<table class=\"keyboard-table\">\n  <thead>\n    <tr>\n      <th>Target</th>\n      <th>Gesture</th>\n      <th>Action</th>\n    </tr>\n  </thead>\n  <tbody>\n    <tr>\n      <td>Push Button</td>\n      <td><kbd>Tap</kbd></td>\n      <td>Push the button.</td>\n    </tr>\n  </tbody>\n</table>",
+    "memberof": "oj-c.Button",
+    "meta": {
+      "filename": "button.tsx",
+      "path": "/home/jenkins/uitech/workspace/OJET_Code_14.0.0/packages/oraclejet-core-pack/web/components/oj-c/button"
+    },
+    "ojfragment": true
+  },
+  {
+    "id": "oj-c.Button.keyboardDoc",
+    "name": "keyboardDoc",
+    "kind": "member",
+    "longname": "oj-c.Button.keyboardDoc",
+    "description": "<table class=\"keyboard-table\">\n  <thead>\n    <tr>\n      <th>Target</th>\n      <th>Key</th>\n      <th>Action</th>\n    </tr>\n  </thead>\n  <tbody>\n    <tr>\n      <td>Push Button</td>\n      <td><kbd>Enter</kbd> or <kbd>Space</kbd></td>\n      <td>Push the button.</td>\n    </tr>\n  </tbody>\n</table>",
+    "memberof": "oj-c.Button",
+    "meta": {
+      "filename": "button.tsx",
+      "path": "/home/jenkins/uitech/workspace/OJET_Code_14.0.0/packages/oraclejet-core-pack/web/components/oj-c/button"
+    },
+    "ojfragment": true
+  }
+]