site: update design documentation

This commit is contained in:
afc163 2017-02-27 18:04:35 +08:00
parent e008214f56
commit 4823ce4d08
21 changed files with 137 additions and 69 deletions

View File

@ -1,7 +0,0 @@
---
order: 1
disabled: true
title: Business
---
TBD Content ...

View File

@ -1,7 +0,0 @@
---
order: 1
disabled: true
title: 业务组件
---
占位。

View File

@ -1,5 +1,5 @@
---
category: 十大原则
category: 设计原则
order: 2
title: 对齐
---

View File

@ -1,11 +1,9 @@
---
order: 0
order: 1
title: Cases
---
Ant Design is a design language for enterprise-like complex UIs.
Starting in April 2015, more and more products of Ant Financial follow Ant Design specification, covering multiple business lines and more than 300 applications.
Starting in April 2015, more and more products of Ant Financial follow Ant Design specification, covering multiple business lines and more than 400 applications.
Designed for enterprise-like complex UIs, used by both professional and non-professional designers,
Ant Design has a low learning curve that helps you getting started fast and achieve rapid results.
@ -60,17 +58,7 @@ Through data mining, it exposes the users's experience and it helps the company'
---
### AntV
<img class="preview-img" width="420" align="right" src="https://os.alipayobjects.com/rmsportal/yWNVSFBhKsoShvi.png">
<img class="preview-img" width="420" align="right" src="https://os.alipayobjects.com/rmsportal/nvJftlNzfzhVDVW.png">
<img class="preview-img" width="420" align="right" src="https://os.alipayobjects.com/rmsportal/LugOCvzybKsmQCj.png">
AntV is a graphical library that is based on the work of a data group team
whose results of exploring data visualization were summarized
and shared them together with the required data visualization theory.
<p><a class="outside-link internal" href="https://antv.alipay.com/" target="_blank">Website</a></p>
更多 [社区案例](https://github.com/ant-design/ant-design/issues/477)。
<style>
.preview-image-boxes {

View File

@ -1,11 +1,9 @@
---
order: 0
order: 1
title: 实践案例
---
Ant Design 是面向中台的 UI 设计语言。
从 2015 年 4 月起Ant Design 在蚂蚁金服中后台产品线迅速推广,对接多条业务线,覆盖系统 300 个以上。定位于中台业务的 Ant Design 兼顾专业和非专业的设计人员,具有学习成本低、上手速度快、实现效果好等特点,并且提供从界面设计到前端开发的全链路生态,可以大大提升设计和开发的效率。
从 2015 年 4 月起Ant Design 在蚂蚁金服中后台产品线迅速推广,对接多条业务线,覆盖系统 400 个以上。定位于中台业务的 Ant Design 兼顾专业和非专业的设计人员,具有学习成本低、上手速度快、实现效果好等特点,并且提供从界面设计到前端开发的全链路生态,可以大大提升设计和开发的效率。
Ant Design 目前在外部也有 [许多产品实践](https://github.com/ant-design/ant-design/issues/477),如果你的公司和产品从中受益,欢迎留言。
@ -51,15 +49,7 @@ OceanBase 是一款真正意义上的云端分布式关系型数据库,而 Oce
---
### AntV
<img class="preview-img" width="420" align="right" src="https://os.alipayobjects.com/rmsportal/yWNVSFBhKsoShvi.png">
<img class="preview-img" width="420" align="right" src="https://os.alipayobjects.com/rmsportal/nvJftlNzfzhVDVW.png">
<img class="preview-img" width="420" align="right" src="https://os.alipayobjects.com/rmsportal/LugOCvzybKsmQCj.png">
AntV 将数据图形小组近几年在探索数据可视化过程中取得的成果进行总结和沉淀,并分享给所有需要数据可视理论的人。
<p><a class="outside-link internal" href="https://antv.alipay.com/" target="_blank">立即访问</a></p>
[More cases](https://github.com/ant-design/ant-design/issues/477) from community.
<style>
.preview-image-boxes {

View File

@ -1,5 +1,5 @@
---
category: 十大原则
category: 设计原则
order: 3
title: 对比
---

View File

@ -1,5 +1,5 @@
---
category: 十大原则
category: 设计原则
order: 5
title: 直截了当
---

113
docs/spec/feature.en-US.md Normal file
View File

@ -0,0 +1,113 @@
---
order: 1
title:
zh-CN: 基本理念
en-US: Features
---
Unlike other design specifications, Ant Design pursues not only user expirerence, but also expirerence of desigers and developers, which practice a humanist design idea.
<div style="margin-left:-40px;margin-right:-40px;overflow:hidden;margin-top:30px;">
<div class="ant-col-8 features">
<img src="https://os.alipayobjects.com/rmsportal/OVirOHTeAdzDBuQ.png">
<h5>Subtleties</h5>
<div>By devoted to create tiny and beautiful change, make efforts in details, we could not only make products more solid and reliable, but also bring good suprises for users.</div>
</div>
<div class="ant-col-8 features">
<img src="https://os.alipayobjects.com/rmsportal/iJbUiLYpuPBXUhV.png">
<h5>Definiteness</h5>
<div>Create an atmosphere of high definiteness and lower entropy, by making simple and scientific design patterns and using the same communicate channel.</div>
</div>
<div class="ant-col-8 features">
<img src="https://os.alipayobjects.com/rmsportal/uSOjjlCRjRIhtIY.png">
<h5>Happiness</h5>
<div>Don't design for minimalismdesign for getting job done and whatever makes designer happy and satisfied.</div>
</div>
</div>
<style>
.features {
padding: 0 40px;
font-size: 12px;
}
.features h5 {
font-size: 14px;
margin-top: 16px;
}
@media only screen and (min-width: 320px) and (max-width: 767px) {
.features {
width: 100%;
text-align: center;
margin-bottom: 20px;;
}
.features img {
width: 80%;
}
}
</style>
---
## Subtleties
### Micro innovation
<img class="preview-img" align="right" alt="Number Input Sample" description="鼠标『悬停』时,可点击区域会放大。" src="https://os.alipayobjects.com/rmsportal/GGXdyrOtvUtOKXe.png">
<img class="preview-img" align="right" alt="Pagination Sample" description="鼠标点击省略符,可以实现批量切换。" src="https://os.alipayobjects.com/rmsportal/UEYPnVhQsOjytSa.png">
<img class="preview-img" align="right" alt="Charactor Count Sample" description="使用颜色和下划线标注超出的文案,系统即时反应,以便用户进行调整。" src="https://os.alipayobjects.com/rmsportal/JxzQIRfMCtMjuaH.png">
"Diffrerence" is not always "better", but "better" is always different. Pursuing "better" in every details make our components is different, and also better naturally.
### Compositive innovation
<img class="preview-img" align="right" alt="Input inside text" description="组合了标签和输入项,可以帮助用户理解当前的状况,以及需要提供什么数据。" src="https://os.alipayobjects.com/rmsportal/RGFMJRSgCAVCKOl.png">
<img class="preview-img" align="right" alt="Table with charts" description="组合了 Table 和 Chart ,鼠标『悬停』时展现更多详情内容。" src="https://os.alipayobjects.com/rmsportal/hjHOMRIbvIUUBXS.png">
选择合适的组件进行组合和集成,形成优势互补的创新过程,来满足多变的业务需求。
Compose different components for more powerful functions, it is a good path to meet varies of different bussiness requirements.
---
## Definiteness
### Object oriented
<img class="preview-img" align="right" alt="Color Sample" description="定义『原色』后,用『加黑』和『加白』的方式快速、科学的得出 Normal、Hover 等多个『状态色』。" src="https://os.alipayobjects.com/rmsportal/MqsXoBBSDmoEDqn.png">
<img class="preview-img" align="right" alt="Typography Sample" description="运用『亲密性』原则,只需定义 n 的值,就可以得出确定的间距。" src="https://os.alipayobjects.com/rmsportal/WNEbRORxzEvvFKy.png">
<img class="preview-img no-padding good" align="right" alt="Feedback - Good" description="将可被通用的文案抽象成『确定』、『操作』等通用术语,集中进行调用和维护。虽然『用户』体验 -1 分,但是『设计者』体验 +5 分。" src="https://os.alipayobjects.com/rmsportal/rtbYGKfPOpWRJID.png">
<img class="preview-img no-padding bad" align="right" alt="Feedback - Bad" description="这是体验更好的反馈方式,但是对『设计者』来说是灾难。因为这些『删除』文案只能通过人肉维护,难免产生遗漏和错别字,增大了系统的不确定性,这在多人合作和需求变更时尤为明显。" src="https://os.alipayobjects.com/rmsportal/OWLtvGCGmqawyPt.png">
We create a object-oriented design method and abstract UI patterns. That help us to do our jobs with continuity.
### Scientific design principles
See more at [『design principles』](/docs/spec/principle).
---
## Happiness
### Happiness of user
<img class="preview-img no-padding" align="right" alt="User Happiess Levels" description="想了解更多内容可阅读唐纳德•A•诺曼所著的 《设计心理学 3》。" src="https://os.alipayobjects.com/rmsportal/sBjNEGgHEpNfqTs.png">
Beatuful looks, tide typography and smooth animation produce positive reaction at instinct level.
Good functions, perfermance and usability produce positive reaction at behavious level.
Self-image, satisfaction, and good memories bring user a combining expirerence of thoughts and emotions at learning level.
### Happiness of designer
<img class="preview-img no-padding" align="right" alt="Designer Happiess" description="Ant Design 无法保证业务产品能否成功,但是能帮助业务产品『正确的成功』或者『正确的失败』。" src="https://os.alipayobjects.com/rmsportal/eMcdBWuZxRbvlvW.png">
From 0 to 1, Ant Design help designers to implement a quick prototype for trial and error.
From 1 to 100, Ant Design provide a complete UI solution, help designers to create their own product personality and improve user expirerence.

View File

@ -1,11 +1,11 @@
---
order: 1
title:
zh-CN: 三大特性
zh-CN: 基本理念
en-US: Features
---
与众不同的是Ant Design 不但追求『用户』的使用体验,还追求『设计者』的使用体验,真真正正贯彻和践行『以人为本』的设计理念。
与众不同的是Ant Design 不但追求『用户』的使用体验,还追求『设计者』和『开发者』的使用体验,践行『以人为本』的设计理念。
<div style="margin-left:-40px;margin-right:-40px;overflow:hidden;margin-top:30px;">
<div class="ant-col-8 features">
@ -58,7 +58,7 @@ title:
<img class="preview-img" align="right" alt="字数校验框示例" description="使用颜色和下划线标注超出的文案,系统即时反应,以便用户进行调整。" src="https://os.alipayobjects.com/rmsportal/JxzQIRfMCtMjuaH.png">
『不同』不一定『更好』,但是『更好』一定『不同』。不断追求细节上的『更好』,使得我们的组件和同类产品都不一样,自然而然的『不同』
『不同』不一定『更好』,但是『更好』一定『不同』。不断追求细节上的『更好』,使得我们的组件和同类产品都不一样,自然而然的更好
### 集成创新
@ -86,7 +86,7 @@ title:
### 通俗而科学的设计原则
详见[『十大原则』](/docs/spec/principle)。
详见[『设计原则』](/docs/spec/principle)。
---

View File

@ -1,5 +1,5 @@
---
category: 十大原则
category: 设计原则
order: 8
title: 提供邀请
---

View File

@ -1,5 +1,5 @@
---
category: 十大原则
category: 设计原则
order: 6
title: 简化交互
---

View File

@ -1,12 +1,12 @@
---
category: 十大原则
category: 设计原则
order: 0
title: 引言
---
『好设计比差设计更难发现』,因为好设计是如此的自然,帮助用户轻松的完成目标,以至于用户根本意识不到好设计的存在。
我们借鉴了《写给大家看的设计书》、《Web 界面设计》对设计原则的总结和推理,并结合我们团队的实践和理解,制定了以下十大原则,为『设计者』提供解决具体问题的准则和启示。
我们借鉴了《写给大家看的设计书》、《Web 界面设计》对设计原则的总结和推理,并结合我们团队的实践和理解,制定了以下设计原则,为『设计者』提供解决具体问题的准则和启示。
> 注:设计原则是对具象设计的抽象和总结,然而产品是一个整体,用户对整个产品的认知也是从全局到局部,所以忽略全局,只在局部套用原则是不可取的。对于这些原则,『设计者』应当理性地学会它,而后勇敢地抛弃它。

View File

@ -1,5 +1,5 @@
---
category: 十大原则
category: 设计原则
order: 1
title: 亲密性
---

View File

@ -1,5 +1,5 @@
---
category: 十大原则
category: 设计原则
order: 10
title: 即时反应
---

View File

@ -1,5 +1,5 @@
---
category: 十大原则
category: 设计原则
order: 4
title: 重复
---

View File

@ -1,5 +1,5 @@
---
category: 十大原则
category: 设计原则
order: 6
title: 足不出户
---

View File

@ -1,5 +1,5 @@
---
category: 十大原则
category: 设计原则
order: 9
title: 巧用过渡
---

View File

@ -14,7 +14,7 @@ module.exports = {
htmlTemplate: './site/theme/static/template.html',
themeConfig: {
categoryOrder: {
十大原则: 0,
设计原则: 0,
Principles: 0,
设计基础: 1,
'Design Fundamental': 1,

View File

@ -41,7 +41,6 @@ module.exports = {
}
},
'docs/pattern': pickerGenerator('pattern'),
'docs/practice': pickerGenerator('practice'),
'docs/react': pickerGenerator('react'),
'docs/resource': pickerGenerator('resource'),
'docs/spec': pickerGenerator('spec'),
@ -59,9 +58,6 @@ module.exports = {
childRoutes: [{
path: 'index-cn',
component: homeTmpl,
}, {
path: 'docs/practice/:children',
component: contentTmpl,
}, {
path: 'docs/pattern/:children',
component: contentTmpl,

View File

@ -33,7 +33,7 @@ export default function Page1({ location }) {
<h2 key="h2"><FormattedMessage id="app.home.best-practice" /></h2>
<p key="p" style={{ maxWidth: 310 }}><FormattedMessage id="app.home.experience" /></p>
<div key="button">
<Link to={utils.getLocalizedPathname('/docs/practice/cases', utils.isZhCN(location.pathname))}>
<Link to={utils.getLocalizedPathname('/docs/spec/cases', utils.isZhCN(location.pathname))}>
<Button type="primary" size="large">
<FormattedMessage id="app.home.learn-more" />
<Icon type="right" />

View File

@ -174,11 +174,6 @@ export default class Header extends React.Component {
<FormattedMessage id="app.header.menu.pattern" />
</Link>
</Menu.Item>
<Menu.Item key="docs/practice">
<Link to={utils.getLocalizedPathname('/docs/practice/cases', isZhCN)}>
<FormattedMessage id="app.header.menu.practice" />
</Link>
</Menu.Item>
<Menu.Item key="docs/resource">
<Link to={utils.getLocalizedPathname('/docs/resource/download', isZhCN)}>
<FormattedMessage id="app.header.menu.resource" />