diff --git a/AGENTS.md b/AGENTS.md index e0f33d9809..70a43cfe54 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -272,6 +272,20 @@ export function TestComp(props) { - 新的属性需要声明可用的版本号 - 属性命名符合 antd 的 API 命名规则 +### 文档锚点 ID 规范 + +- 针对 Markdown 文件中的标题（# 到 ######）自动生成锚点 ID + - 所有中文标题（H1-H6）必须手动指定一个简洁、有意义的英文锚点。 + - 格式: ## 中文标题 {#english-anchor-id} + - 英文标题通常不需要手动指定锚点，但如果需要，可以使用相同的格式。 +- 锚点 ID 必须符合正则表达式 `^[a-zA-Z][\w-:\.]*$`, 且长度不应超过 32 个字符。 +- 用于演示（demo）且包含 `-demo-` 的 id 不受前面的长度限制。 +- FAQ 章节下的所有标题锚点必须以 `faq-` 作为前缀。 +- 为确保在不同语言间切换时锚点依然有效，同一问题的中英文锚点应保持完全一致。 + - 例如： + - 中文标题：`### 如何使用组件 {#how-to-use-component}` + - 英文标题：`### How to Use the Component {#how-to-use-component}` + ### Changelog 规范 - 在 CHANGELOG.en-US.md 和 CHANGELOG.zh-CN.md 书写每个版本的变更 diff --git a/CHANGELOG.zh-CN.md b/CHANGELOG.zh-CN.md index f3582c5d7e..b2d695dd95 100644 --- a/CHANGELOG.zh-CN.md +++ b/CHANGELOG.zh-CN.md @@ -182,7 +182,7 @@ tag: vVERSION - 💄 修复 DatePicker 文本颜色 token 错误的问题。[#55065](https://github.com/ant-design/ant-design/pull/55065) [@765477020](https://github.com/765477020) - 💄 修复 List 启用边框时会内容溢出的问题。[#55075](https://github.com/ant-design/ant-design/pull/55075) [@Jiyur](https://github.com/Jiyur) - ⌨️ 修复 Modal.confirm 缺失 `aria-labelledby` 可访问性属性的问题。[#55266](https://github.com/ant-design/ant-design/pull/55266) [@Jiyur](https://github.com/Jiyur) -- ⚡️ 优化 Cascader loading 图标的渲染。[#55285](https://github.com/ant-design/ant-design/pull/55285) [@li-jia-nan](https://github.com/li-jia-nan) +- ⚡️ 优化 Cascader 加载中图标的渲染。[#55285](https://github.com/ant-design/ant-design/pull/55285) [@li-jia-nan](https://github.com/li-jia-nan) - TypeScript - 🤖 修复 FloatButton `disabled` 属性类型缺失的问题。[#55156](https://github.com/ant-design/ant-design/pull/55156) [@deathemperor](https://github.com/deathemperor) diff --git a/components/config-provider/context.ts b/components/config-provider/context.ts index 63ad7eb8e2..907b7148ea 100644 --- a/components/config-provider/context.ts +++ b/components/config-provider/context.ts @@ -474,7 +474,7 @@ export interface ConfigComponentProps { } export interface ConfigConsumerProps extends ConfigComponentProps { - getTargetContainer?: () => HTMLElement; + getTargetContainer?: () => HTMLElement | Window; getPopupContainer?: (triggerNode?: HTMLElement) => HTMLElement; rootPrefixCls?: string; iconPrefixCls: string; diff --git a/components/config-provider/index.en-US.md b/components/config-provider/index.en-US.md index bf98515d16..23543422b9 100644 --- a/components/config-provider/index.en-US.md +++ b/components/config-provider/index.en-US.md @@ -56,8 +56,8 @@ Some components use dynamic style to support wave effect. You can config `csp` p | componentSize | Config antd component size | `small` \| `middle` \| `large` | - | | | csp | Set [Content Security Policy](https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP) config | { nonce: string } | - | | | direction | Set direction of layout. See [demo](#config-provider-demo-direction) | `ltr` \| `rtl` | `ltr` | | -| getPopupContainer | To set the container of the popup element. The default is to create a `div` element in `body` | function(triggerNode) | () => document.body | | -| getTargetContainer | Config Affix, Anchor scroll target container | () => HTMLElement | () => window | 4.2.0 | +| getPopupContainer | To set the container of the popup element. The default is to create a `div` element in `body` | `(trigger?: HTMLElement) => HTMLElement \| ShadowRoot` | () => document.body | | +| getTargetContainer | Config Affix, Anchor scroll target container | `() => HTMLElement \| Window \| ShadowRoot` | () => window | 4.2.0 | | iconPrefixCls | Set icon prefix className | string | `anticon` | 4.11.0 | | locale | Language package setting, you can find the packages in [antd/locale](http://unpkg.com/antd/locale/) | object | - | | | popupMatchSelectWidth | Determine whether the dropdown menu and the select input are the same width. Default set `min-width` same as input. Will ignore when value less than select width. `false` will disable virtual scroll | boolean \| number | - | 5.5.0 | diff --git a/components/config-provider/index.tsx b/components/config-provider/index.tsx index 9b7359e2b4..ae40b691ed 100644 --- a/components/config-provider/index.tsx +++ b/components/config-provider/index.tsx @@ -152,8 +152,8 @@ const PASSED_PROPS: Exclude< ]; export interface ConfigProviderProps { - getTargetContainer?: () => HTMLElement | Window; - getPopupContainer?: (triggerNode?: HTMLElement) => HTMLElement; + getTargetContainer?: () => HTMLElement | Window | ShadowRoot; + getPopupContainer?: (triggerNode?: HTMLElement) => HTMLElement | ShadowRoot; prefixCls?: string; iconPrefixCls?: string; children?: React.ReactNode; diff --git a/components/config-provider/index.zh-CN.md b/components/config-provider/index.zh-CN.md index 146481ba87..ee0ceb8940 100644 --- a/components/config-provider/index.zh-CN.md +++ b/components/config-provider/index.zh-CN.md @@ -57,8 +57,8 @@ export default Demo; | componentSize | 设置 antd 组件大小 | `small` \| `middle` \| `large` | - | | | csp | 设置 [Content Security Policy](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/CSP) 配置 | { nonce: string } | - | | | direction | 设置文本展示方向。 [示例](#config-provider-demo-direction) | `ltr` \| `rtl` | `ltr` | | -| getPopupContainer | 弹出框（Select, Tooltip, Menu 等等）渲染父节点，默认渲染到 body 上。 | function(triggerNode) | () => document.body | | -| getTargetContainer | 配置 Affix、Anchor 滚动监听容器。 | () => HTMLElement | () => window | 4.2.0 | +| getPopupContainer | 弹出框（Select, Tooltip, Menu 等等）渲染父节点，默认渲染到 body 上。 | `(trigger?: HTMLElement) => HTMLElement \| ShadowRoot` | () => document.body | | +| getTargetContainer | 配置 Affix、Anchor 滚动监听容器。 | `() => HTMLElement \| Window \| ShadowRoot` | () => window | 4.2.0 | | iconPrefixCls | 设置图标统一样式前缀 | string | `anticon` | 4.11.0 | | locale | 语言包配置，语言包可到 [antd/locale](http://unpkg.com/antd/locale/) 目录下寻找 | object | - | | | popupMatchSelectWidth | 下拉菜单和选择器同宽。默认将设置 `min-width`，当值小于选择框宽度时会被忽略。`false` 时会关闭虚拟滚动 | boolean \| number | - | 5.5.0 | diff --git a/components/image/__tests__/index.test.tsx b/components/image/__tests__/index.test.tsx index 3939c8dd2d..252c32244e 100644 --- a/components/image/__tests__/index.test.tsx +++ b/components/image/__tests__/index.test.tsx @@ -73,7 +73,9 @@ describe('Image', () => { const { container, baseElement } = render( <>
- document.querySelector('.container')!}> + document.querySelector('.container')!} + > {alt} , diff --git a/docs/react/faq.en-US.md b/docs/react/faq.en-US.md index 3ad572ff05..f1bb5c88c8 100644 --- a/docs/react/faq.en-US.md +++ b/docs/react/faq.en-US.md @@ -274,6 +274,10 @@ If you encounter the above error, please check the current project `tsconfig.jso The above problem occurs if `strictNullChecks` is set to `true`, If you can determine the project don't need this configuration (see [strictNullChecks](https://www.typescriptlang.org/zh/tsconfig#strictNullChecks) to judge whether need the configuration). You can try changing to `false` to turn off the control strict check. However, if you do need to enable this feature, you can avoid this situation by using other types instead of `null` when defining types +## Why doesn't antd handle precision issues encountered with browser zoom? + +Different browsers have different rendering behaviors when zooming. Fixing a precision issue in one browser often leads to issues in others. Additionally, zoom-related precision issues typically occur at extreme zoom levels, which are uncommon in regular use. The inconsistency in rendering arises from how browsers calculate and render elements during zoom operations, including subpixel rendering, rounding differences, and layout recalculations. Addressing these issues requires a significant amount of browser-specific code, which can negatively impact performance and maintainability, and may also be broken by iterations in the browsers themselves. + ## The antd component reported an error when using the App Router of Next.js If you are using the App Router of Next.js, when you use the sub-components provided by some antd components, such as `Select.Option `, `Form.Item`, `Typography.Title`, etc., you may get the following error: diff --git a/docs/react/faq.zh-CN.md b/docs/react/faq.zh-CN.md index dcfea489b9..d9ea8e359a 100644 --- a/docs/react/faq.zh-CN.md +++ b/docs/react/faq.zh-CN.md @@ -298,6 +298,10 @@ export default () => { 如果 `strictNullChecks` 的值被设置为 `true` 就会出现上述问题，如果你确定项目中可以不需要这个检测配置（查看[strictNullChecks](https://www.typescriptlang.org/zh/tsconfig#strictNullChecks)判断是否需要该配置），可以尝试改为 `false` 关闭控制严格检查功能。但如果你确实需要开启这个功能，那么，你可以在设计类型时，使用其他类型替代 `null` 以避免出现这种情况。 +## 为什么 antd 不处理浏览器缩放遇到的精度问题？ + +不同浏览器对缩放的渲染行为不同，修复一个浏览器的精度问题往往会导致其他浏览器出现问题。此外，缩放相关的精度问题通常出现在极端缩放级别下，这在常规使用中并不常见。渲染不一致的问题源于浏览器在缩放操作期间计算和渲染元素的方式，包括亚像素渲染、舍入差异和布局重新计算。解决这些问题需要大量的浏览器特定代码，这会对性能和可维护性产生负面影响，并且这些代码也可能因浏览器版本更新而失效。 + ## 使用 Next.js 的 App Router 时 antd 组件报错 如果你在使用 Next.js 的 App Router，当你使用 antd 中某些组件提供的子组件，如：`Select.Option`、`Form.Item`、`Typography.Title` 等，可能会出现如下报错： diff --git a/docs/resources.en-US.md b/docs/resources.en-US.md index d433a18c21..e9c76750ee 100644 --- a/docs/resources.en-US.md +++ b/docs/resources.en-US.md @@ -41,6 +41,11 @@ Please find below some of the design resources and tools about Ant Design that w - Landing Templates - https://landing.ant.design/docs/download-cn - Official +- AntUIKit + - https://www.antuikit.com/antuikit.svg + - Figma Design System, Blocks, Flows & Templates + - https://www.antuikit.com + - Community - Figma Resources - https://gw.alipayobjects.com/zos/basement_prod/7b9ed3f2-6f05-4ddb-bac3-d55feb71e0ac.svg - Always up-to-date Ant Design Figma resources diff --git a/docs/resources.zh-CN.md b/docs/resources.zh-CN.md index ab59c5dc5c..c524b01638 100644 --- a/docs/resources.zh-CN.md +++ b/docs/resources.zh-CN.md @@ -41,6 +41,11 @@ description: 这里汇总了与 Ant Design 相关的所有资源。 - 首页模板集 - https://landing.ant.design/docs/download-cn - 官方 +- AntUIKit + - https://www.antuikit.com/antuikit.svg + - Figma 设计系统、模块、流程和模板 + - https://www.antuikit.com + - 社区 - Figma 组件包 - https://gw.alipayobjects.com/zos/basement_prod/7b9ed3f2-6f05-4ddb-bac3-d55feb71e0ac.svg - 在 Figma 使用 Ant Design 进行设计 diff --git a/eslint.config.mjs b/eslint.config.mjs index a9dc59708c..2c83ed6cf3 100644 --- a/eslint.config.mjs +++ b/eslint.config.mjs @@ -49,7 +49,6 @@ export default antfu( 'react/no-children-only': 'off', 'react/no-unstable-default-props': 'off', 'react/no-create-ref': 'off', // TODO: remove this - 'react/no-comment-textnodes': 'off', 'react-hooks-extra/prefer-use-state-lazy-initialization': 'off', 'perfectionist/sort-imports': 'off', 'regexp/strict': 'off', @@ -57,8 +56,17 @@ export default antfu( 'react/no-forward-ref': 'off', 'react/no-context-provider': 'off', 'react/no-use-context': 'off', - 'react-hooks-extra/no-unnecessary-use-prefix': 'off', 'react-hooks-extra/no-direct-set-state-in-use-effect': 'off', + /* turn off 升级 @antfu/eslint-config@6 带来的 warning */ + 'react/no-unnecessary-use-prefix': 'off', + 'react-hooks/use-memo': 'off', + 'react-hooks/immutability': 'off', + 'react-hooks/globals': 'off', + 'react-hooks/preserve-manual-memoization': 'off', + 'react-hooks/set-state-in-effect': 'off', + 'react-hooks/refs': 'off', + 'react-hooks/purity': 'off', + 'react-hooks/static-components': 'off', }, }, compat.configs['flat/recommended'], diff --git a/package.json b/package.json index 68b3ccb2fb..d54263f098 100644 --- a/package.json +++ b/package.json @@ -162,7 +162,7 @@ "@ant-design/happy-work-theme": "^1.0.1", "@ant-design/tools": "^19.0.3", "@ant-design/x": "^1.6.1", - "@antfu/eslint-config": "^5.4.1", + "@antfu/eslint-config": "^6.0.0", "@antv/g6": "^4.8.25", "@biomejs/biome": "^2.2.5", "@blazediff/core": "^1.4.0",