aboutsummaryrefslogtreecommitdiffstats
path: root/src/components/molecules/buttons
diff options
context:
space:
mode:
Diffstat (limited to 'src/components/molecules/buttons')
-rw-r--r--src/components/molecules/buttons/help-button.module.scss20
-rw-r--r--src/components/molecules/buttons/help-button.test.tsx10
-rw-r--r--src/components/molecules/buttons/help-button.tsx40
-rw-r--r--src/components/molecules/buttons/help-button/help-button.module.scss24
-rw-r--r--src/components/molecules/buttons/help-button/help-button.stories.tsx (renamed from src/components/molecules/buttons/help-button.stories.tsx)5
-rw-r--r--src/components/molecules/buttons/help-button/help-button.test.tsx13
-rw-r--r--src/components/molecules/buttons/help-button/help-button.tsx42
-rw-r--r--src/components/molecules/buttons/help-button/index.ts1
8 files changed, 84 insertions, 71 deletions
diff --git a/src/components/molecules/buttons/help-button.module.scss b/src/components/molecules/buttons/help-button.module.scss
deleted file mode 100644
index fb28b57..0000000
--- a/src/components/molecules/buttons/help-button.module.scss
+++ /dev/null
@@ -1,20 +0,0 @@
-@use "../../../styles/abstracts/mixins" as mix;
-
-.btn {
- padding: var(--spacing-xs);
-
- &:not(:disabled) {
- &:focus {
- text-decoration: none;
- }
- }
-
- @include mix.pointer("fine") {
- padding: var(--spacing-2xs);
- }
-}
-
-.icon {
- color: var(--color-primary-dark);
- font-weight: 600;
-}
diff --git a/src/components/molecules/buttons/help-button.test.tsx b/src/components/molecules/buttons/help-button.test.tsx
deleted file mode 100644
index 85daf30..0000000
--- a/src/components/molecules/buttons/help-button.test.tsx
+++ /dev/null
@@ -1,10 +0,0 @@
-import { describe, expect, it } from '@jest/globals';
-import { render, screen } from '../../../../tests/utils';
-import { HelpButton } from './help-button';
-
-describe('Help', () => {
- it('renders a help button', () => {
- render(<HelpButton />);
- expect(screen.getByRole('button', { name: 'Help ?' })).toBeInTheDocument();
- });
-});
diff --git a/src/components/molecules/buttons/help-button.tsx b/src/components/molecules/buttons/help-button.tsx
deleted file mode 100644
index 7a01b14..0000000
--- a/src/components/molecules/buttons/help-button.tsx
+++ /dev/null
@@ -1,40 +0,0 @@
-import { forwardRef, type ForwardRefRenderFunction } from 'react';
-import { useIntl } from 'react-intl';
-import { Button, type ButtonProps } from '../../atoms';
-import styles from './help-button.module.scss';
-
-export type HelpButtonProps = Pick<
- ButtonProps,
- 'className' | 'isPressed' | 'onClick'
->;
-
-const HelpButtonWithRef: ForwardRefRenderFunction<
- HTMLButtonElement,
- HelpButtonProps
-> = ({ className = '', ...props }, ref) => {
- const intl = useIntl();
- const text = intl.formatMessage({
- defaultMessage: 'Help',
- id: 'i+/ckF',
- description: 'HelpButton: screen reader text',
- });
-
- return (
- <Button
- className={`${styles.btn} ${className}`}
- ref={ref}
- shape="circle"
- {...props}
- >
- <span className="screen-reader-text">{text}</span>
- <span className={styles.icon}>?</span>
- </Button>
- );
-};
-
-/**
- * HelpButton component
- *
- * Render a button with an interrogation mark icon.
- */
-export const HelpButton = forwardRef(HelpButtonWithRef);
diff --git a/src/components/molecules/buttons/help-button/help-button.module.scss b/src/components/molecules/buttons/help-button/help-button.module.scss
new file mode 100644
index 0000000..2dbba69
--- /dev/null
+++ b/src/components/molecules/buttons/help-button/help-button.module.scss
@@ -0,0 +1,24 @@
+@use "../../../../styles/abstracts/functions" as fun;
+@use "../../../../styles/abstracts/mixins" as mix;
+
+.btn {
+ padding: fun.convert-px(7);
+
+ @include mix.pointer("fine") {
+ padding: fun.convert-px(4);
+ }
+
+ &[aria-pressed="true"] {
+ background: var(--color-primary-dark);
+ border-color: var(--color-primary-dark);
+ box-shadow: fun.convert-px(1) fun.convert-px(1) 0 0 var(--color-shadow);
+
+ .icon {
+ :global {
+ path {
+ fill: var(--color-fg-inverted);
+ }
+ }
+ }
+ }
+}
diff --git a/src/components/molecules/buttons/help-button.stories.tsx b/src/components/molecules/buttons/help-button/help-button.stories.tsx
index 176888c..556dd74 100644
--- a/src/components/molecules/buttons/help-button.stories.tsx
+++ b/src/components/molecules/buttons/help-button/help-button.stories.tsx
@@ -1,4 +1,4 @@
-import { ComponentMeta, ComponentStory } from '@storybook/react';
+import type { ComponentMeta, ComponentStory } from '@storybook/react';
import { HelpButton as HelpButtonComponent } from './help-button';
/**
@@ -45,3 +45,6 @@ const Template: ComponentStory<typeof HelpButtonComponent> = (args) => (
* Help Button Stories - Level 1
*/
export const HelpButton = Template.bind({});
+HelpButton.args = {
+ label: 'Help',
+};
diff --git a/src/components/molecules/buttons/help-button/help-button.test.tsx b/src/components/molecules/buttons/help-button/help-button.test.tsx
new file mode 100644
index 0000000..f36fba7
--- /dev/null
+++ b/src/components/molecules/buttons/help-button/help-button.test.tsx
@@ -0,0 +1,13 @@
+import { describe, expect, it } from '@jest/globals';
+import { render, screen as rtlScreen } from '@testing-library/react';
+import { HelpButton } from './help-button';
+
+describe('Help', () => {
+ it('renders a help button', () => {
+ const label = 'hic';
+
+ render(<HelpButton label={label} />);
+
+ expect(rtlScreen.getByRole('button')).toHaveAccessibleName(label);
+ });
+});
diff --git a/src/components/molecules/buttons/help-button/help-button.tsx b/src/components/molecules/buttons/help-button/help-button.tsx
new file mode 100644
index 0000000..1951b4d
--- /dev/null
+++ b/src/components/molecules/buttons/help-button/help-button.tsx
@@ -0,0 +1,42 @@
+import { forwardRef, type ForwardRefRenderFunction } from 'react';
+import { Button, VisuallyHidden, type ButtonProps, Icon } from '../../../atoms';
+import styles from './help-button.module.scss';
+
+export type HelpButtonProps = Omit<
+ ButtonProps,
+ 'aria-label' | 'children' | 'kind' | 'shape'
+> & {
+ /**
+ * Define an accessible name for the button.
+ */
+ label: string;
+};
+
+const HelpButtonWithRef: ForwardRefRenderFunction<
+ HTMLButtonElement,
+ HelpButtonProps
+> = ({ className = '', isPressed = false, label, ...props }, ref) => {
+ const btnClass = `${styles.btn} ${className}`;
+
+ return (
+ <Button
+ {...props}
+ className={btnClass}
+ isPressed={isPressed}
+ ref={ref}
+ // eslint-disable-next-line react/jsx-no-literals -- Shape allowed
+ shape="circle"
+ >
+ {/* eslint-disable-next-line react/jsx-no-literals -- Config allowed */}
+ <Icon aria-hidden className={styles.icon} shape="help" size="sm" />
+ <VisuallyHidden>{label}</VisuallyHidden>
+ </Button>
+ );
+};
+
+/**
+ * HelpButton component
+ *
+ * Render a button with an interrogation mark icon.
+ */
+export const HelpButton = forwardRef(HelpButtonWithRef);
diff --git a/src/components/molecules/buttons/help-button/index.ts b/src/components/molecules/buttons/help-button/index.ts
new file mode 100644
index 0000000..952119e
--- /dev/null
+++ b/src/components/molecules/buttons/help-button/index.ts
@@ -0,0 +1 @@
+export * from './help-button';