ant-design/docs/spec/proximity.zh-CN.md

---
group: 设计模式
type: 原则
order: 1
title: 亲密性
---

如果信息之间关联性越高，它们之间的距离就应该越接近，也越像一个视觉单元；反之，则它们的距离就应该越远，也越像多个视觉单元。亲密性的根本目的是实现组织性，让用户对页面结构和信息层次一目了然。

---

## 纵向间距关系

<img class="preview-img" alt="纵向间距示例" description="在 Ant Design 中，这三种规格分别为：8px（小号间距）、16px（中号间距）、24px（大号间距）。" src="https://gw.alipayobjects.com/zos/rmsportal/goazWUHPXsGEDFIGsNlm.png">

通过「小号间距」、「中号间距」、「大号间距」这三种规格来划分信息层次结构。

<br>

<img class="preview-img" alt="增加元素示例" description="通过增加「分割线」来拉开层次。" src="https://gw.alipayobjects.com/zos/rmsportal/XNFCsupiYDBTJFQkmOmv.png">

在这三种规格不适用的情况下，可以通过加减「基础间距」的倍数，或者增加元素来拉开信息层次。

> 注：在 Ant Design 中，`y = 8 + 8 * n`。其中，`n >= 0`，y 是纵向间距，8 是「基础间距」。

---

## 横向间距关系

<img class="preview-img" alt="组合排布示例" src="https://gw.alipayobjects.com/zos/rmsportal/uYvsqAUXNaqURGIhZhxz.png">

为了适用不同尺寸的屏幕，在横向采用栅格布局来排布组件，从而保证布局的灵活性。

<br>

<img class="preview-img" alt="复选框内示例" src="https://gw.alipayobjects.com/zos/rmsportal/ysXfdKqmdDRAimBiKVGS.png">

在一个组件内部，元素的横向间距也应该有所不同。
-												docs: update documentation format

											
										
										
											2016-03-31 14:17:09 +08:00
+								---
-												docs: v5 site upgrade (#38328)

* build: try to use dumi as doc tool

* docs: migrate demo structure to dumi way

* refactor: use type export & import

* docs: migrate demo previewer to dumi

* docs: create empty layout & components

* docs: apply custom rehype plugin

* docs: create empty extra pages

* docs: Add Banner component

* chore: move theme tsconfig.json

* docs: home page init

* docs: migrate header (#37896)

* docs: header

* docs: update

* docs: home init

* clean up

* test: fix site lint

* chore: tsc ignore demo

* chore: dumi demo migrate script

* chore: cards

* docs: home layout

* docs: Update locale logic

* docs: fix getLink logic

* chore: fix ci (#37899)

* chore: fix ci

* ci: remove check-ts-demo

* ci: preview build

* test: ignore demo.tsx

* chore: update script

* test: update snapshot

* test: update node and image test

* chore: add .surgeignore

* docs: layout providers (#37908)

* docs: add components sidebar (#37923)

* docs: sidebar

* docs: update docs title

* docs: update design doc

* chore: code clean

* docs: handle changelog page

* docs: add title

* docs: add subtitle

* docs: active header nav

* chore: code clean

* docs: overview

* chore: code clean

* docs: update intl (#37918)

* docs: update intl

* chore: code clean

* docs: update favicons

* chore: update testPathIgnorePatterns

* chore: code clean

* chore: code clean

* chore: copy 404.html (#37996)

* docs: Home page theme picker

* chore: Update migrate script

* docs: home page update

* docs: theme editor style

* docs: theme lang

* chore: update migrate.js

* docs: fix demo (#38094)

* chore: update migrate.js

* docs: update md

* docs: update demo

* test: fix snapshot

* chore: move debug to code attr in migrate script

* chore: update md

Co-authored-by: PeachScript <scdzwyxst@gmail.com>

* feat: overview page

* feat: Migrate `404` page (#38118)

* feat: migrate IconSearch component (#37916)

* feat<site/IconSearch>: copy IconDisplay from site to .dumi

* feat<site/IconSearch>: change docs of icon

* feat<site/IconSearch>: tweak

* feat<site/IconSearch>: use useIntl instead of injectIntl

* feat<site/IconSearch>: fix ts type error

* feat<site/IconSearch>: use intl.formatMessage to render text

* docs: Adjust home btn sizw

* docs: Update doc

* feat: v5 site overview page (#38131)

* feat: site

* fix: fix

* feat: v5 site overview page

* fix: fix path

* fix: fix

* fix: fix

* docs: fix margin logic

* feat: v5 site change-log page (#38137)

* feat: v5 site change-log page (#38162)

* docs: site redirect to home pag

* docs: theme picker

* docs: use react-intl from dumi (#38183)

* docs: Theme Picker

* docs: update dumi config

* docs: home back fix

* docs: picker colorful

* docs: locale of it

* docs: update components desc

* docs: site of links

* docs: update components list

* docs: update desc

* feat: Migrate `DemoWrapper` component (#38166)

* feat: Migrate `DemoWrapper` component

* feat: remove invalid comments and add comment for `key` prop

* docs: FloatButton pure panel

* chore: update demo

* chore: update dumi config

* Revert "chore: update demo"

This reverts commit 028265d3ba5987df5f13c3e9d42cf76cb1812b2e.

* chore: test logic adjust to support cnpm modules

* chore: add locale alias

* docs: /index to /

* docs: add locale redirect head script

* chore: adjust compact

* docs: fix missing token

* feat: compact switch

* chore: code clean

* docs: update home

* docs: fix radius token

* docs: hash of it

* chore: adjust home page

* docs: Add background map

* docs: site theme bac logic

* docs: avatar

* docs: update logo color

* docs: home banner

* docs: adjust tour size

* docs: purepanl update

* docs: transfooter

* docs: update banner gif

* docs: content (#38361)

* docs: title & EditButton

* docs: content

* chore: fix toc

* docs: resource page

* docs: transform resource data from hast

* docs: filename & Resource Card

* chore: enable prerender

* chore: remove less

* docs: toc style

* chore: fix lint

* docs: fix Layout page

* docs: fix CP page

* chore: update demos

* docs: workaround for export dynamic html

* chore: enable demo eslint

* docs: table style

* fix: header shadow

* chore: update snapshot

* fix: toc style

* docs: add title

* docs: Adjust site

* feat: helmet

* docs: site css

* fix: description

* feat: toc debug

* docs: update config-provider

* feat: use colorPanel

* fix: colorPanel value

* feat: anchor ink ball style

* feat: apply theme editor

* fix: code block style

* chore: update demo

* chore: fix lint

* chore: code clean

* chore: update snapshot

* feat: ts2js

* chore: description

* docs: site ready for ssr

includes:
- move client render logic to useEffect in site theme
- extract antd cssinjs to a single css file like bisheng
- workaround to support react@18 pipeableStream for emotion

* chore: bump testing lib

* docs: font size of title

* chore: remove react-sortable-hoc

* chore: update snapshot

* chore: update script

Co-authored-by: PeachScript <scdzwyxst@gmail.com>
Co-authored-by: MadCcc <1075746765@qq.com>
Co-authored-by: zqran <uuxnet@gmail.com>
Co-authored-by: TrickyPi <530257315@qq.com>
Co-authored-by: lijianan <574980606@qq.com>
											
										
										
											2022-11-09 12:28:04 +08:00
+								group: 设计模式
-												docs: Update 4.0 site (#20290)

* init recommend block

* init design pages

* home frames

* add background banner

* hello, Hitu makes the animation

* add media query

* add images

* update types

* add declare

* preload support

* update ignore

* additional ignore site Home lint

* update ignore

* add hover effect

* adjust alt of bannber

* adjust lang & card shadow

* fix typo

* adjust desc

* hitu in english

* article add link

* Certainty is hitu

* Meaning Hitu

* Growth with Hitu

* Natural Hitu

* slow down of Natural

* adjust speed of icons

* New Meaning animation

* adjust animation duration

* update card link

* update link

* values doc

* replace images

* faster Growth

* update values

* fix lint

* all slow down

* adjust padding

* update icons

* adjust margin

* update images

* adjust montion

* adjust by designer

* update pages

* update design prod

* update articles

* update site style

* update doc

* update images

* update style

* lint fix

* adjust liner color

* github text color update

* adjust margin of title

* mobile design

* update design sub card

* update style

* less lint

* update images

* design card auto height

* update img

* update logo transition

* adjust card style

* adjust style to fix 184

* adjust nav style

* category it

* slow down of logo

* update style

* hide video link

* hitu article

* use img of hitu

* update docs

* style lint

* update Hitu layout doc

* update images

* speed up logo

* update link

* clean up

* clean up

* update doc

* adjust doc

* update images

											
										
										
											2019-12-26 15:27:52 +08:00
+								type: 原则
-												docs: update documentation format

											
										
										
											2016-03-31 14:17:09 +08:00
+								order: 1
-												docs: update docs details

											
										
										
											2016-09-21 11:28:38 +08:00
+								title: 亲密性
-												docs: update documentation format

											
										
										
											2016-03-31 14:17:09 +08:00
+								---
-												Add new pages

											
										
										
											2016-03-08 17:02:45 +08:00
-												update docs

											
										
										
											2016-03-14 15:01:00 +08:00
+								如果信息之间关联性越高，它们之间的距离就应该越接近，也越像一个视觉单元；反之，则它们的距离就应该越远，也越像多个视觉单元。亲密性的根本目的是实现组织性，让用户对页面结构和信息层次一目了然。
-												Add new pages

											
										
										
											2016-03-08 17:02:45 +08:00
-												fix docs

											
										
										
											2016-03-11 16:00:51 +08:00
+								---
-												Add new pages

											
										
										
											2016-03-08 17:02:45 +08:00
+								## 纵向间距关系
-												docs: preview images in markdown (#39739)

* feat: site previewImage

* feat: site previewImage

* feat: use image

* feat: update doc

* feat: delete align="right"

* feat: update doc

* feat: delete css

* feat: update doc

* feat: delete align="right"

* feat: update doc
											
										
										
											2022-12-24 18:11:43 +08:00
+								<img class="preview-img" alt="纵向间距示例" description="在 Ant Design 中，这三种规格分别为：8px（小号间距）、16px（中号间距）、24px（大号间距）。" src="https://gw.alipayobjects.com/zos/rmsportal/goazWUHPXsGEDFIGsNlm.png">
-												Add design principles

											
										
										
											2016-03-08 17:45:19 +08:00
-												docs: Update proximity.zh-CN.md (#28956)

修改文案
											
										
										
											2021-01-21 10:52:00 +08:00
+								通过「小号间距」、「中号间距」、「大号间距」这三种规格来划分信息层次结构。
-												Add new pages

											
										
										
											2016-03-08 17:02:45 +08:00
-												Add pictures

											
										
										
											2016-03-08 21:03:05 +08:00
+								<br>
-												docs: preview images in markdown (#39739)

* feat: site previewImage

* feat: site previewImage

* feat: use image

* feat: update doc

* feat: delete align="right"

* feat: update doc

* feat: delete css

* feat: update doc

* feat: delete align="right"

* feat: update doc
											
										
										
											2022-12-24 18:11:43 +08:00
+								<img class="preview-img" alt="增加元素示例" description="通过增加「分割线」来拉开层次。" src="https://gw.alipayobjects.com/zos/rmsportal/XNFCsupiYDBTJFQkmOmv.png">
-												Add design principles

											
										
										
											2016-03-08 17:45:19 +08:00
-												docs: Update 4.0 site (#20486)

* adjust docs & logo

* adjust typo

* doc update

* update style & trans

* fix style

* update doc

* update translate

											
										
										
											2019-12-28 11:57:41 +08:00
+								在这三种规格不适用的情况下，可以通过加减「基础间距」的倍数，或者增加元素来拉开信息层次。
-												Add new pages

											
										
										
											2016-03-08 17:02:45 +08:00
-												docs: Update 4.0 site (#20486)

* adjust docs & logo

* adjust typo

* doc update

* update style & trans

* fix style

* update doc

* update translate

											
										
										
											2019-12-28 11:57:41 +08:00
+								> 注：在 Ant Design 中，`y = 8 + 8 * n`。其中，`n >= 0`，y 是纵向间距，8 是「基础间距」。
-												Add new pages

											
										
										
											2016-03-08 17:02:45 +08:00
-												fix docs

											
										
										
											2016-03-11 16:00:51 +08:00
+								---
-												Add new pages

											
										
										
											2016-03-08 17:02:45 +08:00
+								## 横向间距关系
-												docs: preview images in markdown (#39739)

* feat: site previewImage

* feat: site previewImage

* feat: use image

* feat: update doc

* feat: delete align="right"

* feat: update doc

* feat: delete css

* feat: update doc

* feat: delete align="right"

* feat: update doc
											
										
										
											2022-12-24 18:11:43 +08:00
+								<img class="preview-img" alt="组合排布示例" src="https://gw.alipayobjects.com/zos/rmsportal/uYvsqAUXNaqURGIhZhxz.png">
-												Add design principles

											
										
										
											2016-03-08 17:45:19 +08:00
-												Add new pages

											
										
										
											2016-03-08 17:02:45 +08:00
+								为了适用不同尺寸的屏幕，在横向采用栅格布局来排布组件，从而保证布局的灵活性。
-												Add pictures

											
										
										
											2016-03-08 21:03:05 +08:00
+								<br>
-												docs: preview images in markdown (#39739)

* feat: site previewImage

* feat: site previewImage

* feat: use image

* feat: update doc

* feat: delete align="right"

* feat: update doc

* feat: delete css

* feat: update doc

* feat: delete align="right"

* feat: update doc
											
										
										
											2022-12-24 18:11:43 +08:00
+								<img class="preview-img" alt="复选框内示例" src="https://gw.alipayobjects.com/zos/rmsportal/ysXfdKqmdDRAimBiKVGS.png">
-												Add design principles

											
										
										
											2016-03-08 17:45:19 +08:00
-												Add new pages

											
										
										
											2016-03-08 17:02:45 +08:00
+								在一个组件内部，元素的横向间距也应该有所不同。