2022-11-30 11:05:41 +08:00
|
|
|
import { GithubOutlined, MenuOutlined } from '@ant-design/icons';
|
2023-07-20 19:27:33 +08:00
|
|
|
import { createStyles } from 'antd-style';
|
2023-02-03 13:39:46 +08:00
|
|
|
import classNames from 'classnames';
|
2023-03-01 13:40:19 +08:00
|
|
|
import { useLocation, useSiteData } from 'dumi';
|
2023-02-03 13:39:46 +08:00
|
|
|
import DumiSearchBar from 'dumi/theme-default/slots/SearchBar';
|
|
|
|
import React, { useCallback, useContext, useEffect, useMemo, useRef, useState } from 'react';
|
2023-07-28 16:17:43 +08:00
|
|
|
import { Col, Modal, Popover, Row, Select } from 'antd';
|
2023-02-03 13:39:46 +08:00
|
|
|
import useLocale from '../../../hooks/useLocale';
|
2023-06-05 00:51:16 +08:00
|
|
|
import DirectionIcon from '../../common/DirectionIcon';
|
2022-11-09 12:28:04 +08:00
|
|
|
import * as utils from '../../utils';
|
|
|
|
import { getThemeConfig, ping } from '../../utils';
|
2023-02-03 13:39:46 +08:00
|
|
|
import type { SiteContextProps } from '../SiteContext';
|
|
|
|
import SiteContext from '../SiteContext';
|
2022-11-09 12:28:04 +08:00
|
|
|
import Logo from './Logo';
|
|
|
|
import More from './More';
|
|
|
|
import Navigation from './Navigation';
|
2022-11-27 20:25:59 +08:00
|
|
|
import SwitchBtn from './SwitchBtn';
|
2023-06-05 00:51:16 +08:00
|
|
|
import type { SharedProps } from './interface';
|
2022-11-09 12:28:04 +08:00
|
|
|
|
|
|
|
const RESPONSIVE_XS = 1120;
|
|
|
|
const RESPONSIVE_SM = 1200;
|
|
|
|
|
2023-07-20 19:27:33 +08:00
|
|
|
const useStyle = createStyles(({ token, css }) => {
|
2022-11-18 11:29:46 +08:00
|
|
|
const searchIconColor = '#ced4d9';
|
2022-11-09 12:28:04 +08:00
|
|
|
|
|
|
|
return {
|
|
|
|
header: css`
|
2023-08-08 19:48:41 +08:00
|
|
|
position: sticky;
|
|
|
|
top: 0;
|
|
|
|
z-index: 1000;
|
2022-11-09 12:28:04 +08:00
|
|
|
max-width: 100%;
|
|
|
|
background: ${token.colorBgContainer};
|
2023-02-08 21:51:06 +08:00
|
|
|
box-shadow: ${token.boxShadowTertiary};
|
2023-08-08 19:48:41 +08:00
|
|
|
backdrop-filter: blur(8px);
|
2022-11-09 12:28:04 +08:00
|
|
|
|
|
|
|
@media only screen and (max-width: ${token.mobileMaxWidth}px) {
|
|
|
|
text-align: center;
|
|
|
|
}
|
2022-11-18 11:29:46 +08:00
|
|
|
|
2022-11-18 13:11:31 +08:00
|
|
|
.nav-search-wrapper {
|
|
|
|
display: flex;
|
2022-11-27 20:25:59 +08:00
|
|
|
flex: auto;
|
2022-11-18 13:11:31 +08:00
|
|
|
}
|
|
|
|
|
2022-11-18 11:29:46 +08:00
|
|
|
.dumi-default-search-bar {
|
2022-11-18 13:10:13 +08:00
|
|
|
border-inline-start: 1px solid rgba(0, 0, 0, 0.06);
|
2022-11-18 11:29:46 +08:00
|
|
|
|
|
|
|
> svg {
|
|
|
|
width: 14px;
|
|
|
|
fill: ${searchIconColor};
|
|
|
|
}
|
|
|
|
|
|
|
|
> input {
|
|
|
|
height: 22px;
|
|
|
|
border: 0;
|
|
|
|
|
|
|
|
&:focus {
|
|
|
|
box-shadow: none;
|
|
|
|
}
|
|
|
|
|
|
|
|
&::placeholder {
|
|
|
|
color: ${searchIconColor};
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
.dumi-default-search-shortcut {
|
|
|
|
color: ${searchIconColor};
|
|
|
|
background-color: rgba(150, 150, 150, 0.06);
|
|
|
|
border-color: rgba(100, 100, 100, 0.2);
|
|
|
|
border-radius: 4px;
|
|
|
|
}
|
|
|
|
|
|
|
|
.dumi-default-search-popover {
|
|
|
|
inset-inline-start: 11px;
|
|
|
|
inset-inline-end: unset;
|
|
|
|
|
|
|
|
&::before {
|
|
|
|
inset-inline-start: 100px;
|
|
|
|
inset-inline-end: unset;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2022-11-09 12:28:04 +08:00
|
|
|
`,
|
|
|
|
menuRow: css`
|
|
|
|
display: flex;
|
|
|
|
align-items: center;
|
|
|
|
margin: 0;
|
|
|
|
|
|
|
|
> * {
|
|
|
|
flex: none;
|
2023-01-04 19:37:57 +08:00
|
|
|
margin: 0;
|
|
|
|
margin-inline-end: 12px;
|
2022-11-09 12:28:04 +08:00
|
|
|
|
|
|
|
&:last-child {
|
2023-01-04 19:37:57 +08:00
|
|
|
margin-inline-end: 40px;
|
2022-11-09 12:28:04 +08:00
|
|
|
}
|
|
|
|
}
|
|
|
|
`,
|
2023-06-05 00:51:16 +08:00
|
|
|
dataDirectionIcon: css`
|
|
|
|
width: 16px;
|
|
|
|
`,
|
2022-11-09 12:28:04 +08:00
|
|
|
popoverMenu: {
|
|
|
|
width: 300,
|
|
|
|
|
|
|
|
[`${token.antCls}-popover-inner-content`]: {
|
|
|
|
padding: 0,
|
|
|
|
},
|
|
|
|
},
|
|
|
|
};
|
2023-07-20 19:27:33 +08:00
|
|
|
});
|
2022-11-09 12:28:04 +08:00
|
|
|
|
|
|
|
const SHOULD_OPEN_ANT_DESIGN_MIRROR_MODAL = 'ANT_DESIGN_DO_NOT_OPEN_MIRROR_MODAL';
|
|
|
|
|
|
|
|
function disableAntdMirrorModal() {
|
|
|
|
window.localStorage.setItem(SHOULD_OPEN_ANT_DESIGN_MIRROR_MODAL, 'true');
|
|
|
|
}
|
|
|
|
|
|
|
|
function shouldOpenAntdMirrorModal() {
|
|
|
|
return !window.localStorage.getItem(SHOULD_OPEN_ANT_DESIGN_MIRROR_MODAL);
|
|
|
|
}
|
|
|
|
|
|
|
|
interface HeaderState {
|
|
|
|
menuVisible: boolean;
|
|
|
|
windowWidth: number;
|
|
|
|
searching: boolean;
|
|
|
|
}
|
|
|
|
|
2022-11-18 13:10:13 +08:00
|
|
|
// ================================= Header =================================
|
2022-12-19 11:42:41 +08:00
|
|
|
const Header: React.FC = () => {
|
2022-11-09 12:28:04 +08:00
|
|
|
const [isClient, setIsClient] = React.useState(false);
|
2023-01-10 16:51:28 +08:00
|
|
|
const [, lang] = useLocale();
|
2022-11-09 12:28:04 +08:00
|
|
|
|
2023-03-01 13:40:19 +08:00
|
|
|
const { pkg } = useSiteData();
|
|
|
|
|
2022-11-09 12:28:04 +08:00
|
|
|
const themeConfig = getThemeConfig();
|
|
|
|
const [headerState, setHeaderState] = useState<HeaderState>({
|
|
|
|
menuVisible: false,
|
|
|
|
windowWidth: 1400,
|
|
|
|
searching: false,
|
|
|
|
});
|
2022-12-19 11:42:41 +08:00
|
|
|
const { direction, isMobile, updateSiteConfig } = useContext<SiteContextProps>(SiteContext);
|
2022-11-09 12:28:04 +08:00
|
|
|
const pingTimer = useRef<NodeJS.Timeout | null>(null);
|
|
|
|
const location = useLocation();
|
|
|
|
const { pathname, search } = location;
|
|
|
|
|
2023-07-20 19:27:33 +08:00
|
|
|
const { styles } = useStyle();
|
2022-11-09 12:28:04 +08:00
|
|
|
|
|
|
|
const handleHideMenu = useCallback(() => {
|
2022-11-18 11:29:46 +08:00
|
|
|
setHeaderState((prev) => ({ ...prev, menuVisible: false }));
|
2022-11-09 12:28:04 +08:00
|
|
|
}, []);
|
|
|
|
const onWindowResize = useCallback(() => {
|
2022-11-18 11:29:46 +08:00
|
|
|
setHeaderState((prev) => ({ ...prev, windowWidth: window.innerWidth }));
|
2022-11-09 12:28:04 +08:00
|
|
|
}, []);
|
|
|
|
const handleShowMenu = useCallback(() => {
|
2022-11-18 11:29:46 +08:00
|
|
|
setHeaderState((prev) => ({ ...prev, menuVisible: true }));
|
2022-11-09 12:28:04 +08:00
|
|
|
}, []);
|
|
|
|
const onMenuVisibleChange = useCallback((visible: boolean) => {
|
2022-11-18 11:29:46 +08:00
|
|
|
setHeaderState((prev) => ({ ...prev, menuVisible: visible }));
|
2022-11-09 12:28:04 +08:00
|
|
|
}, []);
|
2022-11-25 00:04:27 +08:00
|
|
|
const onDirectionChange = () => {
|
2022-12-19 11:42:41 +08:00
|
|
|
updateSiteConfig({ direction: direction !== 'rtl' ? 'rtl' : 'ltr' });
|
2022-11-25 00:04:27 +08:00
|
|
|
};
|
2022-11-09 12:28:04 +08:00
|
|
|
|
|
|
|
useEffect(() => {
|
|
|
|
handleHideMenu();
|
|
|
|
}, [location]);
|
|
|
|
|
|
|
|
useEffect(() => {
|
|
|
|
setIsClient(typeof window !== 'undefined');
|
|
|
|
onWindowResize();
|
|
|
|
window.addEventListener('resize', onWindowResize);
|
2022-11-18 11:29:46 +08:00
|
|
|
pingTimer.current = ping((status) => {
|
2022-11-09 12:28:04 +08:00
|
|
|
if (status !== 'timeout' && status !== 'error') {
|
|
|
|
if (
|
2022-11-18 13:10:13 +08:00
|
|
|
// process.env.NODE_ENV === 'production' &&
|
2022-11-09 12:28:04 +08:00
|
|
|
window.location.host !== 'ant-design.antgroup.com' &&
|
|
|
|
shouldOpenAntdMirrorModal()
|
|
|
|
) {
|
|
|
|
Modal.confirm({
|
|
|
|
title: '提示',
|
|
|
|
content: '内网用户推荐访问国内镜像以获得极速体验~',
|
|
|
|
okText: '🚀 立刻前往',
|
|
|
|
cancelText: '不再弹出',
|
|
|
|
closable: true,
|
2022-11-18 13:10:13 +08:00
|
|
|
zIndex: 99999,
|
2022-11-09 12:28:04 +08:00
|
|
|
onOk() {
|
|
|
|
window.open('https://ant-design.antgroup.com', '_self');
|
|
|
|
disableAntdMirrorModal();
|
|
|
|
},
|
|
|
|
onCancel() {
|
|
|
|
disableAntdMirrorModal();
|
|
|
|
},
|
|
|
|
});
|
|
|
|
}
|
|
|
|
}
|
|
|
|
});
|
|
|
|
return () => {
|
|
|
|
window.removeEventListener('resize', onWindowResize);
|
|
|
|
if (pingTimer.current) {
|
|
|
|
clearTimeout(pingTimer.current);
|
|
|
|
}
|
|
|
|
};
|
|
|
|
}, []);
|
|
|
|
|
|
|
|
// eslint-disable-next-line class-methods-use-this
|
|
|
|
const handleVersionChange = useCallback((url: string) => {
|
|
|
|
const currentUrl = window.location.href;
|
|
|
|
const currentPathname = window.location.pathname;
|
|
|
|
if (/overview/.test(currentPathname) && /0?[1-39][0-3]?x/.test(url)) {
|
|
|
|
window.location.href = currentUrl
|
|
|
|
.replace(window.location.origin, url)
|
|
|
|
.replace(/\/components\/overview/, `/docs${/0(9|10)x/.test(url) ? '' : '/react'}/introduce`)
|
|
|
|
.replace(/\/$/, '');
|
|
|
|
return;
|
|
|
|
}
|
2023-03-22 15:24:15 +08:00
|
|
|
// Mirror url must have `/`, we add this for compatible
|
|
|
|
const urlObj = new URL(currentUrl.replace(window.location.origin, url));
|
2023-06-21 18:52:21 +08:00
|
|
|
if (urlObj.host.includes('antgroup')) {
|
|
|
|
window.location.href = `${urlObj.href.replace(/\/$/, '')}/`;
|
2023-06-20 19:38:42 +08:00
|
|
|
}
|
2023-06-21 18:52:21 +08:00
|
|
|
window.location.href = urlObj.href.replace(/\/$/, '');
|
2022-11-09 12:28:04 +08:00
|
|
|
}, []);
|
|
|
|
|
|
|
|
const onLangChange = useCallback(() => {
|
|
|
|
const currentProtocol = `${window.location.protocol}//`;
|
|
|
|
const currentHref = window.location.href.slice(currentProtocol.length);
|
|
|
|
|
|
|
|
if (utils.isLocalStorageNameSupported()) {
|
|
|
|
localStorage.setItem('locale', utils.isZhCN(pathname) ? 'en-US' : 'zh-CN');
|
|
|
|
}
|
|
|
|
window.location.href =
|
|
|
|
currentProtocol +
|
|
|
|
currentHref.replace(
|
|
|
|
window.location.pathname,
|
|
|
|
utils.getLocalizedPathname(pathname, !utils.isZhCN(pathname), search).pathname,
|
|
|
|
);
|
|
|
|
}, [location]);
|
|
|
|
|
|
|
|
const nextDirectionText = useMemo<string>(
|
|
|
|
() => (direction !== 'rtl' ? 'RTL' : 'LTR'),
|
|
|
|
[direction],
|
|
|
|
);
|
|
|
|
|
|
|
|
const getDropdownStyle = useMemo<React.CSSProperties>(
|
|
|
|
() => (direction === 'rtl' ? { direction: 'ltr', textAlign: 'right' } : {}),
|
|
|
|
[direction],
|
|
|
|
);
|
|
|
|
|
2022-11-29 13:14:06 +08:00
|
|
|
const { menuVisible, windowWidth, searching } = headerState;
|
2022-11-09 12:28:04 +08:00
|
|
|
const docVersions: Record<string, string> = {
|
2023-03-01 13:40:19 +08:00
|
|
|
[pkg.version]: pkg.version,
|
2022-11-09 12:28:04 +08:00
|
|
|
...themeConfig?.docVersions,
|
|
|
|
};
|
2023-01-12 11:57:54 +08:00
|
|
|
const versionOptions = Object.keys(docVersions).map((version) => ({
|
|
|
|
value: docVersions[version],
|
|
|
|
label: version,
|
|
|
|
}));
|
2022-11-09 12:28:04 +08:00
|
|
|
|
|
|
|
const isHome = ['', 'index', 'index-cn'].includes(pathname);
|
|
|
|
const isZhCN = lang === 'cn';
|
|
|
|
const isRTL = direction === 'rtl';
|
|
|
|
let responsive: null | 'narrow' | 'crowded' = null;
|
|
|
|
if (windowWidth < RESPONSIVE_XS) {
|
|
|
|
responsive = 'crowded';
|
|
|
|
} else if (windowWidth < RESPONSIVE_SM) {
|
|
|
|
responsive = 'narrow';
|
|
|
|
}
|
|
|
|
|
2023-07-20 19:27:33 +08:00
|
|
|
const headerClassName = classNames(styles.header, 'clearfix', {
|
2022-11-09 12:28:04 +08:00
|
|
|
'home-header': isHome,
|
|
|
|
});
|
|
|
|
|
2023-02-03 13:39:46 +08:00
|
|
|
const sharedProps: SharedProps = {
|
2022-11-09 12:28:04 +08:00
|
|
|
isZhCN,
|
|
|
|
isRTL,
|
|
|
|
isClient,
|
|
|
|
};
|
|
|
|
|
|
|
|
const navigationNode = (
|
|
|
|
<Navigation
|
|
|
|
key="nav"
|
|
|
|
{...sharedProps}
|
|
|
|
responsive={responsive}
|
|
|
|
isMobile={isMobile}
|
|
|
|
directionText={nextDirectionText}
|
|
|
|
onLangChange={onLangChange}
|
|
|
|
onDirectionChange={onDirectionChange}
|
|
|
|
/>
|
|
|
|
);
|
|
|
|
|
2023-01-12 11:57:54 +08:00
|
|
|
let menu = [
|
2022-11-09 12:28:04 +08:00
|
|
|
navigationNode,
|
2023-01-10 16:51:28 +08:00
|
|
|
<Select
|
2022-11-30 11:05:41 +08:00
|
|
|
key="version"
|
2023-01-10 16:51:28 +08:00
|
|
|
className="version"
|
|
|
|
size="small"
|
2023-03-01 13:40:19 +08:00
|
|
|
defaultValue={pkg.version}
|
2023-01-10 16:51:28 +08:00
|
|
|
onChange={handleVersionChange}
|
|
|
|
dropdownStyle={getDropdownStyle}
|
2023-06-20 19:38:58 +08:00
|
|
|
popupMatchSelectWidth={false}
|
2023-01-10 16:51:28 +08:00
|
|
|
getPopupContainer={(trigger) => trigger.parentNode}
|
2023-01-12 11:57:54 +08:00
|
|
|
options={versionOptions}
|
|
|
|
/>,
|
2022-11-29 13:14:06 +08:00
|
|
|
<More key="more" {...sharedProps} />,
|
2022-11-27 20:25:59 +08:00
|
|
|
<SwitchBtn
|
|
|
|
key="lang"
|
|
|
|
onClick={onLangChange}
|
|
|
|
value={utils.isZhCN(pathname) ? 1 : 2}
|
|
|
|
label1="中"
|
|
|
|
label2="En"
|
|
|
|
tooltip1="中文 / English"
|
|
|
|
tooltip2="English / 中文"
|
|
|
|
/>,
|
|
|
|
<SwitchBtn
|
|
|
|
key="direction"
|
2022-11-09 12:28:04 +08:00
|
|
|
onClick={onDirectionChange}
|
2022-11-27 20:25:59 +08:00
|
|
|
value={direction === 'rtl' ? 2 : 1}
|
2023-07-20 19:27:33 +08:00
|
|
|
label1={<DirectionIcon className={styles.dataDirectionIcon} direction="ltr" />}
|
2022-11-27 20:25:59 +08:00
|
|
|
tooltip1="LTR"
|
2023-07-20 19:27:33 +08:00
|
|
|
label2={<DirectionIcon className={styles.dataDirectionIcon} direction="rtl" />}
|
2022-11-27 20:25:59 +08:00
|
|
|
tooltip2="RTL"
|
|
|
|
pure
|
2023-07-21 15:04:42 +08:00
|
|
|
aria-label="RTL Switch Button"
|
2022-11-27 20:25:59 +08:00
|
|
|
/>,
|
2022-11-30 11:05:41 +08:00
|
|
|
<a
|
|
|
|
key="github"
|
|
|
|
href="https://github.com/ant-design/ant-design"
|
|
|
|
target="_blank"
|
|
|
|
rel="noreferrer"
|
|
|
|
>
|
|
|
|
<SwitchBtn value={1} label1={<GithubOutlined />} tooltip1="Github" label2={null} pure />
|
2022-11-29 13:14:06 +08:00
|
|
|
</a>,
|
2022-11-09 12:28:04 +08:00
|
|
|
];
|
|
|
|
|
|
|
|
if (windowWidth < RESPONSIVE_XS) {
|
|
|
|
menu = searching ? [] : [navigationNode];
|
|
|
|
} else if (windowWidth < RESPONSIVE_SM) {
|
|
|
|
menu = searching ? [] : menu;
|
|
|
|
}
|
|
|
|
|
|
|
|
const colProps = isHome
|
|
|
|
? [{ flex: 'none' }, { flex: 'auto' }]
|
|
|
|
: [
|
|
|
|
{ xxl: 4, xl: 5, lg: 6, md: 6, sm: 24, xs: 24 },
|
|
|
|
{ xxl: 20, xl: 19, lg: 18, md: 18, sm: 0, xs: 0 },
|
|
|
|
];
|
|
|
|
|
|
|
|
return (
|
2023-07-20 19:27:33 +08:00
|
|
|
<header className={headerClassName}>
|
2022-11-09 12:28:04 +08:00
|
|
|
{isMobile && (
|
2023-07-20 19:27:33 +08:00
|
|
|
<Popover
|
|
|
|
overlayClassName={styles.popoverMenu}
|
|
|
|
placement="bottomRight"
|
|
|
|
content={menu}
|
|
|
|
trigger="click"
|
|
|
|
open={menuVisible}
|
|
|
|
arrow={{ arrowPointAtCenter: true }}
|
|
|
|
onOpenChange={onMenuVisibleChange}
|
|
|
|
>
|
|
|
|
<MenuOutlined className="nav-phone-icon" onClick={handleShowMenu} />
|
|
|
|
</Popover>
|
2022-11-09 12:28:04 +08:00
|
|
|
)}
|
|
|
|
<Row style={{ flexFlow: 'nowrap', height: 64 }}>
|
|
|
|
<Col {...colProps[0]}>
|
|
|
|
<Logo {...sharedProps} location={location} />
|
|
|
|
</Col>
|
2023-07-20 19:27:33 +08:00
|
|
|
<Col {...colProps[1]} className={styles.menuRow}>
|
2022-11-18 13:11:31 +08:00
|
|
|
<div className="nav-search-wrapper">
|
|
|
|
<DumiSearchBar />
|
|
|
|
</div>
|
2022-11-09 12:28:04 +08:00
|
|
|
{!isMobile && menu}
|
|
|
|
</Col>
|
|
|
|
</Row>
|
|
|
|
</header>
|
|
|
|
);
|
|
|
|
};
|
|
|
|
|
|
|
|
export default Header;
|