@instructure/ui-link 8.23.0 → 8.23.1-snapshot.11

package/LICENSE.md

@@ -0,0 +1,27 @@
+---
+title: The MIT License (MIT)
+category: Getting Started
+order: 9
+---
+
+# The MIT License (MIT)
+
+Copyright (c) 2015 Instructure, Inc.
+
+**Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions.**
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/es/Link/__examples__/Link.examples.js

@@ -33,7 +33,9 @@ export default {
   },
   getComponentProps: () => {
     return {
-      href: 'http://instructure.design'
+      href: 'http://instructure.design',
+      forceButtonRole: false,
+      role: void 0
     };
   },
   getExampleProps: props => {

package/es/Link/index.js

@@ -1,7 +1,7 @@
 import _objectWithoutProperties from "@babel/runtime/helpers/esm/objectWithoutProperties";
 const _excluded = ["children", "onClick", "color", "href", "margin", "renderIcon", "iconPlacement", "isWithinText"];
 
-var _dec, _dec2, _class, _class2, _temp;
+var _dec, _dec2, _class, _class2;
 
 /*
  * The MIT License (MIT)
@@ -46,7 +46,7 @@ category: components
 ---
 @tsProps
 **/
-let Link = (_dec = withStyle(generateStyle, generateComponentTheme), _dec2 = testable(), _dec(_class = _dec2(_class = (_temp = _class2 = class Link extends Component {
+let Link = (_dec = withStyle(generateStyle, generateComponentTheme), _dec2 = testable(), _dec(_class = _dec2(_class = (_class2 = class Link extends Component {
   constructor() {
     super(...arguments);
     this.state = {
@@ -168,6 +168,19 @@ let Link = (_dec = withStyle(generateStyle, generateComponentTheme), _dec2 = tes
     return hasVisibleChildren(this.props.children);
   }
 
+  get role() {
+    const _this$props3 = this.props,
+          role = _this$props3.role,
+          forceButtonRole = _this$props3.forceButtonRole,
+          onClick = _this$props3.onClick;
+
+    if (forceButtonRole) {
+      return onClick && this.element !== 'button' ? 'button' : role;
+    }
+
+    return role;
+  }
+
   focus() {
     this.ref && this.ref.focus();
   }
@@ -185,22 +198,21 @@ let Link = (_dec = withStyle(generateStyle, generateComponentTheme), _dec2 = tes
   render() {
     var _this$props$styles2;
 
-    const _this$props3 = this.props,
-          children = _this$props3.children,
-          onClick = _this$props3.onClick,
-          color = _this$props3.color,
-          href = _this$props3.href,
-          margin = _this$props3.margin,
-          renderIcon = _this$props3.renderIcon,
-          iconPlacement = _this$props3.iconPlacement,
-          isWithinText = _this$props3.isWithinText,
-          props = _objectWithoutProperties(_this$props3, _excluded);
+    const _this$props4 = this.props,
+          children = _this$props4.children,
+          onClick = _this$props4.onClick,
+          color = _this$props4.color,
+          href = _this$props4.href,
+          margin = _this$props4.margin,
+          renderIcon = _this$props4.renderIcon,
+          iconPlacement = _this$props4.iconPlacement,
+          isWithinText = _this$props4.isWithinText,
+          props = _objectWithoutProperties(_this$props4, _excluded);
 
     const interaction = this.interaction;
     const isDisabled = interaction === 'disabled';
-    const role = onClick && this.element !== 'button' ? 'button' : void 0;
     const type = this.element === 'button' || this.element === 'input' ? 'button' : void 0;
-    const tabIndex = role === 'button' && !isDisabled ? 0 : void 0;
+    const tabIndex = this.role === 'button' && !isDisabled ? 0 : void 0;
     return jsx(View, Object.assign({}, passthroughProps(props), {
       elementRef: this.handleElementRef,
       as: this.element,
@@ -211,7 +223,7 @@ let Link = (_dec = withStyle(generateStyle, generateComponentTheme), _dec2 = tes
       onFocus: this.handleFocus,
       onBlur: this.handleBlur,
       "aria-disabled": isDisabled ? 'true' : void 0,
-      role: role,
+      role: this.role,
       type: type,
       tabIndex: tabIndex,
       css: (_this$props$styles2 = this.props.styles) === null || _this$props$styles2 === void 0 ? void 0 : _this$props$styles2.link
@@ -223,7 +235,8 @@ let Link = (_dec = withStyle(generateStyle, generateComponentTheme), _dec2 = tes
   interaction: void 0,
   color: 'link',
   iconPlacement: 'start',
-  isWithinText: true
-}, _temp)) || _class) || _class);
+  isWithinText: true,
+  forceButtonRole: true
+}, _class2)) || _class) || _class);
 export default Link;
 export { Link };

package/es/Link/props.js

@@ -29,6 +29,8 @@ const propTypes = {
   color: PropTypes.oneOf(['link', 'link-inverse']),
   elementRef: PropTypes.func,
   as: PropTypes.elementType,
+  role: PropTypes.string,
+  forceButtonRole: PropTypes.bool,
   interaction: PropTypes.oneOf(['enabled', 'disabled']),
   margin: ThemeablePropTypes.spacing,
   renderIcon: PropTypes.oneOfType([PropTypes.func, PropTypes.node]),
@@ -39,5 +41,5 @@ const propTypes = {
   onFocus: PropTypes.func,
   onBlur: PropTypes.func
 };
-const allowedProps = ['children', 'href', 'color', 'elementRef', 'as', 'interaction', 'margin', 'renderIcon', 'iconPlacement', 'display', 'isWithinText', 'onClick', 'onFocus', 'onBlur'];
+const allowedProps = ['children', 'href', 'color', 'elementRef', 'as', 'role', 'forceButtonRole', 'interaction', 'margin', 'renderIcon', 'iconPlacement', 'display', 'isWithinText', 'onClick', 'onFocus', 'onBlur'];
 export { propTypes, allowedProps };

package/lib/Link/__examples__/Link.examples.js

@@ -41,7 +41,9 @@ var _default = {
   },
   getComponentProps: () => {
     return {
-      href: 'http://instructure.design'
+      href: 'http://instructure.design',
+      forceButtonRole: false,
+      role: void 0
     };
   },
   getExampleProps: props => {

package/lib/Link/index.js

@@ -45,7 +45,7 @@ var _props = require("./props");
 
 const _excluded = ["children", "onClick", "color", "href", "margin", "renderIcon", "iconPlacement", "isWithinText"];
 
-var _dec, _dec2, _class, _class2, _temp;
+var _dec, _dec2, _class, _class2;
 
 /**
 ---
@@ -53,7 +53,7 @@ category: components
 ---
 @tsProps
 **/
-let Link = (_dec = (0, _emotion.withStyle)(_styles.default, _theme.default), _dec2 = (0, _testable.testable)(), _dec(_class = _dec2(_class = (_temp = _class2 = class Link extends _react.Component {
+let Link = (_dec = (0, _emotion.withStyle)(_styles.default, _theme.default), _dec2 = (0, _testable.testable)(), _dec(_class = _dec2(_class = (_class2 = class Link extends _react.Component {
   constructor() {
     super(...arguments);
     this.state = {
@@ -177,6 +177,19 @@ let Link = (_dec = (0, _emotion.withStyle)(_styles.default, _theme.default), _de
     return (0, _hasVisibleChildren.hasVisibleChildren)(this.props.children);
   }
 
+  get role() {
+    const _this$props3 = this.props,
+          role = _this$props3.role,
+          forceButtonRole = _this$props3.forceButtonRole,
+          onClick = _this$props3.onClick;
+
+    if (forceButtonRole) {
+      return onClick && this.element !== 'button' ? 'button' : role;
+    }
+
+    return role;
+  }
+
   focus() {
     this.ref && this.ref.focus();
   }
@@ -194,21 +207,20 @@ let Link = (_dec = (0, _emotion.withStyle)(_styles.default, _theme.default), _de
   render() {
     var _this$props$styles2;
 
-    const _this$props3 = this.props,
-          children = _this$props3.children,
-          onClick = _this$props3.onClick,
-          color = _this$props3.color,
-          href = _this$props3.href,
-          margin = _this$props3.margin,
-          renderIcon = _this$props3.renderIcon,
-          iconPlacement = _this$props3.iconPlacement,
-          isWithinText = _this$props3.isWithinText,
-          props = (0, _objectWithoutProperties2.default)(_this$props3, _excluded);
+    const _this$props4 = this.props,
+          children = _this$props4.children,
+          onClick = _this$props4.onClick,
+          color = _this$props4.color,
+          href = _this$props4.href,
+          margin = _this$props4.margin,
+          renderIcon = _this$props4.renderIcon,
+          iconPlacement = _this$props4.iconPlacement,
+          isWithinText = _this$props4.isWithinText,
+          props = (0, _objectWithoutProperties2.default)(_this$props4, _excluded);
     const interaction = this.interaction;
     const isDisabled = interaction === 'disabled';
-    const role = onClick && this.element !== 'button' ? 'button' : void 0;
     const type = this.element === 'button' || this.element === 'input' ? 'button' : void 0;
-    const tabIndex = role === 'button' && !isDisabled ? 0 : void 0;
+    const tabIndex = this.role === 'button' && !isDisabled ? 0 : void 0;
     return (0, _emotion.jsx)(_View.View, Object.assign({}, (0, _passthroughProps.passthroughProps)(props), {
       elementRef: this.handleElementRef,
       as: this.element,
@@ -219,7 +231,7 @@ let Link = (_dec = (0, _emotion.withStyle)(_styles.default, _theme.default), _de
       onFocus: this.handleFocus,
       onBlur: this.handleBlur,
       "aria-disabled": isDisabled ? 'true' : void 0,
-      role: role,
+      role: this.role,
       type: type,
       tabIndex: tabIndex,
       css: (_this$props$styles2 = this.props.styles) === null || _this$props$styles2 === void 0 ? void 0 : _this$props$styles2.link
@@ -231,8 +243,9 @@ let Link = (_dec = (0, _emotion.withStyle)(_styles.default, _theme.default), _de
   interaction: void 0,
   color: 'link',
   iconPlacement: 'start',
-  isWithinText: true
-}, _temp)) || _class) || _class);
+  isWithinText: true,
+  forceButtonRole: true
+}, _class2)) || _class) || _class);
 exports.Link = Link;
 var _default = Link;
 exports.default = _default;

package/lib/Link/props.js

@@ -40,6 +40,8 @@ const propTypes = {
   color: _propTypes.default.oneOf(['link', 'link-inverse']),
   elementRef: _propTypes.default.func,
   as: _propTypes.default.elementType,
+  role: _propTypes.default.string,
+  forceButtonRole: _propTypes.default.bool,
   interaction: _propTypes.default.oneOf(['enabled', 'disabled']),
   margin: _emotion.ThemeablePropTypes.spacing,
   renderIcon: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.node]),
@@ -51,5 +53,5 @@ const propTypes = {
   onBlur: _propTypes.default.func
 };
 exports.propTypes = propTypes;
-const allowedProps = ['children', 'href', 'color', 'elementRef', 'as', 'interaction', 'margin', 'renderIcon', 'iconPlacement', 'display', 'isWithinText', 'onClick', 'onFocus', 'onBlur'];
+const allowedProps = ['children', 'href', 'color', 'elementRef', 'as', 'role', 'forceButtonRole', 'interaction', 'margin', 'renderIcon', 'iconPlacement', 'display', 'isWithinText', 'onClick', 'onFocus', 'onBlur'];
 exports.allowedProps = allowedProps;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@instructure/ui-link",
-  "version": "8.23.0",
+  "version": "8.23.1-snapshot.11+5e829fae6",
   "description": "A component for creating links",
   "author": "Instructure, Inc. Engineering and Product Design",
   "module": "./es/index.js",
@@ -24,25 +24,25 @@
   "license": "MIT",
   "dependencies": {
     "@babel/runtime": "^7.13.10",
-    "@instructure/console": "8.23.0",
-    "@instructure/emotion": "8.23.0",
-    "@instructure/shared-types": "8.23.0",
-    "@instructure/ui-a11y-utils": "8.23.0",
-    "@instructure/ui-color-utils": "8.23.0",
-    "@instructure/ui-dom-utils": "8.23.0",
-    "@instructure/ui-icons": "8.23.0",
-    "@instructure/ui-prop-types": "8.23.0",
-    "@instructure/ui-react-utils": "8.23.0",
-    "@instructure/ui-testable": "8.23.0",
-    "@instructure/ui-view": "8.23.0",
+    "@instructure/console": "8.23.1-snapshot.11+5e829fae6",
+    "@instructure/emotion": "8.23.1-snapshot.11+5e829fae6",
+    "@instructure/shared-types": "8.23.1-snapshot.11+5e829fae6",
+    "@instructure/ui-a11y-utils": "8.23.1-snapshot.11+5e829fae6",
+    "@instructure/ui-color-utils": "8.23.1-snapshot.11+5e829fae6",
+    "@instructure/ui-dom-utils": "8.23.1-snapshot.11+5e829fae6",
+    "@instructure/ui-icons": "8.23.1-snapshot.11+5e829fae6",
+    "@instructure/ui-prop-types": "8.23.1-snapshot.11+5e829fae6",
+    "@instructure/ui-react-utils": "8.23.1-snapshot.11+5e829fae6",
+    "@instructure/ui-testable": "8.23.1-snapshot.11+5e829fae6",
+    "@instructure/ui-view": "8.23.1-snapshot.11+5e829fae6",
     "prop-types": "^15"
   },
   "devDependencies": {
-    "@instructure/ui-babel-preset": "8.23.0",
-    "@instructure/ui-test-locator": "8.23.0",
-    "@instructure/ui-test-queries": "8.23.0",
-    "@instructure/ui-test-utils": "8.23.0",
-    "@instructure/ui-themes": "8.23.0"
+    "@instructure/ui-babel-preset": "8.23.1-snapshot.11+5e829fae6",
+    "@instructure/ui-test-locator": "8.23.1-snapshot.11+5e829fae6",
+    "@instructure/ui-test-queries": "8.23.1-snapshot.11+5e829fae6",
+    "@instructure/ui-test-utils": "8.23.1-snapshot.11+5e829fae6",
+    "@instructure/ui-themes": "8.23.1-snapshot.11+5e829fae6"
   },
   "peerDependencies": {
     "react": ">=16.8 <=17"
@@ -50,5 +50,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "sideEffects": false
+  "sideEffects": false,
+  "gitHead": "5e829fae6b005f080497818df8b3fff19365aab3"
 }

package/src/Link/__examples__/Link.examples.ts

@@ -40,7 +40,9 @@ export default {
   },
   getComponentProps: () => {
     return {
-      href: 'http://instructure.design'
+      href: 'http://instructure.design',
+      forceButtonRole: false,
+      role: undefined
     }
   },
   getExampleProps: (props) => {

package/src/Link/index.tsx

@@ -65,7 +65,8 @@ class Link extends Component<LinkProps, LinkState> {
     interaction: undefined,
     color: 'link',
     iconPlacement: 'start',
-    isWithinText: true
+    isWithinText: true,
+    forceButtonRole: true
   } as const
 
   state = { hasFocus: false }
@@ -182,6 +183,16 @@ class Link extends Component<LinkProps, LinkState> {
     return hasVisibleChildren(this.props.children)
   }
 
+  get role() {
+    const { role, forceButtonRole, onClick } = this.props
+
+    if (forceButtonRole) {
+      return onClick && this.element !== 'button' ? 'button' : role
+    }
+
+    return role
+  }
+
   focus() {
     this.ref && (this.ref as HTMLElement).focus()
   }
@@ -211,15 +222,17 @@ class Link extends Component<LinkProps, LinkState> {
       isWithinText,
       ...props
     } = this.props
+
     const { interaction } = this
 
     const isDisabled = interaction === 'disabled'
-    const role = onClick && this.element !== 'button' ? 'button' : undefined
+
     const type =
       this.element === 'button' || this.element === 'input'
         ? 'button'
         : undefined
-    const tabIndex = role === 'button' && !isDisabled ? 0 : undefined
+
+    const tabIndex = this.role === 'button' && !isDisabled ? 0 : undefined
 
     return (
       <View
@@ -233,7 +246,7 @@ class Link extends Component<LinkProps, LinkState> {
         onFocus={this.handleFocus}
         onBlur={this.handleBlur}
         aria-disabled={isDisabled ? 'true' : undefined}
-        role={role}
+        role={this.role}
         type={type}
         tabIndex={tabIndex}
         css={this.props.styles?.link}

package/src/Link/props.ts

@@ -67,6 +67,17 @@ type LinkOwnProps = {
    */
   as?: AsElementType
 
+  /**
+   * The ARIA role of the element.
+   */
+  role?: string
+
+  /**
+   * If the Link has an onClick handler but is not a button element,
+   * force ARIA role to be "button".
+   */
+  forceButtonRole?: boolean
+
   /**
    * Determines if the link is enabled or disabled
    */
@@ -142,6 +153,8 @@ const propTypes: PropValidators<PropKeys> = {
   color: PropTypes.oneOf(['link', 'link-inverse']),
   elementRef: PropTypes.func,
   as: PropTypes.elementType,
+  role: PropTypes.string,
+  forceButtonRole: PropTypes.bool,
   interaction: PropTypes.oneOf(['enabled', 'disabled']),
   margin: ThemeablePropTypes.spacing,
   renderIcon: PropTypes.oneOfType([PropTypes.func, PropTypes.node]),
@@ -165,6 +178,8 @@ const allowedProps: AllowedPropKeys = [
   'color',
   'elementRef',
   'as',
+  'role',
+  'forceButtonRole',
   'interaction',
   'margin',
   'renderIcon',