@ohos-ports/instructure-ui-toggle-details 11.7.5-beta.1

package/src/ToggleDetails/v2/props.ts

@@ -0,0 +1,115 @@
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present 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.
+ */
+
+import React from 'react'
+
+import type { OtherHTMLAttributes } from '@instructure/shared-types'
+import type { WithStyleProps, ComponentStyle } from '@instructure/emotion'
+import type { NewComponentTypes } from '@instructure/ui-themes'
+import type { ViewProps } from '@instructure/ui-view/latest'
+
+type ToggleDetailsOwnProps = {
+  variant?: 'default' | 'filled'
+  /**
+   * The summary that displays and can be interacted with
+   */
+  summary: React.ReactNode
+  /**
+   * Whether the content is expanded or hidden
+   */
+  expanded?: boolean // TODO: controllable(PropTypes.bool, 'onToggle', 'defaultExpanded')
+  /**
+   * Whether the content is initially expanded or hidden (uncontrolled)
+   */
+  defaultExpanded?: boolean
+  onToggle?: (
+    event: React.KeyboardEvent<ViewProps> | React.MouseEvent<ViewProps>,
+    expanded: boolean
+  ) => void
+  /**
+   * The icon to display next to the summary text when content is hidden
+   */
+  icon?: (...args: any[]) => React.ReactElement
+  /**
+   * The icon to display when content is expanded
+   */
+  iconExpanded?: (...args: any[]) => React.ReactElement
+  /**
+   * Icon position at the start or end of the summary text
+   */
+  iconPosition?: 'start' | 'end'
+  /**
+   * should the summary fill the width of its container
+   */
+  fluidWidth?: boolean
+  /**
+   * Choose a size for the expand/collapse icon
+   */
+  size?: 'small' | 'medium' | 'large'
+  /**
+   * The toggleable content passed inside the ToggleDetails component
+   */
+  children?: React.ReactNode
+}
+
+type PropKeys = keyof ToggleDetailsOwnProps
+
+type AllowedPropKeys = Readonly<Array<PropKeys>>
+
+type ToggleDetailsProps = ToggleDetailsOwnProps &
+  WithStyleProps<
+    ReturnType<NewComponentTypes['ToggleDetails']>,
+    ToggleDetailsStyle
+  > &
+  OtherHTMLAttributes<ToggleDetailsOwnProps>
+
+type ToggleDetailsStyle = ComponentStyle<
+  | 'toggleDetails'
+  | 'summary'
+  | 'summaryText'
+  | 'toggle'
+  | 'icon'
+  | 'details'
+  | 'content'
+>
+
+type ToggleDetailsStyleProps = {
+  animate: boolean
+}
+const allowedProps: AllowedPropKeys = [
+  'variant',
+  'summary',
+  'expanded',
+  'defaultExpanded',
+  'onToggle',
+  'icon',
+  'iconExpanded',
+  'iconPosition',
+  'fluidWidth',
+  'children',
+  'size'
+]
+
+export type { ToggleDetailsProps, ToggleDetailsStyleProps, ToggleDetailsStyle }
+export { allowedProps }

package/src/ToggleDetails/v2/styles.ts

@@ -0,0 +1,188 @@
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present 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.
+ */
+
+import { keyframes } from '@instructure/emotion'
+
+import type { NewComponentTypes, SharedTokens } from '@instructure/ui-themes'
+import type {
+  ToggleDetailsProps,
+  ToggleDetailsStyleProps,
+  ToggleDetailsStyle
+} from './props'
+
+const contentAnimation = keyframes`
+  to {
+    opacity: 1;
+  }`
+
+/**
+ * ---
+ * private: true
+ * ---
+ * Generates the style object from the theme and provided additional information
+ * @param  {Object} componentTheme The theme variable object.
+ * @param  {Object} props the props of the component, the style is applied to
+ * @param  {Object} sharedTokens the shared tokens of the component
+ * @param  {Object} state the state of the component, the style is applied to
+ * @return {Object} The final style object, which will be used in the component
+ */
+const generateStyle = (
+  componentTheme: ReturnType<NewComponentTypes['ToggleDetails']>,
+  props: ToggleDetailsProps,
+  sharedTokens: SharedTokens,
+  _state: ToggleDetailsStyleProps
+): ToggleDetailsStyle => {
+  const { fluidWidth, iconPosition, size, variant } = props
+
+  const positionIconAtEnd =
+    iconPosition === 'end' && (variant === 'filled' || fluidWidth)
+  const fluidWidthStyles = fluidWidth ? { display: 'block', width: '100%' } : {}
+
+  const iconPositionStyles = {
+    start: {
+      marginInlineEnd: componentTheme.iconMargin,
+      marginInlineStart: 0
+    },
+    end: {
+      marginInlineStart: componentTheme.iconMargin,
+      marginInlineEnd: 0
+    }
+  }
+
+  const fontSizeStyles = {
+    small: { fontSize: componentTheme.fontSizeSmall },
+    medium: { fontSize: componentTheme.fontSizeMedium },
+    large: { fontSize: componentTheme.fontSizeLarge }
+  }
+
+  const indentDetailsStyles =
+    iconPosition === 'start' && !fluidWidth
+      ? {
+          small: {
+            paddingInlineStart: `calc(${componentTheme.contentPaddingSmall} + ${componentTheme.togglePadding})`,
+            paddingInlineEnd: '0'
+          },
+          medium: {
+            paddingInlineStart: `calc(${componentTheme.contentPaddingMedium} + ${componentTheme.togglePadding})`,
+            paddingInlineEnd: '0'
+          },
+          large: {
+            paddingInlineStart: `calc(${componentTheme.contentPaddingLarge} + ${componentTheme.togglePadding})`,
+            paddingInlineEnd: '0'
+          }
+        }
+      : {
+          small: {},
+          medium: {},
+          large: {}
+        }
+
+  return {
+    toggleDetails: {
+      label: 'toggleDetails',
+      fontFamily: componentTheme.fontFamily,
+      fontWeight: componentTheme.fontWeight
+    },
+    summary: {
+      label: 'toggleDetails__summary',
+      position: 'relative',
+      display: 'flex',
+      alignItems: 'center',
+      boxSizing: 'border-box',
+      textAlign: 'start'
+    },
+    summaryText: {
+      label: 'toggleDetails__summaryText',
+      minWidth: '0.0625rem',
+      flexGrow: 1,
+      ...(positionIconAtEnd ? { flex: 1 } : {})
+    },
+    toggle: {
+      label: 'toggleDetails__toggle',
+      fontFamily: componentTheme.fontFamily,
+      lineHeight: componentTheme.lineHeight,
+      appearance: 'none',
+      cursor: 'pointer',
+      userSelect: 'none',
+      touchAction: 'manipulation',
+      position: 'relative',
+      overflow: 'visible',
+      boxSizing: 'border-box',
+      padding: '0',
+      margin: '0',
+      outline: 'none',
+      border: 'none',
+      background: 'transparent',
+      color: componentTheme.textColor,
+      '&::-moz-focus-inner': { padding: '0', margin: '0' },
+      '&::before': {
+        content: '""',
+        position: 'absolute',
+        top: '-0.375rem',
+        left: '-0.375rem',
+        right: '-0.375rem',
+        bottom: '-0.375rem',
+        border: `${componentTheme.toggleBorderWidth} ${componentTheme.toggleBorderStyle} ${sharedTokens.focusOutline.infoColor}`,
+        borderRadius: `calc(${componentTheme.toggleBorderRadius} * 1.5)`,
+        opacity: 0,
+        pointerEvents: 'none'
+      },
+      '&:focus': { '&::before': { opacity: 1 } },
+      '&:focus, &:hover,  &:active': {
+        textDecoration: 'none',
+        color: componentTheme.textColor
+      },
+      textDecoration: 'none',
+      ...fluidWidthStyles,
+      ...fontSizeStyles[size!]
+    },
+    icon: {
+      label: 'toggleDetails__icon',
+      display: 'flex',
+      alignItems: 'center',
+      '& > svg': {
+        display: 'block' /* fix vertical alignment of icon */
+      },
+      ...iconPositionStyles[iconPosition!]
+    },
+    details: {
+      label: 'toggleDetails__details',
+      boxSizing: 'border-box',
+      paddingTop: componentTheme.togglePadding,
+      color: componentTheme.textColor,
+      lineHeight: componentTheme.lineHeight,
+      ...fontSizeStyles[size!],
+      ...indentDetailsStyles[size!]
+    },
+    content: {
+      label: 'toggleDetails__content',
+      opacity: 0.01,
+      animationName: contentAnimation,
+      animationFillMode: 'forwards',
+      animationDuration: '.3s'
+    }
+  }
+}
+
+export default generateStyle

package/src/ToggleGroup/v1/README.md

@@ -0,0 +1,93 @@
+---
+describes: ToggleGroup
+---
+
+Performs the same function as [`ToggleDetails`](ToggleDetails), but with the summary separated from the
+toggle button, and built in padding and borders around the summary and main content area.
+
+### Basic example
+
+```javascript
+---
+type: example
+---
+<ToggleGroup
+  toggleLabel="This is the toggle button label for screenreaders"
+  summary="This is the summary"
+  background="default"
+>
+  <View display="block" padding="small">Here is the expanded content</View>
+</ToggleGroup>
+```
+
+### More detailed examples
+
+#### `defaultExpanded` to make the component `expanded` when it renders
+
+```javascript
+---
+type: example
+---
+<ToggleGroup
+  toggleLabel="This is the toggle button label for screenreaders"
+  summary="This is the summary"
+  defaultExpanded
+>
+  <View display="block" padding="small">This content is expanded when the component renders</View>
+</ToggleGroup>
+```
+
+#### Passing in your own `icon` and `iconExpanded`
+
+```javascript
+---
+type: example
+---
+<ToggleGroup
+  toggleLabel="This is the toggle button label for screenreaders"
+  summary="This is the summary"
+  iconExpanded={IconXSolid}
+  icon={IconPlusSolid}
+>
+  <View display="block" padding="small">Here is the expanded content</View>
+</ToggleGroup>
+```
+
+#### Disable default transition of details
+
+```javascript
+---
+type: example
+---
+<ToggleGroup
+  transition={false}
+  toggleLabel="This is the toggle button label for screenreaders"
+  summary="This is the summary"
+>
+  <View display="block" padding="small">This content will not fade in</View>
+</ToggleGroup>
+```
+
+#### Disable default border if you want to nest ToggleGroups
+
+```javascript
+---
+type: example
+---
+<ToggleGroup
+  defaultExpanded
+  toggleLabel="This is the toggle button label for screenreaders"
+  summary={<Heading level="h3">Parent ToggleGroup</Heading>}
+>
+  <ToggleGroup
+    size="small"
+    toggleLabel="This is the toggle button label for screenreaders"
+    summary="I am nested inside a parent ToggleGroup"
+    border={false}
+  >
+    <View display="block" padding="small">
+      This is the details section of the nested ToggleGroup
+    </View>
+  </ToggleGroup>
+</ToggleGroup>
+```

package/src/ToggleGroup/v1/index.tsx

@@ -0,0 +1,206 @@
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present 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.
+ */
+
+import { Component } from 'react'
+
+import {
+  omitProps,
+  pickProps,
+  getElementType,
+  callRenderProp
+} from '@instructure/ui-react-utils'
+import { IconButton } from '@instructure/ui-buttons/v11_6'
+import { Transition } from '@instructure/ui-motion'
+import { Expandable } from '@instructure/ui-expandable'
+import type { ExpandableToggleProps } from '@instructure/ui-expandable'
+import { isActiveElement } from '@instructure/ui-dom-utils'
+import { Flex } from '@instructure/ui-flex/v11_6'
+import { View } from '@instructure/ui-view/v11_6'
+import {
+  IconArrowOpenEndSolid,
+  IconArrowOpenDownSolid
+} from '@instructure/ui-icons'
+import type { ToggleGroupProps } from './props'
+import { allowedProps } from './props.js'
+
+import { withStyle } from '@instructure/emotion'
+
+import generateStyle from './styles.js'
+import generateComponentTheme from './theme.js'
+
+/**
+---
+category: components
+---
+**/
+@withStyle(generateStyle, generateComponentTheme)
+class ToggleGroup extends Component<ToggleGroupProps> {
+  static displayName = 'ToggleGroup'
+  static readonly componentId = 'ToggleGroup'
+
+  static allowedProps = allowedProps
+
+  static defaultProps = {
+    size: 'medium',
+    icon: IconArrowOpenEndSolid,
+    iconExpanded: IconArrowOpenDownSolid,
+    defaultExpanded: false,
+    transition: true,
+    as: 'span',
+    border: true
+  } as const
+
+  ref: Element | null = null
+  _button: HTMLElement | null = null
+  _shouldTransition = false
+
+  handleRef = (el: Element | null) => {
+    const { elementRef } = this.props
+
+    this.ref = el
+
+    if (typeof elementRef === 'function') {
+      elementRef(el)
+    }
+  }
+
+  handleButtonRef = (el: Element | null) => {
+    this._button = el as HTMLElement
+  }
+
+  get focused() {
+    return isActiveElement(this._button)
+  }
+
+  focus() {
+    this._button?.focus()
+  }
+
+  componentDidMount() {
+    this._shouldTransition = true
+  }
+
+  componentDidUpdate() {
+    this.props.makeStyles?.(this.state)
+  }
+
+  renderIcon(expanded: boolean) {
+    const Icon = expanded ? this.props.iconExpanded : this.props.icon
+    return Icon ? callRenderProp(Icon) : null
+  }
+
+  renderToggle(
+    toggleProps: ReturnType<ExpandableToggleProps>,
+    expanded: boolean
+  ) {
+    const { toggleLabel, size } = this.props
+    let label
+    if (typeof toggleLabel === 'function') {
+      label = toggleLabel(expanded)
+    } else {
+      label = toggleLabel
+    }
+
+    const props = { ...toggleProps } as Record<string, any>
+    return (
+      <IconButton
+        {...props}
+        withBackground={false}
+        withBorder={false}
+        size={size === 'large' ? 'medium' : 'small'}
+        elementRef={this.handleButtonRef}
+        screenReaderLabel={label}
+      >
+        {this.renderIcon(expanded)}
+      </IconButton>
+    )
+  }
+
+  renderDetails(detailsProps: { id: string }) {
+    const { styles } = this.props
+    return (
+      <View
+        {...detailsProps}
+        display="block"
+        borderWidth="small none none none"
+        borderColor={styles?.borderColor}
+      >
+        {this.props.transition && this._shouldTransition ? (
+          <Transition transitionOnMount in type="fade">
+            {this.props.children}
+          </Transition>
+        ) : (
+          this.props.children
+        )}
+      </View>
+    )
+  }
+
+  render() {
+    const Element = getElementType(ToggleGroup, this.props)
+    const { styles } = this.props
+    return (
+      <Expandable {...pickProps(this.props, Expandable.allowedProps)}>
+        {({ expanded, getToggleProps, getDetailsProps }) => {
+          return (
+            <View
+              {...omitProps(this.props, ToggleGroup.allowedProps)}
+              borderWidth={this.props.border ? 'small' : 'none'}
+              as={Element}
+              elementRef={this.handleRef}
+              display="block"
+              borderRadius="medium"
+              background="primary"
+              borderColor={styles?.borderColor}
+              data-cid="ToggleGroup"
+            >
+              <Flex
+                padding={
+                  this.props.size === 'small'
+                    ? 'x-small'
+                    : 'small small small x-small'
+                }
+              >
+                <Flex.Item>
+                  {this.renderToggle(getToggleProps(), expanded)}
+                </Flex.Item>
+                <Flex.Item shouldGrow shouldShrink padding="0 0 0 x-small">
+                  {this.props.summary}
+                </Flex.Item>
+              </Flex>
+              {expanded ? (
+                this.renderDetails(getDetailsProps())
+              ) : (
+                <span {...getDetailsProps()} />
+              )}
+            </View>
+          )
+        }}
+      </Expandable>
+    )
+  }
+}
+
+export default ToggleGroup
+export { ToggleGroup }