mirror of
https://github.com/ant-design/ant-design.git
synced 2024-11-29 13:47:02 +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>
142 lines
5.9 KiB
Markdown
142 lines
5.9 KiB
Markdown
---
|
||
group: Design Patterns
|
||
type: Template Document
|
||
order: 3
|
||
title: Detail Page
|
||
---
|
||
|
||
Detail Pages display the complete data to users. Users can edit the information or do other operations.
|
||
|
||
## Design Goals
|
||
|
||
To increase the information viewing and searching efficiency. To raise the convenience of operation.
|
||
|
||
## Design Principles
|
||
|
||
<div class="design-inline-cards">
|
||
<div>
|
||
<img src="https://gw.alipayobjects.com/mdn/rms_08e378/afts/img/A*3CfhSZLxsIEAAAAAAAAAAABkARQnAQ" />
|
||
<div>
|
||
<h4>Direct</h4>
|
||
<p>Try to display the information as flat as possible. Do not hide or fold up the content if not necessary.</p>
|
||
</div>
|
||
</div>
|
||
<div>
|
||
<img src="https://gw.alipayobjects.com/mdn/rms_08e378/afts/img/A*lN6IRbhv8fIAAAAAAAAAAABkARQnAQ" />
|
||
<div>
|
||
<h4>Clear hierarchy</h4>
|
||
<p>In order to decrease the information complexity on each page, put information in levels and groups, following the principle of proximity.</p>
|
||
</div>
|
||
</div>
|
||
<div>
|
||
<img src="https://gw.alipayobjects.com/mdn/rms_08e378/afts/img/A*jXDwQ6NF7dIAAAAAAAAAAABkARQnAQ" />
|
||
<div>
|
||
<h4>Concise</h4>
|
||
<p>Reduce the use of complex structures, try to use similar layouts and modules to reduce the interference of structural differences to users, and let them focus on information itself.</p>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
## Typical Templates
|
||
|
||
### Basic Layouts
|
||
|
||
<img class="preview-img no-padding" align="right" src="https://gw.alipayobjects.com/zos/antfincdn/pCRKNg9k17/1bd63a4b-d1f4-4e07-b22a-d473846ffa4c.png">
|
||
|
||
Basic Detail Pages directly show all the information at the same level of hierarchy. We suggest such method of displaying data.
|
||
|
||
#### [Basic Detail Templates](https://preview.pro.ant.design/profile/basic)
|
||
|
||
<img class="preview-img no-padding" align="right" src="https://gw.alipayobjects.com/zos/antfincdn/mbOatwyvyE/0fb8dd2b-b0d6-4833-8eef-4b9bb403eece.png">
|
||
|
||
Basic layout templates display the main information on one whole card, using non-column split lines to separate the content into groups.
|
||
|
||
**When to use**
|
||
|
||
To display information with less content and low complexity.
|
||
|
||
#### Document Detail Templates
|
||
|
||
<img class="preview-img no-padding" align="right" src="https://gw.alipayobjects.com/zos/antfincdn/scYc%24%24mD8l/17738081-f446-417b-9b32-a8c30de2f221.png">
|
||
|
||
Document Detail Templates display the detailed information of approval documents. They use cards to separate the modules with complex content.
|
||
|
||
**When to use**
|
||
|
||
To display approval process and detailed approval information, as well as some approval operations.
|
||
|
||
**Related operations**
|
||
|
||
Pass, reject, transfer, sign, suspend and withdraw.
|
||
|
||
### Complex Layouts
|
||
|
||
<img class="preview-img no-padding" align="right" src="https://gw.alipayobjects.com/zos/antfincdn/B76lyJVA80/3c938d7e-06a8-464c-b70c-5b2bebfcd638.png">
|
||
|
||
Deal with complex details in the following way: Divide information with high complexity and weak correlation into multiple parts. And put the parts into groups according to their relativities, with tabs, steps, cards, etc.
|
||
|
||
#### [Advanced Detail Templates](https://preview.pro.ant.design/profile/advanced)
|
||
|
||
<img class="preview-img no-padding" align="right" src="https://gw.alipayobjects.com/zos/antfincdn/%241vXHbjQ2A/ad454bfb-55d8-43b1-b1fb-adfbc889045c.png">
|
||
|
||
<img class="preview-img no-padding" align="right" src="https://gw.alipayobjects.com/zos/antfincdn/O0dPbOqGT0/07b6e341-2186-4a20-bc2c-513d91d3faa8.png">
|
||
|
||
**When to use**
|
||
|
||
When the detail page has large and complex content, it has to be split into multiple tabs to guide users to browse information.
|
||
|
||
#### Publish Process Templates
|
||
|
||
<img class="preview-img no-padding" align="right" src="https://gw.alipayobjects.com/zos/antfincdn/zMjpjg%24oaY/a9b7e996-ca9a-45d8-afbb-3c1727208629.png">
|
||
|
||
Divide the content into steps, letting users to browse and operate step by step.
|
||
|
||
**When to use**
|
||
|
||
Such templates are suitable for developing and collaborating processes.
|
||
|
||
## Design Suggestions
|
||
|
||
#### How to choose template
|
||
|
||
<img class="preview-img no-padding" align="right" src="https://gw.alipayobjects.com/zos/antfincdn/1uy%243Y6SRp/1a6ff7f8-4cd0-483b-b8a5-c8d49c63fa92.png">
|
||
|
||
Based on information complexity and correlation model, choose related modes to present the information, and select suitable layouts to display the contents of detail pages.
|
||
|
||
#### Separation Methods
|
||
|
||
<img class="preview-img no-padding" align="right" src="https://gw.alipayobjects.com/zos/antfincdn/gadw%26gZBCW/f8c03ba9-73ae-40f6-b687-c322ecf963cb.png">
|
||
|
||
Conclude the closeness of each information module according to the relevance among them. Usually, the more relevant the contents are, the closer they are to each other.
|
||
|
||
- Non-column split lines: to separate relevant contents;
|
||
- Full-column split lines: to divide the content into multiple parts;
|
||
- Cards: to display information on one topic;
|
||
- Tabs: to put the information into groups according to some feature, such as version, intention, phase, etc.
|
||
|
||
#### Content Components
|
||
|
||
<img class="preview-img no-padding" align="right" src="https://gw.alipayobjects.com/zos/antfincdn/J7ccrSNpjz/89878d45-ca15-4a6a-853e-3281fe02f114.png">
|
||
|
||
Select presentation modes of the information according to its types and complexity. Abased on the complexity from low to high, the followings are available components:
|
||
|
||
## Read more
|
||
|
||
#### Related Global Rules
|
||
|
||
- [Data Format](/docs/spec/data-format)
|
||
- [Button](/docs/spec/buttons)
|
||
|
||
#### Related Modules or Components
|
||
|
||
- [Description](/components/descriptions/)
|
||
- [Collapse](/components/collapse/)
|
||
- [Table](/components/table/)
|
||
|
||
#### Reference
|
||
|
||
- [Fiori – How to Design an Object Page](https://blogs.sap.com/2017/08/06/fiori-elements-how-to-design-an-object-page/)
|
||
- [SAP Fiori 2.0: The Object Page —— Part 1: It's History](https://experience.sap.com/skillup/sap-fiori-2-0-the-object-page-part-1-its-history/)
|
||
- [Object Page Floorplan](https://experience.sap.com/fiori-design-web/object-page/)
|
||
- [Principle of Product Display in Supermarkets](https://experience.sap.com/fiori-design-web/object-page/)
|