mirror of
https://github.com/ant-design/ant-design.git
synced 2024-12-16 01:29:11 +08:00
cbcfd38ca7
* 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 028265d3ba
.
* 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>
347 lines
9.0 KiB
Markdown
347 lines
9.0 KiB
Markdown
---
|
||
group: 全局样式
|
||
order: 6
|
||
title: 阴影
|
||
---
|
||
|
||
阴影来源于现实生活的反映物体与物体之间距离的物理现象。在界面中,我们往往通过模拟元素的投影直截了当的来告诉用户,元素之间的高度距离与层次关系。
|
||
|
||
## 高度
|
||
|
||
阴影是由两个不同阶层的平面产生,且强度由两者之间的距离决定。所以物体的高度直接影响物体的阴影,对象离地面越远阴影越大,模糊值越高。我们将系统分为无、低、中、高四个 UI 层级,各自分布在不同的高度层级,阴影属性也有所不同。
|
||
|
||
<div>
|
||
<img class="preview-img no-padding" src="https://gw.alipayobjects.com/mdn/rms_08e378/afts/img/A*o-OFQK5hJP0AAAAAAAAAAABkARQnAQ" alt="高度">
|
||
</div>
|
||
|
||
**第 0 层**:物体紧贴地面,投影与物体完全重叠,在界面中不对此层定义阴影值。如:输入框等;
|
||
|
||
<div>
|
||
<img class="preview-img no-padding" src="https://gw.alipayobjects.com/mdn/rms_08e378/afts/img/A*li3zQbxRuOMAAAAAAAAAAABkARQnAQ" alt="高度">
|
||
</div>
|
||
|
||
**第 1 层**: 物体位于低层级,此时物体被操作(悬停、点击等)触发为悬浮状态,当操作完成或取消时,悬停状态反馈也跟随消失,物体回归到原有的层级中,如:卡片 hover 等;
|
||
|
||
<div>
|
||
<img class="preview-img no-padding" src="https://gw.alipayobjects.com/mdn/rms_08e378/afts/img/A*mXnoSI8MWuEAAAAAAAAAAABkARQnAQ" alt="高度">
|
||
</div>
|
||
|
||
**第 2 层**:物体位于中层级,此时物体与基准面的关系是展开并跟随,物体由地面上的元素展开产生,会跟随元素所在层级的移动而移动,如:下拉面板等;
|
||
|
||
<div>
|
||
<img class="preview-img no-padding" src="https://gw.alipayobjects.com/mdn/rms_08e378/afts/img/A*yNOwR6Gqy4MAAAAAAAAAAABkARQnAQ" alt="高度">
|
||
</div>
|
||
|
||
**第 3 层**:物体位于高层级,该物体的运动和其他层级没有关联,如:对话框等。
|
||
|
||
<div>
|
||
<img class="preview-img no-padding" src="https://gw.alipayobjects.com/mdn/rms_08e378/afts/img/A*4pFoR4gWL2oAAAAAAAAAAABkARQnAQ" alt="高度">
|
||
</div>
|
||
|
||
## 光源
|
||
|
||
阴影的方向是由光源与物体的相对位置所决定的。假定光源所处高度不变,光源与物体的距离和物体与阴影的距离成正比。光源越远,则阴影距离物体越远。阴影的方向在界面里通常使用 `X, Y` 坐标轴来表示。
|
||
|
||
<div>
|
||
<img class="preview-img no-padding" src="https://gw.alipayobjects.com/mdn/rms_08e378/afts/img/A*KgGmQ79c38oAAAAAAAAAAABkARQnAQ" alt="光源">
|
||
</div>
|
||
|
||
## 阴影值
|
||
|
||
综上可知。阴影由光照而产生。主要影响其值的是物体高度与光源位置:
|
||
|
||
1. 在不同高度上时,投射出的阴影颜色、模糊度、面积都有所区分。离地面越远的物体,产生的阴影颜色越淡、模糊度越高、面积越大;反之则颜色更深、模糊度越低、面积越小;
|
||
|
||
2. 而投影的方向主要由光源与物体的相对位置决定。
|
||
|
||
在 Ant Design 中不同的阴影方向使用在不同的地方:
|
||
|
||
- 阴影向下:主要应用于组件内部或组件本身,是比较常规场景的用法
|
||
- 阴影向上:主要应用于底部导航或工具栏等
|
||
- 阴影向左:主要应用于右边导航栏、抽屉组件或固定表格栏
|
||
- 阴影向右:主要应用于左边导航栏、抽屉组件或固定表格栏
|
||
|
||
阴影是模拟的真实世界的反馈,Ant Design 为了更符合真实阴影,在 4.0 中采用了三层阴影的表达方式,让阴影更柔和,更符合真实状态
|
||
|
||
<div>
|
||
<img class="preview-img no-padding" src="https://gw.alipayobjects.com/mdn/rms_08e378/afts/img/A*1oijTJh2HEIAAAAAAAAAAABkARQnAQ" alt="阴影值">
|
||
</div>
|
||
|
||
### 常用阴影设计表
|
||
|
||
**第一层:**
|
||
|
||
<table>
|
||
<thead>
|
||
<tr>
|
||
<th>阴影类型</th>
|
||
<th>阴影颜色(rgba)</th>
|
||
<th>方向(X, Y)</th>
|
||
<th>模糊度(Blur)</th>
|
||
<th>扩展值(Spread)</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td rowSpan="3">@shadow-1-up</td>
|
||
<td>rgba(0, 0, 0, 0.16)</td>
|
||
<td>0px, -1px</td>
|
||
<td>2px</td>
|
||
<td>-2px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>rgba(0, 0, 0, 0.12)</td>
|
||
<td>0px, -3px</td>
|
||
<td>6px</td>
|
||
<td>0px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>rgba(0, 0, 0, 0.09)</td>
|
||
<td>0px, -5px</td>
|
||
<td>12px</td>
|
||
<td>4px</td>
|
||
</tr>
|
||
<tr>
|
||
<td rowSpan="3">@shadow-1-down</td>
|
||
<td>rgba(0, 0, 0, 0.16)</td>
|
||
<td>0px, 1px</td>
|
||
<td>2px</td>
|
||
<td>-2px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>rgba(0, 0, 0, 0.12)</td>
|
||
<td>0px, 3px</td>
|
||
<td>6px</td>
|
||
<td>0px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>rgba(0, 0, 0, 0.09)</td>
|
||
<td>0px, 5px</td>
|
||
<td>12px</td>
|
||
<td>4px</td>
|
||
</tr>
|
||
<tr>
|
||
<td rowSpan="3">@shadow-1-left</td>
|
||
<td>rgba(0, 0, 0, 0.16)</td>
|
||
<td>-1px, 0px</td>
|
||
<td>2px</td>
|
||
<td>-2px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>rgba(0, 0, 0, 0.12)</td>
|
||
<td>-3px, 0px</td>
|
||
<td>6px</td>
|
||
<td>0px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>rgba(0, 0, 0, 0.09)</td>
|
||
<td>-5px, 0px</td>
|
||
<td>12px</td>
|
||
<td>4px</td>
|
||
</tr>
|
||
<tr>
|
||
<td rowSpan="3">@shadow-1-right</td>
|
||
<td>rgba(0, 0, 0, 0.16)</td>
|
||
<td>1px, 0px</td>
|
||
<td>2px</td>
|
||
<td>-2px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>rgba(0, 0, 0, 0.12)</td>
|
||
<td>3px, 0px</td>
|
||
<td>6px</td>
|
||
<td>0px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>rgba(0, 0, 0, 0.09)</td>
|
||
<td>5px, 0px</td>
|
||
<td>12px</td>
|
||
<td>4px</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
|
||
**第二层:**
|
||
|
||
<table>
|
||
<thead>
|
||
<tr>
|
||
<th>阴影类型</th>
|
||
<th>阴影颜色(rgba)</th>
|
||
<th>方向(X, Y)</th>
|
||
<th>模糊度(Blur)</th>
|
||
<th>扩展值(Spread)</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td rowSpan="3">@shadow-2-up</td>
|
||
<td>rgba(0, 0, 0, 0.12)</td>
|
||
<td>0px, -3px</td>
|
||
<td>6px</td>
|
||
<td>-4px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>rgba(0, 0, 0, 0.08)</td>
|
||
<td>0px, -6px</td>
|
||
<td>16px</td>
|
||
<td>0px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>rgba(0, 0, 0, 0.05)</td>
|
||
<td>0px, -9px</td>
|
||
<td>28px</td>
|
||
<td>8px</td>
|
||
</tr>
|
||
<tr>
|
||
<td rowSpan="3">@shadow-2-down</td>
|
||
<td>rgba(0, 0, 0, 0.12)</td>
|
||
<td>0px, 3px</td>
|
||
<td>6px</td>
|
||
<td>-4px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>rgba(0, 0, 0, 0.08)</td>
|
||
<td>0px, 6px</td>
|
||
<td>16px</td>
|
||
<td>0px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>rgba(0, 0, 0, 0.05)</td>
|
||
<td>0px, 9px</td>
|
||
<td>28px</td>
|
||
<td>8px</td>
|
||
</tr>
|
||
<tr>
|
||
<td rowSpan="3">@shadow-2-left</td>
|
||
<td>rgba(0, 0, 0, 0.12)</td>
|
||
<td>-3px, 0px</td>
|
||
<td>6px</td>
|
||
<td>-4px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>rgba(0, 0, 0, 0.08)</td>
|
||
<td>-6px, 0px</td>
|
||
<td>16px</td>
|
||
<td>0px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>rgba(0, 0, 0, 0.05)</td>
|
||
<td>-9px, 0px</td>
|
||
<td>28px</td>
|
||
<td>8px</td>
|
||
</tr>
|
||
<tr>
|
||
<td rowSpan="3">@shadow-2-right</td>
|
||
<td>rgba(0, 0, 0, 0.12)</td>
|
||
<td>3px, 0px</td>
|
||
<td>6px</td>
|
||
<td>-4px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>rgba(0, 0, 0, 0.08)</td>
|
||
<td>6px, 0px</td>
|
||
<td>16px</td>
|
||
<td>0px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>rgba(0, 0, 0, 0.05)</td>
|
||
<td>9px, 0px</td>
|
||
<td>28px</td>
|
||
<td>8px</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
|
||
**第三层:**
|
||
|
||
<table>
|
||
<thead>
|
||
<tr>
|
||
<th>阴影类型</th>
|
||
<th>阴影颜色(rgba)</th>
|
||
<th>方向(X, Y)</th>
|
||
<th>模糊度(Blur)</th>
|
||
<th>扩展值(Spread)</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td rowSpan="3">@shadow-3-up</td>
|
||
<td>rgba(0, 0, 0, 0.08)</td>
|
||
<td>0px, -6px</td>
|
||
<td>16px</td>
|
||
<td>-8px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>rgba(0, 0, 0, 0.05)</td>
|
||
<td>0px, -9px</td>
|
||
<td>28px</td>
|
||
<td>0px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>rgba(0, 0, 0, 0.03)</td>
|
||
<td>0px, -12px</td>
|
||
<td>48px</td>
|
||
<td>16px</td>
|
||
</tr>
|
||
<tr>
|
||
<td rowSpan="3">@shadow-3-down</td>
|
||
<td>rgba(0, 0, 0, 0.08)</td>
|
||
<td>0px, 6px</td>
|
||
<td>16px</td>
|
||
<td>-8px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>rgba(0, 0, 0, 0.05)</td>
|
||
<td>0px, 9px</td>
|
||
<td>28px</td>
|
||
<td>0px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>rgba(0, 0, 0, 0.03)</td>
|
||
<td>0px, 12px</td>
|
||
<td>48px</td>
|
||
<td>16px</td>
|
||
</tr>
|
||
<tr>
|
||
<td rowSpan="3">@shadow-3-left</td>
|
||
<td>rgba(0, 0, 0, 0.08)</td>
|
||
<td>-6px, 0px</td>
|
||
<td>16px</td>
|
||
<td>-8px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>rgba(0, 0, 0, 0.05)</td>
|
||
<td>-9px, 0px</td>
|
||
<td>28px</td>
|
||
<td>0px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>rgba(0, 0, 0, 0.03)</td>
|
||
<td>-12px, 0px</td>
|
||
<td>48px</td>
|
||
<td>16px</td>
|
||
</tr>
|
||
<tr>
|
||
<td rowSpan="3">@shadow-3-right</td>
|
||
<td>rgba(0, 0, 0, 0.08)</td>
|
||
<td>6px, 0px</td>
|
||
<td>16px</td>
|
||
<td>-8px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>rgba(0, 0, 0, 0.05)</td>
|
||
<td>9px, 0px</td>
|
||
<td>28px</td>
|
||
<td>0px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>rgba(0, 0, 0, 0.03)</td>
|
||
<td>12px, 0px</td>
|
||
<td>48px</td>
|
||
<td>16px</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|