@docusaurus/theme-classic 2.0.0-beta.16 → 2.0.0-beta.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -7,94 +7,116 @@
7
7
 
8
8
  import type {SwizzleConfig} from '@docusaurus/types';
9
9
 
10
+ /* eslint sort-keys: "error" */
11
+
10
12
  export default function getSwizzleConfig(): SwizzleConfig {
11
13
  return {
12
14
  components: {
13
15
  CodeBlock: {
14
16
  actions: {
15
- wrap: 'safe',
16
17
  eject: 'safe',
18
+ wrap: 'safe',
17
19
  },
18
20
  description:
19
21
  'The component used to render multi-line code blocks, generally used in Markdown files.',
20
22
  },
21
- DocSidebar: {
23
+ ColorModeToggle: {
22
24
  actions: {
25
+ eject: 'safe',
23
26
  wrap: 'safe',
27
+ },
28
+ description:
29
+ 'The color mode toggle to switch between light and dark mode.',
30
+ },
31
+ DocSidebar: {
32
+ actions: {
24
33
  eject: 'unsafe', // too much technical code in sidebar, not very safe atm
34
+ wrap: 'safe',
25
35
  },
26
36
  description: 'The sidebar component on docs pages',
27
37
  },
28
38
  Footer: {
29
39
  actions: {
30
- wrap: 'safe',
31
40
  eject: 'unsafe', // TODO split footer into smaller parts
41
+ wrap: 'safe',
32
42
  },
33
43
  description: "The footer component of you site's layout",
34
44
  },
35
- NotFound: {
45
+ IconArrow: {
36
46
  actions: {
37
- wrap: 'safe',
38
47
  eject: 'safe',
39
- },
40
- description:
41
- 'The global 404 page of your site, meant to be ejected and customized',
42
- },
43
- SearchBar: {
44
- actions: {
45
48
  wrap: 'safe',
46
- eject: 'safe',
47
49
  },
48
- // TODO how to describe this one properly?
49
- // By default it's an empty placeholder for the user to fill
50
- description:
51
- 'The search bar component of your site, appearing in the navbar.',
50
+ description: 'The arrow icon component',
52
51
  },
53
- IconArrow: {
52
+ IconDarkMode: {
54
53
  actions: {
55
- wrap: 'safe',
56
54
  eject: 'safe',
55
+ wrap: 'safe',
57
56
  },
58
- description: 'The arrow icon component',
57
+ description: 'The dark mode icon component.',
59
58
  },
60
59
  IconEdit: {
61
60
  actions: {
62
- wrap: 'safe',
63
61
  eject: 'safe',
62
+ wrap: 'safe',
64
63
  },
65
64
  description: 'The edit icon component',
66
65
  },
67
- IconMenu: {
66
+ IconLightMode: {
68
67
  actions: {
69
- wrap: 'safe',
70
68
  eject: 'safe',
69
+ wrap: 'safe',
71
70
  },
72
- description: 'The menu icon component',
71
+ description: 'The light mode icon component.',
73
72
  },
74
-
75
- 'prism-include-languages': {
73
+ IconMenu: {
76
74
  actions: {
77
- wrap: 'forbidden', // not a component!
78
75
  eject: 'safe',
76
+ wrap: 'safe',
79
77
  },
80
- description:
81
- 'The Prism languages to include for code block syntax highlighting. Meant to be ejected.',
78
+ description: 'The menu icon component',
82
79
  },
83
80
  MDXComponents: {
84
81
  actions: {
85
- wrap: 'forbidden', /// TODO allow wrapping objects???
86
82
  eject: 'safe',
83
+ wrap: 'forbidden', /// TODO allow wrapping objects???
87
84
  },
88
85
  description:
89
86
  'The MDX components to use for rendering MDX files. Meant to be ejected.',
90
87
  },
91
-
92
88
  // TODO should probably not even appear here
93
89
  'NavbarItem/utils': {
94
90
  actions: {
95
- wrap: 'forbidden',
96
91
  eject: 'forbidden',
92
+ wrap: 'forbidden',
93
+ },
94
+ },
95
+ NotFound: {
96
+ actions: {
97
+ eject: 'safe',
98
+ wrap: 'safe',
99
+ },
100
+ description:
101
+ 'The global 404 page of your site, meant to be ejected and customized',
102
+ },
103
+ SearchBar: {
104
+ actions: {
105
+ eject: 'safe',
106
+ wrap: 'safe',
97
107
  },
108
+ // TODO how to describe this one properly?
109
+ // By default it's an empty placeholder for the user to fill
110
+ description:
111
+ 'The search bar component of your site, appearing in the navbar.',
112
+ },
113
+ 'prism-include-languages': {
114
+ actions: {
115
+ eject: 'safe',
116
+ wrap: 'forbidden', // not a component!
117
+ },
118
+ description:
119
+ 'The Prism languages to include for code block syntax highlighting. Meant to be ejected.',
98
120
  },
99
121
  },
100
122
  };
@@ -6,19 +6,29 @@
6
6
  */
7
7
 
8
8
  import React from 'react';
9
- import Link from '@docusaurus/Link';
9
+ import Link, {type Props as LinkProps} from '@docusaurus/Link';
10
10
  import type {Props} from '@theme/BlogPostAuthor';
11
11
 
12
12
  import styles from './styles.module.css';
13
13
 
14
+ function MaybeLink(props: LinkProps): JSX.Element {
15
+ if (props.href) {
16
+ return <Link {...props} />;
17
+ }
18
+ return <>{props.children}</>;
19
+ }
20
+
14
21
  export default function BlogPostAuthor({author}: Props): JSX.Element {
15
- const {name, title, url, imageURL} = author;
22
+ const {name, title, url, imageURL, email} = author;
23
+ const link = url || (email && `mailto:${email}`) || undefined;
16
24
  return (
17
25
  <div className="avatar margin-bottom--sm">
18
26
  {imageURL && (
19
- <Link className="avatar__photo-link avatar__photo" href={url}>
20
- <img className={styles.image} src={imageURL} alt={name} />
21
- </Link>
27
+ <span className="avatar__photo-link avatar__photo">
28
+ <MaybeLink href={link}>
29
+ <img className={styles.image} src={imageURL} alt={name} />
30
+ </MaybeLink>
31
+ </span>
22
32
  )}
23
33
 
24
34
  {name && (
@@ -28,9 +38,9 @@ export default function BlogPostAuthor({author}: Props): JSX.Element {
28
38
  itemScope
29
39
  itemType="https://schema.org/Person">
30
40
  <div className="avatar__name">
31
- <Link href={url} itemProp="url">
41
+ <MaybeLink href={link} itemProp="url">
32
42
  <span itemProp="name">{name}</span>
33
- </Link>
43
+ </MaybeLink>
34
44
  </div>
35
45
  {title && (
36
46
  <small className="avatar__subtitle" itemProp="description">
@@ -0,0 +1,92 @@
1
+ /**
2
+ * Copyright (c) Facebook, Inc. and its affiliates.
3
+ *
4
+ * This source code is licensed under the MIT license found in the
5
+ * LICENSE file in the root directory of this source tree.
6
+ */
7
+
8
+ import React, {useState, useRef, useEffect} from 'react';
9
+ import type {Props} from '@theme/ColorModeToggle';
10
+ import useIsBrowser from '@docusaurus/useIsBrowser';
11
+ import {translate} from '@docusaurus/Translate';
12
+ import IconLightMode from '@theme/IconLightMode';
13
+ import IconDarkMode from '@theme/IconDarkMode';
14
+
15
+ import clsx from 'clsx';
16
+ import styles from './styles.module.css';
17
+
18
+ function ColorModeToggle({
19
+ className,
20
+ checked: defaultChecked,
21
+ onChange,
22
+ }: Props): JSX.Element {
23
+ const isBrowser = useIsBrowser();
24
+ const [checked, setChecked] = useState(defaultChecked);
25
+ const [focused, setFocused] = useState(false);
26
+ const inputRef = useRef<HTMLInputElement>(null);
27
+
28
+ useEffect(() => {
29
+ setChecked(defaultChecked);
30
+ }, [defaultChecked]);
31
+
32
+ return (
33
+ <div
34
+ className={clsx(styles.toggle, className, {
35
+ [styles.toggleChecked]: checked,
36
+ [styles.toggleFocused]: focused,
37
+ [styles.toggleDisabled]: !isBrowser,
38
+ })}>
39
+ {/* eslint-disable-next-line jsx-a11y/click-events-have-key-events */}
40
+ <div
41
+ className={styles.toggleButton}
42
+ role="button"
43
+ tabIndex={-1}
44
+ onClick={() => inputRef.current?.click()}>
45
+ <IconLightMode
46
+ className={clsx(styles.toggleIcon, styles.lightToggleIcon)}
47
+ />
48
+ <IconDarkMode
49
+ className={clsx(styles.toggleIcon, styles.darkToggleIcon)}
50
+ />
51
+ </div>
52
+
53
+ <input
54
+ ref={inputRef}
55
+ checked={checked}
56
+ type="checkbox"
57
+ className={styles.toggleScreenReader}
58
+ aria-label={translate(
59
+ {
60
+ message: 'Switch between dark and light mode (currently {mode})',
61
+ id: 'theme.colorToggle.ariaLabel',
62
+ description: 'The ARIA label for the navbar color mode toggle',
63
+ },
64
+ {
65
+ mode: checked
66
+ ? translate({
67
+ message: 'dark mode',
68
+ id: 'theme.colorToggle.ariaLabel.mode.dark',
69
+ description: 'The name for the dark color mode',
70
+ })
71
+ : translate({
72
+ message: 'light mode',
73
+ id: 'theme.colorToggle.ariaLabel.mode.light',
74
+ description: 'The name for the light color mode',
75
+ }),
76
+ },
77
+ )}
78
+ onChange={onChange}
79
+ onClick={() => setChecked(!checked)}
80
+ onFocus={() => setFocused(true)}
81
+ onBlur={() => setFocused(false)}
82
+ onKeyDown={(e) => {
83
+ if (e.key === 'Enter') {
84
+ inputRef.current?.click();
85
+ }
86
+ }}
87
+ />
88
+ </div>
89
+ );
90
+ }
91
+
92
+ export default React.memo(ColorModeToggle);
@@ -0,0 +1,51 @@
1
+ /**
2
+ * Copyright (c) Facebook, Inc. and its affiliates.
3
+ *
4
+ * This source code is licensed under the MIT license found in the
5
+ * LICENSE file in the root directory of this source tree.
6
+ */
7
+
8
+ .toggle {
9
+ position: relative;
10
+ width: 32px;
11
+ height: 32px;
12
+ }
13
+
14
+ .toggleScreenReader {
15
+ border: 0;
16
+ clip: rect(0 0 0 0);
17
+ height: 1px;
18
+ margin: -1px;
19
+ overflow: hidden;
20
+ position: absolute;
21
+ width: 1px;
22
+ }
23
+
24
+ .toggleDisabled {
25
+ cursor: not-allowed;
26
+ }
27
+
28
+ .toggleButton {
29
+ cursor: pointer;
30
+ user-select: none;
31
+ -webkit-tap-highlight-color: transparent;
32
+ align-items: center;
33
+ display: flex;
34
+ justify-content: center;
35
+ width: 100%;
36
+ height: 100%;
37
+ border-radius: 50%;
38
+ }
39
+
40
+ .toggleButton:hover {
41
+ background-color: #00000010;
42
+ }
43
+
44
+ [data-theme='dark'] .toggleButton:hover {
45
+ background-color: #ffffff20;
46
+ }
47
+
48
+ [data-theme='light'] .darkToggleIcon,
49
+ [data-theme='dark'] .lightToggleIcon {
50
+ display: none;
51
+ }
@@ -0,0 +1,20 @@
1
+ /**
2
+ * Copyright (c) Facebook, Inc. and its affiliates.
3
+ *
4
+ * This source code is licensed under the MIT license found in the
5
+ * LICENSE file in the root directory of this source tree.
6
+ */
7
+
8
+ import React from 'react';
9
+ import type {Props} from '@theme/IconDarkMode';
10
+
11
+ export default function IconDarkMode(props: Props): JSX.Element {
12
+ return (
13
+ <svg viewBox="0 0 24 24" width={24} height={24} {...props}>
14
+ <path
15
+ fill="currentColor"
16
+ d="M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27C17.45,17.19,14.93,19,12,19 c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51z M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36 c-0.98,1.37-2.58,2.26-4.4,2.26c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"
17
+ />
18
+ </svg>
19
+ );
20
+ }
@@ -15,14 +15,14 @@ export default function IconLanguage({
15
15
  }: Props): JSX.Element {
16
16
  return (
17
17
  <svg
18
- viewBox="0 0 20 20"
18
+ viewBox="0 0 24 24"
19
19
  width={width}
20
20
  height={height}
21
- aria-hidden="true"
21
+ aria-hidden
22
22
  {...props}>
23
23
  <path
24
24
  fill="currentColor"
25
- d="M19.753 10.909c-.624-1.707-2.366-2.726-4.661-2.726-.09 0-.176.002-.262.006l-.016-2.063 3.525-.607c.115-.019.133-.119.109-.231-.023-.111-.167-.883-.188-.976-.027-.131-.102-.127-.207-.109-.104.018-3.25.461-3.25.461l-.013-2.078c-.001-.125-.069-.158-.194-.156l-1.025.016c-.105.002-.164.049-.162.148l.033 2.307s-3.061.527-3.144.543c-.084.014-.17.053-.151.143.019.09.19 1.094.208 1.172.018.08.072.129.188.107l2.924-.504.035 2.018c-1.077.281-1.801.824-2.256 1.303-.768.807-1.207 1.887-1.207 2.963 0 1.586.971 2.529 2.328 2.695 3.162.387 5.119-3.06 5.769-4.715 1.097 1.506.256 4.354-2.094 5.98-.043.029-.098.129-.033.207l.619.756c.08.096.206.059.256.023 2.51-1.73 3.661-4.515 2.869-6.683zm-7.386 3.188c-.966-.121-.944-.914-.944-1.453 0-.773.327-1.58.876-2.156a3.21 3.21 0 011.229-.799l.082 4.277a2.773 2.773 0 01-1.243.131zm2.427-.553l.046-4.109c.084-.004.166-.01.252-.01.773 0 1.494.145 1.885.361.391.217-1.023 2.713-2.183 3.758zm-8.95-7.668a.196.196 0 00-.196-.145h-1.95a.194.194 0 00-.194.144L.008 16.916c-.017.051-.011.076.062.076h1.733c.075 0 .099-.023.114-.072l1.008-3.318h3.496l1.008 3.318c.016.049.039.072.113.072h1.734c.072 0 .078-.025.062-.076-.014-.05-3.083-9.741-3.494-11.04zm-2.618 6.318l1.447-5.25 1.447 5.25H3.226z"
25
+ d="M12.87 15.07l-2.54-2.51.03-.03c1.74-1.94 2.98-4.17 3.71-6.53H17V4h-7V2H8v2H1v1.99h11.17C11.5 7.92 10.44 9.75 9 11.35 8.07 10.32 7.3 9.19 6.69 8h-2c.73 1.63 1.73 3.17 2.98 4.56l-5.09 5.02L4 19l5-5 3.11 3.11.76-2.04zM18.5 10h-2L12 22h2l1.12-3h4.75L21 22h2l-4.5-12zm-2.62 7l1.62-4.33L19.12 17h-3.24z"
26
26
  />
27
27
  </svg>
28
28
  );
@@ -0,0 +1,20 @@
1
+ /**
2
+ * Copyright (c) Facebook, Inc. and its affiliates.
3
+ *
4
+ * This source code is licensed under the MIT license found in the
5
+ * LICENSE file in the root directory of this source tree.
6
+ */
7
+
8
+ import React from 'react';
9
+ import type {Props} from '@theme/IconLightMode';
10
+
11
+ export default function IconLightMode(props: Props): JSX.Element {
12
+ return (
13
+ <svg viewBox="0 0 24 24" width={24} height={24} {...props}>
14
+ <path
15
+ fill="currentColor"
16
+ d="M12,9c1.65,0,3,1.35,3,3s-1.35,3-3,3s-3-1.35-3-3S10.35,9,12,9 M12,7c-2.76,0-5,2.24-5,5s2.24,5,5,5s5-2.24,5-5 S14.76,7,12,7L12,7z M2,13l2,0c0.55,0,1-0.45,1-1s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S1.45,13,2,13z M20,13l2,0c0.55,0,1-0.45,1-1 s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S19.45,13,20,13z M11,2v2c0,0.55,0.45,1,1,1s1-0.45,1-1V2c0-0.55-0.45-1-1-1S11,1.45,11,2z M11,20v2c0,0.55,0.45,1,1,1s1-0.45,1-1v-2c0-0.55-0.45-1-1-1C11.45,19,11,19.45,11,20z M5.99,4.58c-0.39-0.39-1.03-0.39-1.41,0 c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0s0.39-1.03,0-1.41L5.99,4.58z M18.36,16.95 c-0.39-0.39-1.03-0.39-1.41,0c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0c0.39-0.39,0.39-1.03,0-1.41 L18.36,16.95z M19.42,5.99c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06c-0.39,0.39-0.39,1.03,0,1.41 s1.03,0.39,1.41,0L19.42,5.99z M7.05,18.36c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06 c-0.39,0.39-0.39,1.03,0,1.41s1.03,0.39,1.41,0L7.05,18.36z"
17
+ />
18
+ </svg>
19
+ );
20
+ }
@@ -37,8 +37,22 @@ const MDXComponents: MDXComponentsObject = {
37
37
  return <Head {...props}>{unwrappedChildren}</Head>;
38
38
  },
39
39
  code: (props) => {
40
+ const inlineElements = [
41
+ 'a',
42
+ 'b',
43
+ 'big',
44
+ 'i',
45
+ 'span',
46
+ 'em',
47
+ 'strong',
48
+ 'sup',
49
+ 'sub',
50
+ 'small',
51
+ ];
40
52
  const shouldBeInline = React.Children.toArray(props.children).every(
41
- (el) => typeof el === 'string' && !el.includes('\n'),
53
+ (el) =>
54
+ (typeof el === 'string' && !el.includes('\n')) ||
55
+ (React.isValidElement(el) && inlineElements.includes(el.props.mdxType)),
42
56
  );
43
57
 
44
58
  return shouldBeInline ? <code {...props} /> : <CodeBlock {...props} />;
@@ -9,7 +9,7 @@ import React, {useCallback, useState, useEffect} from 'react';
9
9
  import clsx from 'clsx';
10
10
  import Translate from '@docusaurus/Translate';
11
11
  import SearchBar from '@theme/SearchBar';
12
- import Toggle from '@theme/Toggle';
12
+ import ColorModeToggle from '@theme/ColorModeToggle';
13
13
  import {
14
14
  useThemeConfig,
15
15
  useMobileSecondaryMenuRenderer,
@@ -171,7 +171,7 @@ function NavbarMobileSidebar({
171
171
  titleClassName="navbar__title"
172
172
  />
173
173
  {!colorModeToggle.disabled && (
174
- <Toggle
174
+ <ColorModeToggle
175
175
  className={styles.navbarSidebarToggle}
176
176
  checked={colorModeToggle.isDarkTheme}
177
177
  onChange={colorModeToggle.toggle}
@@ -271,7 +271,7 @@ export default function Navbar(): JSX.Element {
271
271
  <NavbarItem {...item} key={i} />
272
272
  ))}
273
273
  {!colorModeToggle.disabled && (
274
- <Toggle
274
+ <ColorModeToggle
275
275
  className={styles.toggle}
276
276
  checked={colorModeToggle.isDarkTheme}
277
277
  onChange={colorModeToggle.toggle}
@@ -26,6 +26,15 @@ export default function SearchMetadata({
26
26
 
27
27
  return (
28
28
  <Head>
29
+ {/*
30
+ Docusaurus metadata, used by third-party search plugin
31
+ See https://github.com/cmfcmf/docusaurus-search-local/issues/99
32
+ */}
33
+ {locale && <meta name="docusaurus_locale" content={locale} />}
34
+ {version && <meta name="docusaurus_version" content={version} />}
35
+ {tag && <meta name="docusaurus_tag" content={tag} />}
36
+
37
+ {/* Algolia DocSearch metadata */}
29
38
  {language && <meta name="docsearch:language" content={language} />}
30
39
  {version && <meta name="docsearch:version" content={version} />}
31
40
  {tag && <meta name="docsearch:docusaurus_tag" content={tag} />}
@@ -632,7 +632,7 @@ declare module '@theme/TOCCollapsible' {
632
632
  export default function TOCCollapsible(props: Props): JSX.Element;
633
633
  }
634
634
 
635
- declare module '@theme/Toggle' {
635
+ declare module '@theme/ColorModeToggle' {
636
636
  import type {SyntheticEvent} from 'react';
637
637
 
638
638
  export interface Props {
@@ -663,6 +663,14 @@ declare module '@theme/IconArrow' {
663
663
  export default function IconArrow(props: Props): JSX.Element;
664
664
  }
665
665
 
666
+ declare module '@theme/IconDarkMode' {
667
+ import type {ComponentProps} from 'react';
668
+
669
+ export interface Props extends ComponentProps<'svg'> {}
670
+
671
+ export default function IconDarkMode(props: Props): JSX.Element;
672
+ }
673
+
666
674
  declare module '@theme/IconEdit' {
667
675
  import type {ComponentProps} from 'react';
668
676
 
@@ -671,6 +679,14 @@ declare module '@theme/IconEdit' {
671
679
  export default function IconEdit(props: Props): JSX.Element;
672
680
  }
673
681
 
682
+ declare module '@theme/IconLightMode' {
683
+ import type {ComponentProps} from 'react';
684
+
685
+ export interface Props extends ComponentProps<'svg'> {}
686
+
687
+ export default function IconLightMode(props: Props): JSX.Element;
688
+ }
689
+
674
690
  declare module '@theme/IconMenu' {
675
691
  import type {ComponentProps} from 'react';
676
692
 
@@ -21,12 +21,6 @@ const DEFAULT_COLOR_MODE_CONFIG = {
21
21
  defaultMode: 'light',
22
22
  disableSwitch: false,
23
23
  respectPrefersColorScheme: false,
24
- switchConfig: {
25
- darkIcon: '🌜',
26
- darkIconStyle: {},
27
- lightIcon: '🌞',
28
- lightIconStyle: {},
29
- },
30
24
  };
31
25
 
32
26
  export const DEFAULT_CONFIG = {
@@ -220,20 +214,10 @@ const ColorModeSchema = Joi.object({
220
214
  respectPrefersColorScheme: Joi.bool().default(
221
215
  DEFAULT_COLOR_MODE_CONFIG.respectPrefersColorScheme,
222
216
  ),
223
- switchConfig: Joi.object({
224
- darkIcon: Joi.string().default(
225
- DEFAULT_COLOR_MODE_CONFIG.switchConfig.darkIcon,
226
- ),
227
- darkIconStyle: Joi.object().default(
228
- DEFAULT_COLOR_MODE_CONFIG.switchConfig.darkIconStyle,
229
- ),
230
- lightIcon: Joi.string().default(
231
- DEFAULT_COLOR_MODE_CONFIG.switchConfig.lightIcon,
232
- ),
233
- lightIconStyle: Joi.object().default(
234
- DEFAULT_COLOR_MODE_CONFIG.switchConfig.lightIconStyle,
235
- ),
236
- }).default(DEFAULT_COLOR_MODE_CONFIG.switchConfig),
217
+ switchConfig: Joi.any().forbidden().messages({
218
+ 'any.unknown':
219
+ 'colorMode.switchConfig is deprecated. If you want to customize the icons for light and dark mode, swizzle IconLightMode, IconDarkMode, or ColorModeToggle instead.',
220
+ }),
237
221
  }).default(DEFAULT_COLOR_MODE_CONFIG);
238
222
 
239
223
  // schema can probably be improved
@@ -1,100 +0,0 @@
1
- /**
2
- * Copyright (c) Facebook, Inc. and its affiliates.
3
- *
4
- * This source code is licensed under the MIT license found in the
5
- * LICENSE file in the root directory of this source tree.
6
- */
7
- import React, {useState, useRef, useEffect, memo} from 'react';
8
- import {useThemeConfig} from '@docusaurus/theme-common';
9
- import useIsBrowser from '@docusaurus/useIsBrowser';
10
- import {translate} from '@docusaurus/Translate';
11
- import clsx from 'clsx';
12
- import styles from './styles.module.css'; // Based on react-toggle (https://github.com/aaronshaf/react-toggle/).
13
-
14
- const ToggleComponent = memo(
15
- ({className, switchConfig, checked: defaultChecked, disabled, onChange}) => {
16
- const {darkIcon, darkIconStyle, lightIcon, lightIconStyle} = switchConfig;
17
- const [checked, setChecked] = useState(defaultChecked);
18
- const [focused, setFocused] = useState(false);
19
- const inputRef = useRef(null);
20
- useEffect(() => {
21
- setChecked(defaultChecked);
22
- }, [defaultChecked]);
23
- return (
24
- <div
25
- className={clsx(styles.toggle, className, {
26
- [styles.toggleChecked]: checked,
27
- [styles.toggleFocused]: focused,
28
- [styles.toggleDisabled]: disabled,
29
- })}>
30
- {/* eslint-disable-next-line jsx-a11y/click-events-have-key-events */}
31
- <div
32
- className={styles.toggleTrack}
33
- role="button"
34
- tabIndex={-1}
35
- onClick={() => inputRef.current?.click()}>
36
- <div className={styles.toggleTrackCheck}>
37
- <span className={styles.toggleIcon} style={darkIconStyle}>
38
- {darkIcon}
39
- </span>
40
- </div>
41
- <div className={styles.toggleTrackX}>
42
- <span className={styles.toggleIcon} style={lightIconStyle}>
43
- {lightIcon}
44
- </span>
45
- </div>
46
- <div className={styles.toggleTrackThumb} />
47
- </div>
48
-
49
- <input
50
- ref={inputRef}
51
- checked={checked}
52
- type="checkbox"
53
- className={styles.toggleScreenReader}
54
- aria-label={translate(
55
- {
56
- message: 'Switch between dark and light mode (currently {mode})',
57
- id: 'theme.colorToggle.ariaLabel',
58
- description: 'The ARIA label for the navbar color mode toggle',
59
- },
60
- {
61
- mode: checked
62
- ? translate({
63
- message: 'dark mode',
64
- id: 'theme.colorToggle.ariaLabel.mode.dark',
65
- description: 'The name for the dark color mode',
66
- })
67
- : translate({
68
- message: 'light mode',
69
- id: 'theme.colorToggle.ariaLabel.mode.light',
70
- description: 'The name for the light color mode',
71
- }),
72
- },
73
- )}
74
- onChange={onChange}
75
- onClick={() => setChecked(!checked)}
76
- onFocus={() => setFocused(true)}
77
- onBlur={() => setFocused(false)}
78
- onKeyDown={(e) => {
79
- if (e.key === 'Enter') {
80
- inputRef.current?.click();
81
- }
82
- }}
83
- />
84
- </div>
85
- );
86
- },
87
- );
88
- export default function Toggle(props) {
89
- const {
90
- colorMode: {switchConfig},
91
- } = useThemeConfig();
92
- const isBrowser = useIsBrowser();
93
- return (
94
- <ToggleComponent
95
- switchConfig={switchConfig}
96
- disabled={!isBrowser}
97
- {...props}
98
- />
99
- );
100
- }