@vuepress/theme-default 2.0.0-rc.8 → 2.0.0-rc.81
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.
- package/lib/client/components/VPAutoLink.vue +32 -0
- package/lib/client/components/VPDarkIcon.vue +8 -0
- package/lib/client/components/VPDropdownTransition.vue +43 -0
- package/lib/client/components/VPEditIcon.vue +12 -0
- package/lib/client/components/VPFadeSlideYTransition.vue +43 -0
- package/lib/client/components/VPHome.vue +37 -0
- package/lib/client/components/VPHomeFeatures.vue +65 -0
- package/lib/client/components/{HomeFooter.vue → VPHomeFooter.vue} +16 -3
- package/lib/client/components/VPHomeHero.vue +185 -0
- package/lib/client/components/VPLightIcon.vue +28 -0
- package/lib/client/components/VPNavbar.vue +134 -0
- package/lib/client/components/{NavbarBrand.vue → VPNavbarBrand.vue} +41 -16
- package/lib/client/components/VPNavbarDropdown.vue +328 -0
- package/lib/client/components/VPNavbarItems.vue +111 -0
- package/lib/client/components/VPPage.vue +69 -0
- package/lib/client/components/VPPageMeta.vue +133 -0
- package/lib/client/components/VPPageNav.vue +123 -0
- package/lib/client/components/VPSidebar.vue +120 -0
- package/lib/client/components/VPSidebarItem.vue +189 -0
- package/lib/client/components/{SidebarItems.vue → VPSidebarItems.vue} +27 -7
- package/lib/client/components/VPToggleColorModeButton.vue +55 -0
- package/lib/client/components/VPToggleSidebarButton.vue +92 -0
- package/lib/client/components/global/Badge.vue +84 -18
- package/lib/client/components/global/index.d.ts +1 -3
- package/lib/client/components/global/index.js +1 -3
- package/lib/client/composables/index.d.ts +9 -1
- package/lib/client/composables/index.js +9 -1
- package/lib/client/composables/useContributors.d.ts +3 -0
- package/lib/client/composables/useContributors.js +11 -0
- package/lib/client/composables/useDarkMode.d.ts +0 -1
- package/lib/client/composables/useDarkMode.js +19 -16
- package/lib/client/composables/useData.d.ts +13 -0
- package/lib/client/composables/useData.js +15 -0
- package/lib/client/composables/useEditLink.d.ts +3 -0
- package/lib/client/composables/useEditLink.js +28 -0
- package/lib/client/composables/useHeaders.d.ts +9 -0
- package/lib/client/composables/useHeaders.js +38 -0
- package/lib/client/composables/useLastUpdated.d.ts +2 -0
- package/lib/client/composables/useLastUpdated.js +14 -0
- package/lib/client/composables/useNavbarConfig.d.ts +3 -0
- package/lib/client/composables/useNavbarConfig.js +29 -0
- package/lib/client/composables/useNavbarRepo.d.ts +6 -0
- package/lib/client/composables/useNavbarRepo.js +38 -0
- package/lib/client/composables/useNavbarSelectLanguage.d.ts +6 -0
- package/lib/client/composables/useNavbarSelectLanguage.js +55 -0
- package/lib/client/composables/useNavigate.d.ts +1 -0
- package/lib/client/composables/useNavigate.js +22 -0
- package/lib/client/composables/useRelatedLinks.d.ts +8 -0
- package/lib/client/composables/useRelatedLinks.js +90 -0
- package/lib/client/composables/useScrollPromise.js +3 -1
- package/lib/client/composables/useSidebarItems.d.ts +21 -21
- package/lib/client/composables/useSidebarItems.js +96 -86
- package/lib/client/composables/useUpdateDeviceStatus.d.ts +1 -1
- package/lib/client/composables/useUpdateDeviceStatus.js +10 -5
- package/lib/client/config.d.ts +3 -2
- package/lib/client/config.js +8 -23
- package/lib/client/index.d.ts +2 -1
- package/lib/client/index.js +0 -1
- package/lib/client/layouts/Layout.vue +127 -54
- package/lib/client/layouts/NotFound.vue +25 -11
- package/lib/client/shim.d.ts +6 -5
- package/lib/client/styles/_mixins.scss +4 -4
- package/lib/client/styles/_variables.module.scss +1 -1
- package/lib/client/styles/_variables.scss +2 -1
- package/lib/client/styles/arrow.scss +24 -22
- package/lib/client/styles/code-group.scss +34 -30
- package/lib/client/styles/content/code.scss +23 -0
- package/lib/client/styles/content/index.scss +3 -0
- package/lib/client/styles/content/normalize.scss +39 -0
- package/lib/client/styles/{toc.scss → content/toc.scss} +1 -1
- package/lib/client/styles/external-link-icon.scss +36 -0
- package/lib/client/styles/index.scss +3 -13
- package/lib/client/styles/layout.scss +5 -197
- package/lib/client/styles/normalize.scss +1 -194
- package/lib/client/styles/plugins.scss +28 -0
- package/lib/client/styles/vars-dark.scss +20 -58
- package/lib/client/styles/vars.scss +54 -129
- package/lib/client/typings.d.ts +13 -0
- package/lib/client/typings.js +1 -0
- package/lib/client/utils/index.d.ts +2 -2
- package/lib/client/utils/index.js +2 -2
- package/lib/client/utils/isActiveSidebarItem.d.ts +3 -3
- package/lib/client/utils/isActiveSidebarItem.js +1 -1
- package/lib/client/utils/resolveAutoLink.d.ts +9 -0
- package/lib/client/utils/resolveAutoLink.js +17 -0
- package/lib/client/utils/resolveEditLink.d.ts +3 -3
- package/lib/client/utils/resolveEditLink.js +3 -3
- package/lib/client/utils/resolvePrefix.d.ts +1 -0
- package/lib/client/utils/resolvePrefix.js +4 -0
- package/lib/client/utils/resolveRepoType.d.ts +1 -1
- package/lib/client/utils/resolveRepoType.js +4 -4
- package/lib/node/defaultTheme.d.ts +2 -1
- package/lib/node/defaultTheme.js +52 -57
- package/lib/node/index.d.ts +2 -3
- package/lib/node/index.js +0 -3
- package/lib/node/typings.d.ts +59 -0
- package/lib/node/typings.js +1 -0
- package/lib/node/utils/assignDefaultLocaleOptions.js +3 -7
- package/lib/node/utils/index.d.ts +1 -1
- package/lib/node/utils/index.js +1 -1
- package/lib/node/utils/resolveMarkdownHintLocales.d.ts +9 -0
- package/lib/node/utils/resolveMarkdownHintLocales.js +19 -0
- package/lib/shared/index.d.ts +5 -3
- package/lib/shared/index.js +1 -3
- package/lib/shared/nav.d.ts +19 -30
- package/lib/shared/navbar.d.ts +21 -0
- package/lib/shared/navbar.js +1 -0
- package/lib/shared/options.d.ts +36 -65
- package/lib/shared/page.d.ts +9 -6
- package/lib/shared/sidebar.d.ts +26 -0
- package/lib/shared/sidebar.js +1 -0
- package/package.json +29 -27
- package/templates/build.html +16 -10
- package/lib/client/components/AutoLink.vue +0 -113
- package/lib/client/components/DropdownTransition.vue +0 -25
- package/lib/client/components/Home.vue +0 -15
- package/lib/client/components/HomeContent.vue +0 -5
- package/lib/client/components/HomeFeatures.vue +0 -22
- package/lib/client/components/HomeHero.vue +0 -97
- package/lib/client/components/Navbar.vue +0 -79
- package/lib/client/components/NavbarDropdown.vue +0 -126
- package/lib/client/components/NavbarItems.vue +0 -199
- package/lib/client/components/Page.vue +0 -31
- package/lib/client/components/PageMeta.vue +0 -124
- package/lib/client/components/PageNav.vue +0 -122
- package/lib/client/components/Sidebar.vue +0 -18
- package/lib/client/components/SidebarItem.vue +0 -87
- package/lib/client/components/ToggleColorModeButton.vue +0 -57
- package/lib/client/components/ToggleSidebarButton.vue +0 -24
- package/lib/client/components/global/CodeGroup.d.ts +0 -6
- package/lib/client/components/global/CodeGroup.js +0 -120
- package/lib/client/components/global/CodeGroupItem.vue +0 -27
- package/lib/client/composables/useThemeData.d.ts +0 -4
- package/lib/client/composables/useThemeData.js +0 -3
- package/lib/client/styles/badge.scss +0 -36
- package/lib/client/styles/code.scss +0 -263
- package/lib/client/styles/custom-container.scss +0 -142
- package/lib/client/styles/home.scss +0 -168
- package/lib/client/styles/navbar-dropdown.scss +0 -183
- package/lib/client/styles/navbar.scss +0 -197
- package/lib/client/styles/page.scss +0 -87
- package/lib/client/styles/sidebar.scss +0 -134
- package/lib/client/styles/transitions.scss +0 -22
- package/lib/client/utils/getNavLink.d.ts +0 -15
- package/lib/client/utils/getNavLink.js +0 -18
- package/lib/client/utils/getResolveRouteWithRedirect.d.ts +0 -5
- package/lib/client/utils/getResolveRouteWithRedirect.js +0 -22
- package/lib/node/utils/resolveContainerPluginOptions.d.ts +0 -8
- package/lib/node/utils/resolveContainerPluginOptions.js +0 -17
|
@@ -1,37 +1,37 @@
|
|
|
1
1
|
import type { ComputedRef, InjectionKey } from 'vue';
|
|
2
|
-
import type { Router } from 'vue-router';
|
|
3
2
|
import type { PageData, PageHeader } from 'vuepress/client';
|
|
4
|
-
import type {
|
|
5
|
-
|
|
6
|
-
export declare const sidebarItemsSymbol: InjectionKey<SidebarItemsRef>;
|
|
3
|
+
import type { SidebarArrayOptions, SidebarObjectOptions, SidebarOptions } from '../../shared/index.js';
|
|
4
|
+
import type { SidebarHeaderItem, SidebarItem } from '../typings.js';
|
|
7
5
|
/**
|
|
8
|
-
*
|
|
6
|
+
* Util to transform page header to sidebar item
|
|
9
7
|
*/
|
|
10
|
-
export declare const
|
|
8
|
+
export declare const resolveSidebarPageHeader: (header: PageHeader) => SidebarHeaderItem;
|
|
9
|
+
export declare const resolveSidebarPageHeaders: (headers?: PageHeader[]) => SidebarHeaderItem[];
|
|
11
10
|
/**
|
|
12
|
-
*
|
|
11
|
+
* Resolve current page and its header to sidebar items if the config is `heading`
|
|
13
12
|
*/
|
|
14
|
-
export declare const
|
|
13
|
+
export declare const resolveSidebarHeadingItem: (page: PageData, headers: PageHeader[]) => SidebarItem[];
|
|
15
14
|
/**
|
|
16
|
-
* Resolve sidebar items
|
|
17
|
-
*
|
|
18
|
-
* It should only be resolved and provided once
|
|
15
|
+
* Resolve sidebar items if the config is an array
|
|
19
16
|
*/
|
|
20
|
-
export declare const
|
|
17
|
+
export declare const resolveArraySidebarItems: (sidebarConfig: SidebarArrayOptions, headers: PageHeader[], path: string, prefix?: string) => SidebarItem[];
|
|
21
18
|
/**
|
|
22
|
-
*
|
|
19
|
+
* Resolve sidebar items if the config is a key -> value (path-prefix -> array) object
|
|
23
20
|
*/
|
|
24
|
-
export declare const
|
|
25
|
-
export
|
|
21
|
+
export declare const resolveMultiSidebarItems: (sidebarConfig: SidebarObjectOptions, page: PageData, headers: PageHeader[], path: string) => SidebarItem[];
|
|
22
|
+
export type SidebarItemsRef = ComputedRef<SidebarItem[]>;
|
|
23
|
+
export declare const sidebarItemsSymbol: InjectionKey<SidebarItemsRef>;
|
|
26
24
|
/**
|
|
27
|
-
*
|
|
25
|
+
* Inject sidebar items global computed
|
|
28
26
|
*/
|
|
29
|
-
export declare const
|
|
27
|
+
export declare const useSidebarItems: () => SidebarItemsRef;
|
|
30
28
|
/**
|
|
31
|
-
* Resolve sidebar items
|
|
29
|
+
* Resolve sidebar items global computed
|
|
30
|
+
*
|
|
31
|
+
* It should only be resolved and provided once
|
|
32
32
|
*/
|
|
33
|
-
export declare const
|
|
33
|
+
export declare const resolveSidebarItems: (sidebarConfig: SidebarOptions | false, page: PageData, path: string, routeLocale: string, headers: PageHeader[]) => SidebarItem[];
|
|
34
34
|
/**
|
|
35
|
-
*
|
|
35
|
+
* Create sidebar items ref and provide as global computed in setup
|
|
36
36
|
*/
|
|
37
|
-
export declare const
|
|
37
|
+
export declare const setupSidebarItems: () => void;
|
|
@@ -1,118 +1,128 @@
|
|
|
1
|
+
import { resolveAutoLink } from '@theme/resolveAutoLink';
|
|
2
|
+
import { resolvePrefix } from '@theme/resolvePrefix';
|
|
3
|
+
import { useData } from '@theme/useData';
|
|
4
|
+
import { useHeaders } from '@theme/useHeaders';
|
|
5
|
+
import { isLinkRelative, keys, startsWith } from '@vuepress/helper/client';
|
|
1
6
|
import { computed, inject, provide } from 'vue';
|
|
2
|
-
import {
|
|
3
|
-
import {
|
|
4
|
-
import { isPlainObject, isString, resolveLocalePath } from 'vuepress/shared';
|
|
5
|
-
import { getNavLink } from '../utils/index.js';
|
|
6
|
-
import { useThemeLocaleData } from './useThemeData.js';
|
|
7
|
-
export const sidebarItemsSymbol = Symbol('sidebarItems');
|
|
8
|
-
/**
|
|
9
|
-
* Inject sidebar items global computed
|
|
10
|
-
*/
|
|
11
|
-
export const useSidebarItems = () => {
|
|
12
|
-
const sidebarItems = inject(sidebarItemsSymbol);
|
|
13
|
-
if (!sidebarItems) {
|
|
14
|
-
throw new Error('useSidebarItems() is called without provider.');
|
|
15
|
-
}
|
|
16
|
-
return sidebarItems;
|
|
17
|
-
};
|
|
18
|
-
/**
|
|
19
|
-
* Create sidebar items ref and provide as global computed in setup
|
|
20
|
-
*/
|
|
21
|
-
export const setupSidebarItems = () => {
|
|
22
|
-
const themeLocale = useThemeLocaleData();
|
|
23
|
-
const frontmatter = usePageFrontmatter();
|
|
24
|
-
const page = usePageData();
|
|
25
|
-
const route = useRoute();
|
|
26
|
-
const router = useRouter();
|
|
27
|
-
const sidebarItems = computed(() => resolveSidebarItems(frontmatter.value, themeLocale.value, page.value, router, route.path));
|
|
28
|
-
provide(sidebarItemsSymbol, sidebarItems);
|
|
29
|
-
};
|
|
30
|
-
/**
|
|
31
|
-
* Resolve sidebar items global computed
|
|
32
|
-
*
|
|
33
|
-
* It should only be resolved and provided once
|
|
34
|
-
*/
|
|
35
|
-
export const resolveSidebarItems = (frontmatter, themeLocale, page, router, path) => {
|
|
36
|
-
// get sidebar config from frontmatter > theme data
|
|
37
|
-
const sidebarConfig = frontmatter.sidebar ?? themeLocale.sidebar ?? 'auto';
|
|
38
|
-
const sidebarDepth = frontmatter.sidebarDepth ?? themeLocale.sidebarDepth ?? 2;
|
|
39
|
-
// resolve sidebar items according to the config
|
|
40
|
-
if (frontmatter.home || sidebarConfig === false) {
|
|
41
|
-
return [];
|
|
42
|
-
}
|
|
43
|
-
if (sidebarConfig === 'auto') {
|
|
44
|
-
return resolveAutoSidebarItems(page, sidebarDepth);
|
|
45
|
-
}
|
|
46
|
-
if (Array.isArray(sidebarConfig)) {
|
|
47
|
-
return resolveArraySidebarItems(page, router, path, sidebarConfig, sidebarDepth);
|
|
48
|
-
}
|
|
49
|
-
if (isPlainObject(sidebarConfig)) {
|
|
50
|
-
return resolveMultiSidebarItems(page, router, path, sidebarConfig, sidebarDepth);
|
|
51
|
-
}
|
|
52
|
-
return [];
|
|
53
|
-
};
|
|
7
|
+
import { useRoutePath } from 'vuepress/client';
|
|
8
|
+
import { isPlainObject, isString } from 'vuepress/shared';
|
|
54
9
|
/**
|
|
55
10
|
* Util to transform page header to sidebar item
|
|
56
11
|
*/
|
|
57
|
-
export const
|
|
12
|
+
export const resolveSidebarPageHeader = (header) => ({
|
|
58
13
|
text: header.title,
|
|
59
14
|
link: header.link,
|
|
60
|
-
|
|
15
|
+
// eslint-disable-next-line @typescript-eslint/no-use-before-define
|
|
16
|
+
children: resolveSidebarPageHeaders(header.children),
|
|
61
17
|
});
|
|
62
|
-
export const
|
|
63
|
-
? headers.map((header) => headerToSidebarItem(header, sidebarDepth - 1))
|
|
64
|
-
: [];
|
|
18
|
+
export const resolveSidebarPageHeaders = (headers) => headers ? headers.map((header) => resolveSidebarPageHeader(header)) : [];
|
|
65
19
|
/**
|
|
66
|
-
* Resolve sidebar items if the config is `
|
|
20
|
+
* Resolve current page and its header to sidebar items if the config is `heading`
|
|
67
21
|
*/
|
|
68
|
-
export const
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
];
|
|
75
|
-
};
|
|
22
|
+
export const resolveSidebarHeadingItem = (page, headers) => [
|
|
23
|
+
{
|
|
24
|
+
text: page.title,
|
|
25
|
+
children: resolveSidebarPageHeaders(headers),
|
|
26
|
+
},
|
|
27
|
+
];
|
|
76
28
|
/**
|
|
77
29
|
* Resolve sidebar items if the config is an array
|
|
78
30
|
*/
|
|
79
|
-
export const resolveArraySidebarItems = (
|
|
80
|
-
const handleChildItem = (item) => {
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
31
|
+
export const resolveArraySidebarItems = (sidebarConfig, headers, path, prefix = '') => {
|
|
32
|
+
const handleChildItem = (item, pathPrefix) => {
|
|
33
|
+
const childItem = isString(item)
|
|
34
|
+
? resolveAutoLink(resolvePrefix(pathPrefix, item))
|
|
35
|
+
: isString(item.link)
|
|
36
|
+
? {
|
|
37
|
+
...item,
|
|
38
|
+
link: isLinkRelative(item.link)
|
|
39
|
+
? resolveAutoLink(resolvePrefix(pathPrefix, item.link)).link
|
|
40
|
+
: item.link,
|
|
41
|
+
}
|
|
42
|
+
: item;
|
|
43
|
+
if ('children' in childItem) {
|
|
89
44
|
return {
|
|
90
45
|
...childItem,
|
|
91
|
-
children: childItem.children.map((
|
|
46
|
+
children: childItem.children.map((child) => handleChildItem(child, resolvePrefix(pathPrefix, childItem.prefix))),
|
|
92
47
|
};
|
|
93
48
|
}
|
|
94
49
|
// if the sidebar item is current page and children is not set
|
|
95
50
|
// use headers of current page as children
|
|
96
51
|
if (childItem.link === path) {
|
|
97
52
|
// skip h1 header
|
|
98
|
-
const
|
|
53
|
+
const currentHeaders = headers[0]?.level === 1 ? headers[0].children : headers;
|
|
99
54
|
return {
|
|
100
55
|
...childItem,
|
|
101
|
-
children:
|
|
56
|
+
children: resolveSidebarPageHeaders(currentHeaders),
|
|
102
57
|
};
|
|
103
58
|
}
|
|
104
59
|
return childItem;
|
|
105
60
|
};
|
|
106
|
-
return sidebarConfig.map((item) => handleChildItem(item));
|
|
61
|
+
return sidebarConfig.map((item) => handleChildItem(item, prefix));
|
|
107
62
|
};
|
|
108
63
|
/**
|
|
109
64
|
* Resolve sidebar items if the config is a key -> value (path-prefix -> array) object
|
|
110
65
|
*/
|
|
111
|
-
export const resolveMultiSidebarItems = (page,
|
|
112
|
-
const
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
66
|
+
export const resolveMultiSidebarItems = (sidebarConfig, page, headers, path) => {
|
|
67
|
+
const sidebarRoutes = keys(sidebarConfig).sort((x, y) => y.length - x.length);
|
|
68
|
+
// Find matching config
|
|
69
|
+
for (const base of sidebarRoutes)
|
|
70
|
+
if (startsWith(decodeURI(path), base)) {
|
|
71
|
+
const matched = sidebarConfig[base];
|
|
72
|
+
return matched
|
|
73
|
+
? matched === 'heading'
|
|
74
|
+
? resolveSidebarHeadingItem(page, headers)
|
|
75
|
+
: resolveArraySidebarItems(matched, headers, path, base)
|
|
76
|
+
: [];
|
|
77
|
+
}
|
|
78
|
+
// eslint-disable-next-line no-console
|
|
79
|
+
console.warn(`${decodeURI(path)} is missing sidebar config.`);
|
|
80
|
+
return [];
|
|
81
|
+
};
|
|
82
|
+
export const sidebarItemsSymbol = Symbol('sidebarItems');
|
|
83
|
+
/**
|
|
84
|
+
* Inject sidebar items global computed
|
|
85
|
+
*/
|
|
86
|
+
export const useSidebarItems = () => {
|
|
87
|
+
const sidebarItems = inject(sidebarItemsSymbol);
|
|
88
|
+
if (!sidebarItems) {
|
|
89
|
+
throw new Error('useSidebarItems() is called without provider.');
|
|
90
|
+
}
|
|
91
|
+
return sidebarItems;
|
|
92
|
+
};
|
|
93
|
+
/**
|
|
94
|
+
* Resolve sidebar items global computed
|
|
95
|
+
*
|
|
96
|
+
* It should only be resolved and provided once
|
|
97
|
+
*/
|
|
98
|
+
export const resolveSidebarItems = (sidebarConfig, page, path, routeLocale, headers) => {
|
|
99
|
+
// resolve sidebar items according to the config
|
|
100
|
+
if (sidebarConfig === false) {
|
|
101
|
+
return [];
|
|
116
102
|
}
|
|
117
|
-
|
|
103
|
+
if (sidebarConfig === 'heading') {
|
|
104
|
+
return resolveSidebarHeadingItem(page, headers);
|
|
105
|
+
}
|
|
106
|
+
if (Array.isArray(sidebarConfig)) {
|
|
107
|
+
return resolveArraySidebarItems(sidebarConfig, headers, path, routeLocale);
|
|
108
|
+
}
|
|
109
|
+
if (isPlainObject(sidebarConfig)) {
|
|
110
|
+
return resolveMultiSidebarItems(sidebarConfig, page, headers, path);
|
|
111
|
+
}
|
|
112
|
+
return [];
|
|
113
|
+
};
|
|
114
|
+
/**
|
|
115
|
+
* Create sidebar items ref and provide as global computed in setup
|
|
116
|
+
*/
|
|
117
|
+
export const setupSidebarItems = () => {
|
|
118
|
+
const { frontmatter, page, routeLocale, themeLocale } = useData();
|
|
119
|
+
const headers = useHeaders();
|
|
120
|
+
const routePath = useRoutePath();
|
|
121
|
+
const sidebarConfig = computed(() => frontmatter.value.home
|
|
122
|
+
? false
|
|
123
|
+
: (frontmatter.value.sidebar ??
|
|
124
|
+
themeLocale.value.sidebar ??
|
|
125
|
+
'heading'));
|
|
126
|
+
const sidebarItems = computed(() => resolveSidebarItems(sidebarConfig.value, page.value, routePath.value, routeLocale.value, headers.value));
|
|
127
|
+
provide(sidebarItemsSymbol, sidebarItems);
|
|
118
128
|
};
|
|
@@ -1,11 +1,12 @@
|
|
|
1
|
+
import { useEventListener } from '@vueuse/core';
|
|
1
2
|
import { onMounted } from 'vue';
|
|
2
|
-
import
|
|
3
|
+
import cssVariables from '../styles/_variables.module.scss';
|
|
3
4
|
export var DeviceType;
|
|
4
5
|
(function (DeviceType) {
|
|
5
|
-
DeviceType["
|
|
6
|
+
DeviceType["Mobile"] = "mobile";
|
|
6
7
|
})(DeviceType || (DeviceType = {}));
|
|
7
8
|
const DeviceTypeMap = {
|
|
8
|
-
[DeviceType.
|
|
9
|
+
[DeviceType.Mobile]: Number.parseInt(cssVariables.mobile.replace('px', ''), 10),
|
|
9
10
|
};
|
|
10
11
|
/**
|
|
11
12
|
* add listener to detect screen though device type
|
|
@@ -17,9 +18,13 @@ export const useUpdateDeviceStatus = (deviceType, callback) => {
|
|
|
17
18
|
throw new Error('device width must be a integer');
|
|
18
19
|
return;
|
|
19
20
|
}
|
|
21
|
+
useEventListener('orientationchange', () => {
|
|
22
|
+
callback(width);
|
|
23
|
+
}, false);
|
|
24
|
+
useEventListener('resize', () => {
|
|
25
|
+
callback(width);
|
|
26
|
+
}, false);
|
|
20
27
|
onMounted(() => {
|
|
21
28
|
callback(width);
|
|
22
|
-
window.addEventListener('resize', () => callback(width), false);
|
|
23
|
-
window.addEventListener('orientationchange', () => callback(width), false);
|
|
24
29
|
});
|
|
25
30
|
};
|
package/lib/client/config.d.ts
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
|
-
import
|
|
1
|
+
import '@vuepress/helper/colors.css';
|
|
2
|
+
import '@vuepress/helper/normalize.css';
|
|
2
3
|
import './styles/index.scss';
|
|
3
|
-
declare const _default: ClientConfig;
|
|
4
|
+
declare const _default: import("vuepress/client").ClientConfig;
|
|
4
5
|
export default _default;
|
package/lib/client/config.js
CHANGED
|
@@ -1,35 +1,19 @@
|
|
|
1
|
+
import { setupDarkMode } from '@theme/useDarkMode';
|
|
2
|
+
import { setupHeaders } from '@theme/useHeaders';
|
|
3
|
+
import { useScrollPromise } from '@theme/useScrollPromise';
|
|
4
|
+
import { setupSidebarItems } from '@theme/useSidebarItems';
|
|
1
5
|
import { hasGlobalComponent } from '@vuepress/helper/client';
|
|
2
|
-
import { h } from 'vue';
|
|
3
6
|
import { defineClientConfig } from 'vuepress/client';
|
|
4
|
-
import { Badge
|
|
5
|
-
import { setupDarkMode, setupSidebarItems, useScrollPromise, } from './composables/index.js';
|
|
7
|
+
import { Badge } from './components/global/index.js';
|
|
6
8
|
import Layout from './layouts/Layout.vue';
|
|
7
9
|
import NotFound from './layouts/NotFound.vue';
|
|
10
|
+
import '@vuepress/helper/colors.css';
|
|
11
|
+
import '@vuepress/helper/normalize.css';
|
|
8
12
|
import './styles/index.scss';
|
|
9
13
|
export default defineClientConfig({
|
|
10
14
|
enhance({ app, router }) {
|
|
11
15
|
if (!hasGlobalComponent('Badge'))
|
|
12
16
|
app.component('Badge', Badge);
|
|
13
|
-
if (!hasGlobalComponent('CodeGroup'))
|
|
14
|
-
app.component('CodeGroup', CodeGroup);
|
|
15
|
-
if (!hasGlobalComponent('CodeGroupItem'))
|
|
16
|
-
app.component('CodeGroupItem', CodeGroupItem);
|
|
17
|
-
// compat with @vuepress/plugin-external-link-icon
|
|
18
|
-
app.component('AutoLinkExternalIcon', () => {
|
|
19
|
-
const ExternalLinkIcon = app.component('ExternalLinkIcon');
|
|
20
|
-
if (ExternalLinkIcon) {
|
|
21
|
-
return h(ExternalLinkIcon);
|
|
22
|
-
}
|
|
23
|
-
return null;
|
|
24
|
-
});
|
|
25
|
-
// compat with @vuepress/plugin-docsearch and @vuepress/plugin-search
|
|
26
|
-
app.component('NavbarSearch', () => {
|
|
27
|
-
const SearchComponent = app.component('Docsearch') || app.component('SearchBox');
|
|
28
|
-
if (SearchComponent) {
|
|
29
|
-
return h(SearchComponent);
|
|
30
|
-
}
|
|
31
|
-
return null;
|
|
32
|
-
});
|
|
33
17
|
// handle scrollBehavior with transition
|
|
34
18
|
const scrollBehavior = router.options.scrollBehavior;
|
|
35
19
|
router.options.scrollBehavior = async (...args) => {
|
|
@@ -39,6 +23,7 @@ export default defineClientConfig({
|
|
|
39
23
|
},
|
|
40
24
|
setup() {
|
|
41
25
|
setupDarkMode();
|
|
26
|
+
setupHeaders();
|
|
42
27
|
setupSidebarItems();
|
|
43
28
|
},
|
|
44
29
|
layouts: {
|
package/lib/client/index.d.ts
CHANGED
package/lib/client/index.js
CHANGED
|
@@ -1,35 +1,33 @@
|
|
|
1
1
|
<script setup lang="ts">
|
|
2
|
-
import
|
|
3
|
-
import
|
|
4
|
-
import
|
|
5
|
-
import
|
|
6
|
-
import
|
|
7
|
-
import {
|
|
8
|
-
import {
|
|
9
|
-
import
|
|
10
|
-
import {
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
useThemeLocaleData,
|
|
14
|
-
} from '../composables/index.js'
|
|
2
|
+
import VPFadeSlideYTransition from '@theme/VPFadeSlideYTransition.vue'
|
|
3
|
+
import VPHome from '@theme/VPHome.vue'
|
|
4
|
+
import VPNavbar from '@theme/VPNavbar.vue'
|
|
5
|
+
import VPPage from '@theme/VPPage.vue'
|
|
6
|
+
import VPSidebar from '@theme/VPSidebar.vue'
|
|
7
|
+
import { useData } from '@theme/useData'
|
|
8
|
+
import { useScrollPromise } from '@theme/useScrollPromise'
|
|
9
|
+
import { useSidebarItems } from '@theme/useSidebarItems'
|
|
10
|
+
import type { VNode } from 'vue'
|
|
11
|
+
import { computed, ref } from 'vue'
|
|
12
|
+
import { onContentUpdated } from 'vuepress/client'
|
|
15
13
|
|
|
16
14
|
defineSlots<{
|
|
17
|
-
'navbar'?: (props: Record<never, never>) =>
|
|
18
|
-
'navbar-before'?: (props: Record<never, never>) =>
|
|
19
|
-
'navbar-after'?: (props: Record<never, never>) =>
|
|
20
|
-
'sidebar'?: (props: Record<never, never>) =>
|
|
21
|
-
'sidebar-top'?: (props: Record<never, never>) =>
|
|
22
|
-
'sidebar-bottom'?: (props: Record<never, never>) =>
|
|
23
|
-
'page'?: (props: Record<never, never>) =>
|
|
24
|
-
'page-top'?: (props: Record<never, never>) =>
|
|
25
|
-
'page-bottom'?: (props: Record<never, never>) =>
|
|
26
|
-
'page-content-top'?: (props: Record<never, never>) =>
|
|
27
|
-
'page-content-bottom'?: (
|
|
15
|
+
'navbar'?: (props: Record<never, never>) => VNode | VNode[] | null
|
|
16
|
+
'navbar-before'?: (props: Record<never, never>) => VNode | VNode[] | null
|
|
17
|
+
'navbar-after'?: (props: Record<never, never>) => VNode | VNode[] | null
|
|
18
|
+
'sidebar'?: (props: Record<never, never>) => VNode | VNode[] | null
|
|
19
|
+
'sidebar-top'?: (props: Record<never, never>) => VNode | VNode[] | null
|
|
20
|
+
'sidebar-bottom'?: (props: Record<never, never>) => VNode | VNode[] | null
|
|
21
|
+
'page'?: (props: Record<never, never>) => VNode | VNode[] | null
|
|
22
|
+
'page-top'?: (props: Record<never, never>) => VNode | VNode[] | null
|
|
23
|
+
'page-bottom'?: (props: Record<never, never>) => VNode | VNode[] | null
|
|
24
|
+
'page-content-top'?: (props: Record<never, never>) => VNode | VNode[] | null
|
|
25
|
+
'page-content-bottom'?: (
|
|
26
|
+
props: Record<never, never>,
|
|
27
|
+
) => VNode | VNode[] | null
|
|
28
28
|
}>()
|
|
29
29
|
|
|
30
|
-
const page =
|
|
31
|
-
const frontmatter = usePageFrontmatter<DefaultThemePageFrontmatter>()
|
|
32
|
-
const themeLocale = useThemeLocaleData()
|
|
30
|
+
const { frontmatter, page, themeLocale } = useData()
|
|
33
31
|
|
|
34
32
|
// navbar
|
|
35
33
|
const shouldShowNavbar = computed(
|
|
@@ -44,11 +42,11 @@ const toggleSidebar = (to?: boolean): void => {
|
|
|
44
42
|
isSidebarOpen.value = typeof to === 'boolean' ? to : !isSidebarOpen.value
|
|
45
43
|
}
|
|
46
44
|
const touchStart = { x: 0, y: 0 }
|
|
47
|
-
const onTouchStart = (e): void => {
|
|
45
|
+
const onTouchStart = (e: TouchEvent): void => {
|
|
48
46
|
touchStart.x = e.changedTouches[0].clientX
|
|
49
47
|
touchStart.y = e.changedTouches[0].clientY
|
|
50
48
|
}
|
|
51
|
-
const onTouchEnd = (e): void => {
|
|
49
|
+
const onTouchEnd = (e: TouchEvent): void => {
|
|
52
50
|
const dx = e.changedTouches[0].clientX - touchStart.x
|
|
53
51
|
const dy = e.changedTouches[0].clientY - touchStart.y
|
|
54
52
|
if (Math.abs(dx) > Math.abs(dy) && Math.abs(dx) > 40) {
|
|
@@ -60,26 +58,28 @@ const onTouchEnd = (e): void => {
|
|
|
60
58
|
}
|
|
61
59
|
}
|
|
62
60
|
|
|
61
|
+
// external-link-icon
|
|
62
|
+
const enableExternalLinkIcon = computed(
|
|
63
|
+
() =>
|
|
64
|
+
frontmatter.value.externalLinkIcon ??
|
|
65
|
+
themeLocale.value.externalLinkIcon ??
|
|
66
|
+
true,
|
|
67
|
+
)
|
|
68
|
+
|
|
63
69
|
// classes
|
|
64
70
|
const containerClass = computed(() => [
|
|
65
71
|
{
|
|
66
72
|
'no-navbar': !shouldShowNavbar.value,
|
|
67
73
|
'no-sidebar': !sidebarItems.value.length,
|
|
68
74
|
'sidebar-open': isSidebarOpen.value,
|
|
75
|
+
'external-link-icon': enableExternalLinkIcon.value,
|
|
69
76
|
},
|
|
70
77
|
frontmatter.value.pageClass,
|
|
71
78
|
])
|
|
72
79
|
|
|
73
|
-
// close sidebar
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
const router = useRouter()
|
|
77
|
-
unregisterRouterHook = router.afterEach(() => {
|
|
78
|
-
toggleSidebar(false)
|
|
79
|
-
})
|
|
80
|
-
})
|
|
81
|
-
onUnmounted(() => {
|
|
82
|
-
unregisterRouterHook()
|
|
80
|
+
// close sidebar when content changes
|
|
81
|
+
onContentUpdated(() => {
|
|
82
|
+
toggleSidebar(false)
|
|
83
83
|
})
|
|
84
84
|
|
|
85
85
|
// handle scrollBehavior with transition
|
|
@@ -90,46 +90,43 @@ const onBeforeLeave = scrollPromise.pending
|
|
|
90
90
|
|
|
91
91
|
<template>
|
|
92
92
|
<div
|
|
93
|
-
class="theme-container"
|
|
93
|
+
class="vp-theme-container"
|
|
94
94
|
:class="containerClass"
|
|
95
|
+
vp-container
|
|
95
96
|
@touchstart="onTouchStart"
|
|
96
97
|
@touchend="onTouchEnd"
|
|
97
98
|
>
|
|
98
99
|
<slot name="navbar">
|
|
99
|
-
<
|
|
100
|
+
<VPNavbar v-if="shouldShowNavbar" @toggle-sidebar="toggleSidebar">
|
|
100
101
|
<template #before>
|
|
101
102
|
<slot name="navbar-before" />
|
|
102
103
|
</template>
|
|
103
104
|
<template #after>
|
|
104
105
|
<slot name="navbar-after" />
|
|
105
106
|
</template>
|
|
106
|
-
</
|
|
107
|
+
</VPNavbar>
|
|
107
108
|
</slot>
|
|
108
109
|
|
|
109
|
-
<div class="sidebar-mask" @click="toggleSidebar(false)" />
|
|
110
|
+
<div class="vp-sidebar-mask" @click="toggleSidebar(false)" />
|
|
110
111
|
|
|
111
112
|
<slot name="sidebar">
|
|
112
|
-
<
|
|
113
|
+
<VPSidebar>
|
|
113
114
|
<template #top>
|
|
114
115
|
<slot name="sidebar-top" />
|
|
115
116
|
</template>
|
|
116
117
|
<template #bottom>
|
|
117
118
|
<slot name="sidebar-bottom" />
|
|
118
119
|
</template>
|
|
119
|
-
</
|
|
120
|
+
</VPSidebar>
|
|
120
121
|
</slot>
|
|
121
122
|
|
|
122
123
|
<slot name="page">
|
|
123
|
-
<
|
|
124
|
-
|
|
125
|
-
<Transition
|
|
126
|
-
v-else
|
|
127
|
-
name="fade-slide-y"
|
|
128
|
-
mode="out-in"
|
|
124
|
+
<VPFadeSlideYTransition
|
|
129
125
|
@before-enter="onBeforeEnter"
|
|
130
126
|
@before-leave="onBeforeLeave"
|
|
131
127
|
>
|
|
132
|
-
<
|
|
128
|
+
<VPHome v-if="frontmatter.home" />
|
|
129
|
+
<VPPage v-else :key="page.path">
|
|
133
130
|
<template #top>
|
|
134
131
|
<slot name="page-top" />
|
|
135
132
|
</template>
|
|
@@ -142,8 +139,84 @@ const onBeforeLeave = scrollPromise.pending
|
|
|
142
139
|
<template #bottom>
|
|
143
140
|
<slot name="page-bottom" />
|
|
144
141
|
</template>
|
|
145
|
-
</
|
|
146
|
-
</
|
|
142
|
+
</VPPage>
|
|
143
|
+
</VPFadeSlideYTransition>
|
|
147
144
|
</slot>
|
|
148
145
|
</div>
|
|
149
146
|
</template>
|
|
147
|
+
|
|
148
|
+
<style lang="scss">
|
|
149
|
+
@use '../styles/variables' as *;
|
|
150
|
+
|
|
151
|
+
.vp-sidebar-mask {
|
|
152
|
+
position: fixed;
|
|
153
|
+
top: 0;
|
|
154
|
+
left: 0;
|
|
155
|
+
z-index: 9;
|
|
156
|
+
|
|
157
|
+
display: none;
|
|
158
|
+
|
|
159
|
+
width: 100vw;
|
|
160
|
+
height: 100vh;
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
.vp-theme-container {
|
|
164
|
+
// navbar is disabled
|
|
165
|
+
&.no-navbar {
|
|
166
|
+
.vp-sidebar {
|
|
167
|
+
top: 0;
|
|
168
|
+
|
|
169
|
+
@media (max-width: $MQMobile) {
|
|
170
|
+
padding-top: 0;
|
|
171
|
+
}
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
.vp-page {
|
|
175
|
+
padding-top: 0;
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
// adjust heading margin and padding;
|
|
179
|
+
[vp-content] {
|
|
180
|
+
h1,
|
|
181
|
+
h2,
|
|
182
|
+
h3,
|
|
183
|
+
h4,
|
|
184
|
+
h5,
|
|
185
|
+
h6 {
|
|
186
|
+
margin-top: 1.5rem;
|
|
187
|
+
padding-top: 0;
|
|
188
|
+
}
|
|
189
|
+
}
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
&.no-sidebar {
|
|
193
|
+
// hide sidebar
|
|
194
|
+
.vp-sidebar {
|
|
195
|
+
display: none;
|
|
196
|
+
|
|
197
|
+
// show sidebar on mobile because it has navbar links
|
|
198
|
+
@media (max-width: $MQMobile) {
|
|
199
|
+
display: block;
|
|
200
|
+
}
|
|
201
|
+
}
|
|
202
|
+
|
|
203
|
+
.vp-page {
|
|
204
|
+
padding-inline-start: 0;
|
|
205
|
+
}
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
&.sidebar-open {
|
|
209
|
+
@media (max-width: $MQMobile) {
|
|
210
|
+
// show sidebar
|
|
211
|
+
.vp-sidebar {
|
|
212
|
+
transform: translateX(0);
|
|
213
|
+
}
|
|
214
|
+
|
|
215
|
+
// show sidebar mask
|
|
216
|
+
.vp-sidebar-mask {
|
|
217
|
+
display: block;
|
|
218
|
+
}
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
</style>
|