@ionic/core 8.4.2-dev.11736797843.16cc5058 → 8.4.2-dev.11739377372.17be7c08

package/dist/collection/components/toast/toast.js

@@ -10,7 +10,7 @@ import { GESTURE, createDelegateController, createTriggerController, dismiss, ev
 import { sanitizeDOMString } from "../../utils/sanitization/index";
 import { createColorClasses, getClassMap } from "../../utils/theme";
 import { config } from "../../global/config";
-import { getIonMode } from "../../global/ionic-global";
+import { getIonMode, getIonTheme } from "../../global/ionic-global";
 import { iosEnterAnimation } from "./animations/ios.enter";
 import { iosLeaveAnimation } from "./animations/ios.leave";
 import { mdEnterAnimation } from "./animations/md.enter";
@@ -19,7 +19,8 @@ import { getAnimationPosition } from "./animations/utils";
 import { createSwipeToDismissGesture } from "./gestures/swipe-to-dismiss";
 // TODO(FW-2832): types
 /**
- * @virtualProp {"ios" | "md"} mode - The mode determines which platform styles to use.
+ * @virtualProp {"ios" | "md"} mode - The mode determines the platform behaviors of the component.
+ * @virtualProp {"ios" | "md" | "ionic"} theme - The theme determines the visual appearance of the component.
  *
  * @part button - Any button element that is displayed inside of the toast.
  * @part button cancel - Any button element with role "cancel" that is displayed inside of the toast.
@@ -35,54 +36,6 @@ export class Toast {
         this.triggerController = createTriggerController();
         this.customHTMLEnabled = config.get('innerHTMLTemplatesEnabled', ENABLE_HTML_CONTENT_DEFAULT);
         this.presented = false;
-        /**
-         * When `true`, content inside of .toast-content
-         * will have aria-hidden elements removed causing
-         * screen readers to announce the remaining content.
-         */
-        this.revealContentToScreenReader = false;
-        /** @internal */
-        this.hasController = false;
-        /**
-         * How many milliseconds to wait before hiding the toast. By default, it will show
-         * until `dismiss()` is called.
-         */
-        this.duration = config.getNumber('toastDuration', 0);
-        /**
-         * Defines how the message and buttons are laid out in the toast.
-         * 'baseline': The message and the buttons will appear on the same line.
-         * Message text may wrap within the message container.
-         * 'stacked': The buttons containers and message will stack on top
-         * of each other. Use this if you have long text in your buttons.
-         */
-        this.layout = 'baseline';
-        /**
-         * If `true`, the keyboard will be automatically dismissed when the overlay is presented.
-         */
-        this.keyboardClose = false;
-        /**
-         * The starting position of the toast on the screen. Can be tweaked further
-         * using the `positionAnchor` property.
-         */
-        this.position = 'bottom';
-        /**
-         * If `true`, the toast will be translucent.
-         * Only applies when the mode is `"ios"` and the device supports
-         * [`backdrop-filter`](https://developer.mozilla.org/en-US/docs/Web/CSS/backdrop-filter#Browser_compatibility).
-         */
-        this.translucent = false;
-        /**
-         * If `true`, the toast will animate.
-         */
-        this.animated = true;
-        /**
-         * If `true`, the toast will open. If `false`, the toast will close.
-         * Use this if you need finer grained control over presentation, otherwise
-         * just use the toastController or the `trigger` property.
-         * Note: `isOpen` will not automatically be set back to `false` when
-         * the toast dismisses. You will need to do that in your code.
-         */
-        this.isOpen = false;
         this.dispatchCancelHandler = (ev) => {
             const role = ev.detail.role;
             if (isCancel(role)) {
@@ -125,6 +78,30 @@ export class Toast {
             const { swipeGesture } = this;
             return swipeGesture === 'vertical';
         };
+        this.revealContentToScreenReader = false;
+        this.overlayIndex = undefined;
+        this.delegate = undefined;
+        this.hasController = false;
+        this.color = undefined;
+        this.enterAnimation = undefined;
+        this.leaveAnimation = undefined;
+        this.cssClass = undefined;
+        this.duration = config.getNumber('toastDuration', 0);
+        this.header = undefined;
+        this.layout = 'baseline';
+        this.message = undefined;
+        this.keyboardClose = false;
+        this.position = 'bottom';
+        this.positionAnchor = undefined;
+        this.shape = undefined;
+        this.buttons = undefined;
+        this.translucent = false;
+        this.animated = true;
+        this.icon = undefined;
+        this.htmlAttributes = undefined;
+        this.swipeGesture = undefined;
+        this.isOpen = false;
+        this.trigger = undefined;
     }
     swipeGestureChanged() {
         /**
@@ -203,11 +180,12 @@ export class Toast {
      * Present the toast overlay after it has been created.
      */
     async present() {
+        const mode = getIonMode(this);
         const unlock = await this.lockController.lock();
         await this.delegateController.attachViewToDom();
         const { el, position } = this;
         const anchor = this.getAnchorElement();
-        const animationPosition = getAnimationPosition(position, anchor, getIonMode(this), el);
+        const animationPosition = getAnimationPosition(position, anchor, mode, el);
         /**
          * Cache the calculated position of the toast, so we can re-use it
          * in the dismiss animation.
@@ -301,6 +279,17 @@ export class Toast {
             : [];
         return buttons;
     }
+    getShape() {
+        const { shape } = this;
+        // TODO(ROU-11300): Remove theme check when shapes are defined for all themes.
+        if (getIonTheme(this) !== 'ionic') {
+            return undefined;
+        }
+        if (shape === undefined) {
+            return 'round';
+        }
+        return shape;
+    }
     /**
      * Returns the element specified by the positionAnchor prop,
      * or undefined if prop's value is an ID string and the element
@@ -371,12 +360,12 @@ export class Toast {
         if (buttons.length === 0) {
             return;
         }
-        const mode = getIonMode(this);
+        const theme = getIonTheme(this);
         const buttonGroupsClasses = {
             'toast-button-group': true,
             [`toast-button-group-${side}`]: true,
         };
-        return (h("div", { class: buttonGroupsClasses }, buttons.map((b) => (h("button", Object.assign({}, b.htmlAttributes, { type: "button", class: buttonClass(b), tabIndex: 0, onClick: () => this.buttonClick(b), part: buttonPart(b) }), h("div", { class: "toast-button-inner" }, b.icon && (h("ion-icon", { "aria-hidden": "true", icon: b.icon, slot: b.text === undefined ? 'icon-only' : undefined, class: "toast-button-icon" })), b.text), mode === 'md' && (h("ion-ripple-effect", { type: b.icon !== undefined && b.text === undefined ? 'unbounded' : 'bounded' })))))));
+        return (h("div", { class: buttonGroupsClasses }, buttons.map((b) => (h("button", Object.assign({}, b.htmlAttributes, { type: "button", class: buttonClass(b), tabIndex: 0, onClick: () => this.buttonClick(b), part: buttonPart(b) }), h("div", { class: "toast-button-inner" }, b.icon && (h("ion-icon", { "aria-hidden": "true", icon: b.icon, slot: b.text === undefined ? 'icon-only' : undefined, class: "toast-button-icon" })), b.text), theme === 'md' && (h("ion-ripple-effect", { type: b.icon !== undefined && b.text === undefined ? 'unbounded' : 'bounded' })))))));
     }
     /**
      * Render the `message` property.
@@ -403,7 +392,9 @@ export class Toast {
         const allButtons = this.getButtons();
         const startButtons = allButtons.filter((b) => b.side === 'start');
         const endButtons = allButtons.filter((b) => b.side !== 'start');
+        const theme = getIonTheme(this);
         const mode = getIonMode(this);
+        const shape = this.getShape();
         const wrapperClass = {
             'toast-wrapper': true,
             [`toast-${this.position}`]: true,
@@ -416,22 +407,24 @@ export class Toast {
         if (layout === 'stacked' && startButtons.length > 0 && endButtons.length > 0) {
             printIonWarning('This toast is using start and end buttons with the stacked toast layout. We recommend following the best practice of using either start or end buttons with the stacked toast layout.', el);
         }
-        return (h(Host, Object.assign({ key: 'c05655ff06af8d0e48c2a85396b07ad942fa81b4', tabindex: "-1" }, this.htmlAttributes, { style: {
+        return (h(Host, Object.assign({ key: '41e65d32ffecd6e9c573c3fdc5f074df44dcf99e', tabindex: "-1" }, this.htmlAttributes, { style: {
                 zIndex: `${60000 + this.overlayIndex}`,
-            }, class: createColorClasses(this.color, Object.assign(Object.assign({ [mode]: true }, getClassMap(this.cssClass)), { 'overlay-hidden': true, 'toast-translucent': this.translucent })), onIonToastWillDismiss: this.dispatchCancelHandler }), h("div", { key: '9393ead4de1bf28529661d6f64049d34e18d725c', class: wrapperClass }, h("div", { key: '3e9dd73c17c337849c3f26e8d0f395b3e5ee20a7', class: "toast-container", part: "container" }, this.renderButtons(startButtons, 'start'), this.icon !== undefined && (h("ion-icon", { key: '5d15b18364301ad55e44e9f601014ac33181590b', class: "toast-icon", part: "icon", icon: this.icon, lazy: false, "aria-hidden": "true" })), h("div", { key: 'f6dd164502637a882c5caf18445d8509b85ad6f9', class: "toast-content", role: "status", "aria-atomic": "true", "aria-live": "polite" }, !revealContentToScreenReader && header !== undefined && this.renderHeader('oldHeader', 'true'), !revealContentToScreenReader && message !== undefined && this.renderToastMessage('oldMessage', 'true'), revealContentToScreenReader && header !== undefined && this.renderHeader('header'), revealContentToScreenReader && message !== undefined && this.renderToastMessage('header')), this.renderButtons(endButtons, 'end')))));
+            }, class: createColorClasses(this.color, Object.assign(Object.assign({ [mode]: true, [theme]: true }, getClassMap(this.cssClass)), { 'overlay-hidden': true, 'toast-translucent': this.translucent, [`toast-shape-${shape}`]: shape !== undefined })), onIonToastWillDismiss: this.dispatchCancelHandler }), h("div", { key: '0251b8fa67a943d713d67760aa9f0f0f5849cee4', class: wrapperClass }, h("div", { key: '1f5a7f5d90d0bcbb85c06da291dab9b8123d79cd', class: "toast-container", part: "container" }, this.renderButtons(startButtons, 'start'), this.icon !== undefined && (h("ion-icon", { key: 'e38b268414f1501ca3d649988480f70ee9a7b2ad', class: "toast-icon", part: "icon", icon: this.icon, lazy: false, "aria-hidden": "true" })), h("div", { key: '39d78e2fc2b5524d6c83474f09bb3f1a7b311b96', class: "toast-content", role: "status", "aria-atomic": "true", "aria-live": "polite" }, !revealContentToScreenReader && header !== undefined && this.renderHeader('oldHeader', 'true'), !revealContentToScreenReader && message !== undefined && this.renderToastMessage('oldMessage', 'true'), revealContentToScreenReader && header !== undefined && this.renderHeader('header'), revealContentToScreenReader && message !== undefined && this.renderToastMessage('header')), this.renderButtons(endButtons, 'end')))));
     }
     static get is() { return "ion-toast"; }
     static get encapsulation() { return "shadow"; }
     static get originalStyleUrls() {
         return {
             "ios": ["toast.ios.scss"],
-            "md": ["toast.md.scss"]
+            "md": ["toast.md.scss"],
+            "ionic": ["toast.ionic.scss"]
         };
     }
     static get styleUrls() {
         return {
             "ios": ["toast.ios.css"],
-            "md": ["toast.md.css"]
+            "md": ["toast.md.css"],
+            "ionic": ["toast.ionic.css"]
         };
     }
     static get properties() {
@@ -453,8 +446,6 @@ export class Toast {
                         }],
                     "text": ""
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "overlay-index",
                 "reflect": false
             },
@@ -480,9 +471,7 @@ export class Toast {
                             "text": undefined
                         }],
                     "text": ""
-                },
-                "getter": false,
-                "setter": false
+                }
             },
             "hasController": {
                 "type": "boolean",
@@ -501,8 +490,6 @@ export class Toast {
                         }],
                     "text": ""
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "has-controller",
                 "reflect": false,
                 "defaultValue": "false"
@@ -527,8 +514,6 @@ export class Toast {
                     "tags": [],
                     "text": "The color to use from your application's color palette.\nDefault options are: `\"primary\"`, `\"secondary\"`, `\"tertiary\"`, `\"success\"`, `\"warning\"`, `\"danger\"`, `\"light\"`, `\"medium\"`, and `\"dark\"`.\nFor more information on colors, see [theming](/docs/theming/basics)."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "color",
                 "reflect": true
             },
@@ -551,9 +536,7 @@ export class Toast {
                 "docs": {
                     "tags": [],
                     "text": "Animation to use when the toast is presented."
-                },
-                "getter": false,
-                "setter": false
+                }
             },
             "leaveAnimation": {
                 "type": "unknown",
@@ -574,9 +557,7 @@ export class Toast {
                 "docs": {
                     "tags": [],
                     "text": "Animation to use when the toast is dismissed."
-                },
-                "getter": false,
-                "setter": false
+                }
             },
             "cssClass": {
                 "type": "string",
@@ -592,8 +573,6 @@ export class Toast {
                     "tags": [],
                     "text": "Additional classes to apply for custom CSS. If multiple classes are\nprovided they should be separated by spaces."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "css-class",
                 "reflect": false
             },
@@ -611,8 +590,6 @@ export class Toast {
                     "tags": [],
                     "text": "How many milliseconds to wait before hiding the toast. By default, it will show\nuntil `dismiss()` is called."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "duration",
                 "reflect": false,
                 "defaultValue": "config.getNumber('toastDuration', 0)"
@@ -631,8 +608,6 @@ export class Toast {
                     "tags": [],
                     "text": "Header to be shown in the toast."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "header",
                 "reflect": false
             },
@@ -656,8 +631,6 @@ export class Toast {
                     "tags": [],
                     "text": "Defines how the message and buttons are laid out in the toast.\n'baseline': The message and the buttons will appear on the same line.\nMessage text may wrap within the message container.\n'stacked': The buttons containers and message will stack on top\nof each other. Use this if you have long text in your buttons."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "layout",
                 "reflect": false,
                 "defaultValue": "'baseline'"
@@ -682,8 +655,6 @@ export class Toast {
                     "tags": [],
                     "text": "Message to be shown in the toast.\nThis property accepts custom HTML as a string.\nContent is parsed as plaintext by default.\n`innerHTMLTemplatesEnabled` must be set to `true` in the Ionic config\nbefore custom HTML can be used."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "message",
                 "reflect": false
             },
@@ -701,8 +672,6 @@ export class Toast {
                     "tags": [],
                     "text": "If `true`, the keyboard will be automatically dismissed when the overlay is presented."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "keyboard-close",
                 "reflect": false,
                 "defaultValue": "false"
@@ -727,8 +696,6 @@ export class Toast {
                     "tags": [],
                     "text": "The starting position of the toast on the screen. Can be tweaked further\nusing the `positionAnchor` property."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "position",
                 "reflect": false,
                 "defaultValue": "'bottom'"
@@ -752,11 +719,26 @@ export class Toast {
                     "tags": [],
                     "text": "The element to anchor the toast's position to. Can be set as a direct reference\nor the ID of the element. With `position=\"bottom\"`, the toast will sit above the\nchosen element. With `position=\"top\"`, the toast will sit below the chosen element.\nWith `position=\"middle\"`, the value of `positionAnchor` is ignored."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "position-anchor",
                 "reflect": false
             },
+            "shape": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "'soft' | 'round' | 'rectangular'",
+                    "resolved": "\"rectangular\" | \"round\" | \"soft\" | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Set to `\"soft\"` for a toast with slightly rounded corners,\n`\"round\"` for a toast with fully rounded corners, or `\"rectangular\"`\nfor a toast without rounded corners.\n\nDefaults to `\"round\"` for the `ionic` theme, undefined for all other themes."
+                },
+                "attribute": "shape",
+                "reflect": false
+            },
             "buttons": {
                 "type": "unknown",
                 "mutable": false,
@@ -776,9 +758,7 @@ export class Toast {
                 "docs": {
                     "tags": [],
                     "text": "An array of buttons for the toast."
-                },
-                "getter": false,
-                "setter": false
+                }
             },
             "translucent": {
                 "type": "boolean",
@@ -792,10 +772,8 @@ export class Toast {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "If `true`, the toast will be translucent.\nOnly applies when the mode is `\"ios\"` and the device supports\n[`backdrop-filter`](https://developer.mozilla.org/en-US/docs/Web/CSS/backdrop-filter#Browser_compatibility)."
+                    "text": "If `true`, the toast will be translucent.\nOnly applies when the theme is `\"ios\"` and the device supports\n[`backdrop-filter`](https://developer.mozilla.org/en-US/docs/Web/CSS/backdrop-filter#Browser_compatibility)."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "translucent",
                 "reflect": false,
                 "defaultValue": "false"
@@ -814,8 +792,6 @@ export class Toast {
                     "tags": [],
                     "text": "If `true`, the toast will animate."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "animated",
                 "reflect": false,
                 "defaultValue": "true"
@@ -834,8 +810,6 @@ export class Toast {
                     "tags": [],
                     "text": "The name of the icon to display, or the path to a valid SVG file. See `ion-icon`.\nhttps://ionic.io/ionicons"
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "icon",
                 "reflect": false
             },
@@ -852,9 +826,7 @@ export class Toast {
                 "docs": {
                     "tags": [],
                     "text": "Additional attributes to pass to the toast."
-                },
-                "getter": false,
-                "setter": false
+                }
             },
             "swipeGesture": {
                 "type": "string",
@@ -876,8 +848,6 @@ export class Toast {
                     "tags": [],
                     "text": "If set to 'vertical', the Toast can be dismissed with\na swipe gesture. The swipe direction is determined by\nthe value of the `position` property:\n`top`: The Toast can be swiped up to dismiss.\n`bottom`: The Toast can be swiped down to dismiss.\n`middle`: The Toast can be swiped up or down to dismiss."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "swipe-gesture",
                 "reflect": false
             },
@@ -895,8 +865,6 @@ export class Toast {
                     "tags": [],
                     "text": "If `true`, the toast will open. If `false`, the toast will close.\nUse this if you need finer grained control over presentation, otherwise\njust use the toastController or the `trigger` property.\nNote: `isOpen` will not automatically be set back to `false` when\nthe toast dismisses. You will need to do that in your code."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "is-open",
                 "reflect": false,
                 "defaultValue": "false"
@@ -915,8 +883,6 @@ export class Toast {
                     "tags": [],
                     "text": "An ID corresponding to the trigger element that\ncauses the toast to open when clicked."
                 },
-                "getter": false,
-                "setter": false,
                 "attribute": "trigger",
                 "reflect": false
             }

package/dist/collection/components/toast/toast.md.css

@@ -1,36 +1,3 @@
-/**
- * Convert a font size to a dynamic font size.
- * Fonts that participate in Dynamic Type should use
- * dynamic font sizes.
- * @param size - The initial font size including the unit (i.e. px or pt)
- * @param unit (optional) - The unit to convert to. Use this if you want to
- * convert to a unit other than $baselineUnit.
- */
-/**
- * Convert a font size to a dynamic font size but impose
- * a maximum font size.
- * @param size - The initial font size including the unit (i.e. px or pt)
- * @param maxScale - The maximum scale of the font (i.e. 2.5 for a maximum 250% scale).
- * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
- * convert to a unit other than $baselineUnit.
- */
-/**
- * Convert a font size to a dynamic font size but impose
- * a minimum font size.
- * @param size - The initial font size including the unit (i.e. px or pt)
- * @param minScale - The minimum scale of the font (i.e. 0.8 for a minimum 80% scale).
- * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
- * convert to a unit other than $baselineUnit.
- */
-/**
- * Convert a font size to a dynamic font size but impose
- * maximum and minimum font sizes.
- * @param size - The initial font size including the unit (i.e. px or pt)
- * @param minScale - The minimum scale of the font (i.e. 0.8 for a minimum 80% scale).
- * @param maxScale - The maximum scale of the font (i.e. 2.5 for a maximum 250% scale).
- * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
- * convert to a unit other than $baselineUnit.
- */
 /**
  * A heuristic that applies CSS to tablet
  * viewports.
@@ -97,11 +64,10 @@
   height: 100%;
   outline: none;
   color: var(--color);
-  font-family: var(--ion-font-family, inherit);
   contain: strict;
-  z-index: 1001;
   pointer-events: none;
 }
+
 :host {
   inset-inline-start: 0;
 }
@@ -138,6 +104,7 @@
   box-shadow: var(--box-shadow);
   pointer-events: auto;
 }
+
 .toast-wrapper {
   inset-inline-start: var(--start);
   inset-inline-end: var(--end);
@@ -218,6 +185,78 @@
     cursor: pointer;
   }
 }
+/**
+ * Convert a pixels given value into rem
+ * 
+ * @param pixels - Value in pixels to be converted (i.e. px)
+ * @param context (optional) - Baseline value
+ */
+/**
+ * Convert a font size to a dynamic font size.
+ * Fonts that participate in Dynamic Type should use
+ * dynamic font sizes.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param unit (optional) - The unit to convert to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * a maximum font size.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param maxScale - The maximum scale of the font (i.e. 2.5 for a maximum 250% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * a minimum font size.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param minScale - The minimum scale of the font (i.e. 0.8 for a minimum 80% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * maximum and minimum font sizes.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param minScale - The minimum scale of the font (i.e. 0.8 for a minimum 80% scale).
+ * @param maxScale - The maximum scale of the font (i.e. 2.5 for a maximum 250% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * A heuristic that applies CSS to tablet
+ * viewports.
+ *
+ * Usage:
+ * @include tablet-viewport() {
+ *   :host {
+ *     background-color: green;
+ *   }
+ * }
+ */
+/**
+ * A heuristic that applies CSS to mobile
+ * viewports (i.e. phones, not tablets).
+ *
+ * Usage:
+ * @include mobile-viewport() {
+ *   :host {
+ *     background-color: blue;
+ *   }
+ * }
+ */
+:host {
+  font-family: var(--ion-font-family, inherit);
+  z-index: 1001;
+}
+
+/**
+ * Convert a pixels given value into rem
+ * 
+ * @param pixels - Value in pixels to be converted (i.e. px)
+ * @param context (optional) - Baseline value
+ */
 /**
  * Convert a font size to a dynamic font size.
  * Fonts that participate in Dynamic Type should use