home/ant-design
2
0
Fork 0
mirror of https://github.com/wahyd4/ant-design.git synced 2026-08-16 08:16:26 +10:00
Code Issues Packages Projects Releases Wiki Activity
Files
b7f7cb8708a8d55ebef372a0ed65e596cfd8d94f
ant-design/docs/react/use-with-create-react-app-cn.html
T
afc163 231aeb321b Updates
2017-01-22 19:20:51 +08:00

167 lines
44 KiB
HTML
Raw Blame History

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="An enterprise-class UI design language and React-based implementation">
<meta name="description" content="A set of high-quality React components">
<meta name="description" content="One of best React UI library for enterprise background">
<title>Ant Design - A UI Design Language</title>
<link rel="icon" href="https://t.alipayobjects.com/images/T1QUBfXo4fXXXXXXXX.png" type="image/x-icon">
<link rel="stylesheet" type="text/css" href="https://fonts.googleapis.cnpmjs.org/css?family=Lato:400,700|Raleway"/>
<link rel="stylesheet" type="text/css" href="/index.css"/>
<style id="nprogress-style">
#nprogress { display: none }
</style>
<!--[if lte IE 10]>
<script
src="https://as.alipayobjects.com/g/component/??console-polyfill/0.2.2/index.js,media-match/2.0.2/media.match.min.js"></script>
<![endif]-->
<script>
if (!window.Intl) {
document.writeln('<script src="https://as.alipayobjects.com/g/component/intl/1.0.1/??Intl.js,locale-data/jsonp/en.js,locale-data/jsonp/zh.js">' + '<' + '/script>');
}
if (!window.Promise) {
document.writeln('<script src="https://as.alipayobjects.com/g/component/es6-promise/3.2.2/es6-promise.min.js"' + '>' + '<' + '/' + 'script>');
}
</script>
<script>
// Enable Google Analytics
if (!location.port) {
/* eslint-disable */
(function (i, s, o, g, r, a, m) {
i['GoogleAnalyticsObject'] = r;
i[r] = i[r] || function () {
(i[r].q = i[r].q || []).push(arguments)
}, i[r].l = 1 * new Date();
a = s.createElement(o),
m = s.getElementsByTagName(o)[0];
a.async = 1;
a.src = g;
m.parentNode.insertBefore(a, m)
})(window, document, 'script', '//www.google-analytics.com/analytics.js', 'ga');
ga('create', 'UA-72788897-1', 'auto');
ga('send', 'pageview');
/* eslint-enable */
}
</script>
</head>
<body>
<div id="react-content">
<div class="page-wrapper" data-reactroot="" data-reactid="1" data-react-checksum="-629024547"><header id="header" class="clearfix" data-reactid="2"><div class="ant-row" data-reactid="3"><div class="ant-col-xs-24 ant-col-sm-24 ant-col-md-6 ant-col-lg-4" data-reactid="4"><a id="logo" href="/index-cn" data-reactid="5"><img alt="logo" src="https://t.alipayobjects.com/images/rmsweb/T1B9hfXcdvXXXXXXXX.svg" data-reactid="6"/><span data-reactid="7">Ant Design</span></a></div><div class="ant-col-xs-0 ant-col-sm-0 ant-col-md-18 ant-col-lg-20" data-reactid="8"><div id="search-box" data-reactid="9"><div class="ant-select ant-select-combobox ant-select-enabled" data-reactid="10"><div class="ant-select-selection
ant-select-selection--single" role="combobox" aria-autocomplete="list" aria-haspopup="true" aria-expanded="false" data-reactid="11"><div class="ant-select-selection__rendered" data-reactid="12"><div style="display:block;user-select:none;-webkit-user-select:none;" unselectable="unselectable" class="ant-select-selection__placeholder" data-reactid="13">搜索组件...</div><ul data-reactid="14"><li class="ant-select-search ant-select-search--inline" data-reactid="15"><div class="ant-select-search__field__wrap" data-reactid="16"><input value="" class="ant-select-search__field" data-reactid="17"/><span class="ant-select-search__field__mirror" data-reactid="18"></span></div></li></ul></div><span class="ant-select-arrow" style="user-select:none;-webkit-user-select:none;" unselectable="unselectable" data-reactid="19"><b data-reactid="20"></b></span></div></div></div><button type="button" class="ant-btn ant-btn-ghost ant-btn-sm lang" data-reactid="21"><span data-reactid="22">EN</span></button><ul class="ant-menu ant-menu-horizontal ant-menu-light ant-menu-root" role="menu" aria-activedescendant="" id="nav" tabindex="0" data-reactid="23"><li class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="24"><a href="/index-cn" data-reactid="25"><span data-reactid="26">首页</span></a></li><li class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="27"><a href="/docs/spec/introduce-cn" data-reactid="28"><span data-reactid="29">规范</span></a></li><li class="ant-menu-item-selected ant-menu-item" role="menuitem" aria-selected="true" data-reactid="30"><a href="/docs/react/introduce-cn" data-reactid="31"><span data-reactid="32">组件</span></a></li><li class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="33"><a href="/docs/pattern/navigation-cn" data-reactid="34"><span data-reactid="35">模式</span></a></li><li class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="36"><a href="/docs/practice/cases-cn" data-reactid="37"><span data-reactid="38">实践</span></a></li><li class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="39"><a href="/docs/resource/download-cn" data-reactid="40"><span data-reactid="41">资源</span></a></li></ul></div></div></header><div class="main-wrapper" data-reactid="42"><div class="ant-row" data-reactid="43"><div class="ant-col-xs-24 ant-col-sm-24 ant-col-md-6 ant-col-lg-4" data-reactid="44"><ul class="ant-menu ant-menu-inline aside-container ant-menu-light ant-menu-root" role="menu" aria-activedescendant="" tabindex="0" data-reactid="45"><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="46"><a href="/docs/react/introduce-cn" data-reactid="47">Ant Design of React</a></li><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="48"><a href="/docs/react/getting-started-cn" data-reactid="49">快速上手</a></li><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="50"><a href="/docs/react/practical-projects-cn" data-reactid="51">项目实战</a></li><li style="padding-left:24px;" class="ant-menu-item-selected ant-menu-item" role="menuitem" aria-selected="true" data-reactid="52"><a href="/docs/react/use-with-create-react-app-cn" data-reactid="53">在 create-react-app 中使用</a></li><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="54"><a href="/docs/react/customize-theme-cn" data-reactid="55">定制主题</a></li><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="56"><a href="/changelog-cn" data-reactid="57">更新日志</a></li><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="58"><a href="/docs/react/recommendation-cn" data-reactid="59">社区精选组件</a></li><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="60"><a href="https://github.com/websemantics/awesome-ant-design" target="_blank" rel="noopener noreferrer" class="menu-item-link-outside" data-reactid="61"><!-- react-text: 62 -->Awesome Ant Design<!-- /react-text --><!-- react-text: 63 --> <!-- /react-text --><i class="anticon anticon-export" data-reactid="64"></i></a></li><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="65"><a href="//github.com/ant-design/intl-example" target="_blank" rel="noopener noreferrer" class="menu-item-link-outside" data-reactid="66"><!-- react-text: 67 -->i18n 方案<!-- /react-text --><!-- react-text: 68 --> <!-- /react-text --><i class="anticon anticon-export" data-reactid="69"></i></a></li><li class="ant-menu-submenu-inline ant-menu-submenu-open ant-menu-submenu" data-reactid="70"><div style="padding-left:24px;" class="ant-menu-submenu-title" aria-expanded="true" aria-owns="Components$Menu" aria-haspopup="true" data-reactid="71"><h4 data-reactid="72">Components</h4></div><ul class="ant-menu ant-menu-inline ant-menu-sub" role="menu" aria-activedescendant="" id="Components$Menu" data-reactid="73"><li class=" ant-menu-item-group" data-reactid="74"><div class="ant-menu-item-group-title" data-reactid="75">General</div><ul class="ant-menu-item-group-list" data-reactid="76"><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="77"><a href="/components/button-cn/" data-reactid="78"><span data-reactid="79">Button</span><span class="chinese" data-reactid="80">按钮</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="81"><a href="/components/icon-cn/" data-reactid="82"><span data-reactid="83">Icon</span><span class="chinese" data-reactid="84">图标</span></a></li></ul></li><li class=" ant-menu-item-group" data-reactid="85"><div class="ant-menu-item-group-title" data-reactid="86">Layout</div><ul class="ant-menu-item-group-list" data-reactid="87"><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="88"><a href="/components/grid-cn/" data-reactid="89"><span data-reactid="90">Grid</span><span class="chinese" data-reactid="91">栅格</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="92"><a href="/components/layout-cn/" data-reactid="93"><span data-reactid="94">Layout</span><span class="chinese" data-reactid="95">布局</span></a></li></ul></li><li class=" ant-menu-item-group" data-reactid="96"><div class="ant-menu-item-group-title" data-reactid="97">Navigation</div><ul class="ant-menu-item-group-list" data-reactid="98"><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="99"><a href="/components/affix-cn/" data-reactid="100"><span data-reactid="101">Affix</span><span class="chinese" data-reactid="102">固钉</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="103"><a href="/components/back-top-cn/" data-reactid="104"><span data-reactid="105">BackTop</span><span class="chinese" data-reactid="106">回到顶部</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="107"><a href="/components/breadcrumb-cn/" data-reactid="108"><span data-reactid="109">Breadcrumb</span><span class="chinese" data-reactid="110">面包屑</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="111"><a href="/components/dropdown-cn/" data-reactid="112"><span data-reactid="113">Dropdown</span><span class="chinese" data-reactid="114">下拉菜单</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="115"><a href="/components/menu-cn/" data-reactid="116"><span data-reactid="117">Menu</span><span class="chinese" data-reactid="118">导航菜单</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="119"><a href="/components/pagination-cn/" data-reactid="120"><span data-reactid="121">Pagination</span><span class="chinese" data-reactid="122">分页</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="123"><a href="/components/steps-cn/" data-reactid="124"><span data-reactid="125">Steps</span><span class="chinese" data-reactid="126">步骤条</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="127"><a href="/components/tabs-cn/" data-reactid="128"><span data-reactid="129">Tabs</span><span class="chinese" data-reactid="130">标签页</span></a></li></ul></li><li class=" ant-menu-item-group" data-reactid="131"><div class="ant-menu-item-group-title" data-reactid="132">Data Entry</div><ul class="ant-menu-item-group-list" data-reactid="133"><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="134"><a href="/components/auto-complete-cn/" data-reactid="135"><span data-reactid="136">AutoComplete</span><span class="chinese" data-reactid="137">自动完成</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="138"><a href="/components/checkbox-cn/" data-reactid="139"><span data-reactid="140">Checkbox</span><span class="chinese" data-reactid="141">多选框</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="142"><a href="/components/cascader-cn/" data-reactid="143"><span data-reactid="144">Cascader</span><span class="chinese" data-reactid="145">级联选择</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="146"><a href="/components/date-picker-cn/" data-reactid="147"><span data-reactid="148">DatePicker</span><span class="chinese" data-reactid="149">日期选择框</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="150"><a href="/components/form-cn/" data-reactid="151"><span data-reactid="152">Form</span><span class="chinese" data-reactid="153">表单</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="154"><a href="/components/input-cn/" data-reactid="155"><span data-reactid="156">Input</span><span class="chinese" data-reactid="157">输入框</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="158"><a href="/components/input-number-cn/" data-reactid="159"><span data-reactid="160">InputNumber</span><span class="chinese" data-reactid="161">数字输入框</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="162"><a href="/components/mention-cn/" data-reactid="163"><span data-reactid="164">Mention</span><span class="chinese" data-reactid="165">提及</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="166"><a href="/components/radio-cn/" data-reactid="167"><span data-reactid="168">Radio</span><span class="chinese" data-reactid="169">单选框</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="170"><a href="/components/rate-cn/" data-reactid="171"><span data-reactid="172">Rate</span><span class="chinese" data-reactid="173">评分</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="174"><a href="/components/select-cn/" data-reactid="175"><span data-reactid="176">Select</span><span class="chinese" data-reactid="177">选择器</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="178"><a href="/components/slider-cn/" data-reactid="179"><span data-reactid="180">Slider</span><span class="chinese" data-reactid="181">滑动输入条</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="182"><a href="/components/switch-cn/" data-reactid="183"><span data-reactid="184">Switch</span><span class="chinese" data-reactid="185">开关</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="186"><a href="/components/time-picker-cn/" data-reactid="187"><span data-reactid="188">TimePicker</span><span class="chinese" data-reactid="189">时间选择框</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="190"><a href="/components/transfer-cn/" data-reactid="191"><span data-reactid="192">Transfer</span><span class="chinese" data-reactid="193">穿梭框</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="194"><a href="/components/tree-select-cn/" data-reactid="195"><span data-reactid="196">TreeSelect</span><span class="chinese" data-reactid="197">树选择</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="198"><a href="/components/upload-cn/" data-reactid="199"><span data-reactid="200">Upload</span><span class="chinese" data-reactid="201">上传</span></a></li></ul></li><li class=" ant-menu-item-group" data-reactid="202"><div class="ant-menu-item-group-title" data-reactid="203">Data Display</div><ul class="ant-menu-item-group-list" data-reactid="204"><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="205"><a href="/components/badge-cn/" data-reactid="206"><span data-reactid="207">Badge</span><span class="chinese" data-reactid="208">徽标数</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="209"><a href="/components/card-cn/" data-reactid="210"><span data-reactid="211">Card</span><span class="chinese" data-reactid="212">卡片</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="213"><a href="/components/carousel-cn/" data-reactid="214"><span data-reactid="215">Carousel</span><span class="chinese" data-reactid="216">走马灯</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="217"><a href="/components/collapse-cn/" data-reactid="218"><span data-reactid="219">Collapse</span><span class="chinese" data-reactid="220">折叠面板</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="221"><a href="/components/calendar-cn/" data-reactid="222"><span data-reactid="223">Calendar</span><span class="chinese" data-reactid="224">日历</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="225"><a href="/components/popover-cn/" data-reactid="226"><span data-reactid="227">Popover</span><span class="chinese" data-reactid="228">气泡卡片</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="229"><a href="/components/table-cn/" data-reactid="230"><span data-reactid="231">Table</span><span class="chinese" data-reactid="232">表格</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="233"><a href="/components/tag-cn/" data-reactid="234"><span data-reactid="235">Tag</span><span class="chinese" data-reactid="236">标签</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="237"><a href="/components/timeline-cn/" data-reactid="238"><span data-reactid="239">Timeline</span><span class="chinese" data-reactid="240">时间轴</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="241"><a href="/components/tooltip-cn/" data-reactid="242"><span data-reactid="243">Tooltip</span><span class="chinese" data-reactid="244">文字提示</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="245"><a href="/components/tree-cn/" data-reactid="246"><span data-reactid="247">Tree</span><span class="chinese" data-reactid="248">树形控件</span></a></li></ul></li><li class=" ant-menu-item-group" data-reactid="249"><div class="ant-menu-item-group-title" data-reactid="250">Feedback</div><ul class="ant-menu-item-group-list" data-reactid="251"><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="252"><a href="/components/alert-cn/" data-reactid="253"><span data-reactid="254">Alert</span><span class="chinese" data-reactid="255">警告提示</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="256"><a href="/components/message-cn/" data-reactid="257"><span data-reactid="258">Message</span><span class="chinese" data-reactid="259">全局提示</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="260"><a href="/components/modal-cn/" data-reactid="261"><span data-reactid="262">Modal</span><span class="chinese" data-reactid="263">对话框</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="264"><a href="/components/notification-cn/" data-reactid="265"><span data-reactid="266">Notification</span><span class="chinese" data-reactid="267">通知提醒框</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="268"><a href="/components/popconfirm-cn/" data-reactid="269"><span data-reactid="270">Popconfirm</span><span class="chinese" data-reactid="271">气泡确认框</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="272"><a href="/components/progress-cn/" data-reactid="273"><span data-reactid="274">Progress</span><span class="chinese" data-reactid="275">进度条</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="276"><a href="/components/spin-cn/" data-reactid="277"><span data-reactid="278">Spin</span><span class="chinese" data-reactid="279">加载中</span></a></li></ul></li><li class=" ant-menu-item-group" data-reactid="280"><div class="ant-menu-item-group-title" data-reactid="281">Other</div><ul class="ant-menu-item-group-list" data-reactid="282"><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="283"><a href="/components/anchor-cn/" data-reactid="284"><span data-reactid="285">Anchor</span><span class="chinese" data-reactid="286">锚点</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="287"><a href="/components/locale-provider-cn/" data-reactid="288"><span data-reactid="289">LocaleProvider</span><span class="chinese" data-reactid="290">国际化</span></a></li></ul></li></ul></li></ul></div><div class="main-container ant-col-xs-24 ant-col-sm-24 ant-col-md-18 ant-col-lg-20" data-reactid="291"><article class="markdown" data-reactid="292"><h1 data-reactid="293"><!-- react-text: 294 -->在 create-react-app 中使用<!-- /react-text --><a class="edit-button" href="https://github.com/ant-design/ant-design/blob/master/docs/react/use-with-create-react-app.zh-CN.md" data-reactid="295"><i class="anticon anticon-edit" data-reactid="296"></i></a></h1><section class="markdown" data-reactid="297"><p data-reactid="298"><a href="https://github.com/facebookincubator/create-react-app" data-reactid="299"><!-- react-text: 300 -->create-react-app<!-- /react-text --></a><!-- react-text: 301 --> 是业界最优秀的 React 应用开发工具之一，本文会尝试在 create-react-app 创建的工程中使用 antd 组件，并自定义 webpack 的配置以满足各类工程化需求。<!-- /react-text --></p></section><section class="toc" data-reactid="302"><ul data-reactid="303"><li data-reactid="304"><a class="bisheng-toc-h2" href="#安装和初始化" data-reactid="305"><!-- react-text: 306 -->安装和初始化<!-- /react-text --></a></li><li data-reactid="307"><a class="bisheng-toc-h2" href="#引入-antd" data-reactid="308"><!-- react-text: 309 -->引入 antd<!-- /react-text --></a></li><li data-reactid="310"><a class="bisheng-toc-h2" href="#高级配置" data-reactid="311"><!-- react-text: 312 -->高级配置<!-- /react-text --></a></li></ul></section><section class="markdown" data-reactid="313"><h2 id="安装和初始化" data-reactid="314"><span data-reactid="315"><!-- react-text: 316 -->安装和初始化<!-- /react-text --></span><a href="#安装和初始化" class="anchor" data-reactid="317">#</a></h2><p data-reactid="318"><!-- react-text: 319 -->我们需要在命令行中安装 create-react-app 工具，你可能还需要安装 <!-- /react-text --><a href="https://github.com/yarnpkg/yarn/" data-reactid="320"><!-- react-text: 321 -->yarn<!-- /react-text --></a><!-- react-text: 322 -->。<!-- /react-text --></p><pre class="language-bash" data-reactid="323"><code data-reactid="324">$ <span class="token function">npm</span> <span class="token function">install</span> -g create-react-app yarn</code></pre><p data-reactid="325"><!-- react-text: 326 -->然后新建一个项目。<!-- /react-text --></p><pre class="language-bash" data-reactid="327"><code data-reactid="328">$ create-react-app antd-demo</code></pre><p data-reactid="329"><!-- react-text: 330 -->工具会自动初始化一个脚手架并安装 React 项目的各种必要依赖，如果在过程中出现网络问题，请尝试配置代理或使用其他 npm registry。<!-- /react-text --></p><p data-reactid="331"><!-- react-text: 332 -->然后我们进入项目并启动。<!-- /react-text --></p><pre class="language-bash" data-reactid="333"><code data-reactid="334">$ <span class="token function">cd</span> antd-demo
$ yarn start</code></pre><p data-reactid="335"><!-- react-text: 336 -->此时浏览器会访问 <!-- /react-text --><a href="http://localhost:3000/" data-reactid="337"><!-- react-text: 338 -->http://localhost:3000/<!-- /react-text --></a><!-- react-text: 339 --> ，看到 <!-- /react-text --><code data-reactid="340"><!-- react-text: 341 -->Welcome to React<!-- /react-text --></code><!-- react-text: 342 --> 的界面就算成功了。<!-- /react-text --></p><h2 id="引入-antd" data-reactid="343"><span data-reactid="344"><!-- react-text: 345 -->引入 antd<!-- /react-text --></span><a href="#引入-antd" class="anchor" data-reactid="346">#</a></h2><p data-reactid="347"><!-- react-text: 348 -->这是 create-react-app 生成的默认目录结构。<!-- /react-text --></p><pre class="language-null" data-reactid="349"><code data-reactid="350">├── README<span class="token punctuation">.</span>md
├── package<span class="token punctuation">.</span>json
├── public
│ ├── favicon<span class="token punctuation">.</span>ico
│ └── index<span class="token punctuation">.</span>html
├── src
│ ├── App<span class="token punctuation">.</span>css
│ ├── App<span class="token punctuation">.</span>js
│ ├── App<span class="token punctuation">.</span>test<span class="token punctuation">.</span>js
│ ├── index<span class="token punctuation">.</span>css
│ ├── index<span class="token punctuation">.</span>js
│ └── logo<span class="token punctuation">.</span>svg
└── yarn<span class="token punctuation">.</span>lock</code></pre><p data-reactid="351"><!-- react-text: 352 -->现在从 yarn 或 npm 安装并引入 antd。<!-- /react-text --></p><pre class="language-bash" data-reactid="353"><code data-reactid="354">$ yarn add antd --save</code></pre><p data-reactid="355"><!-- react-text: 356 -->修改 <!-- /react-text --><code data-reactid="357"><!-- react-text: 358 -->src/App.js<!-- /react-text --></code><!-- react-text: 359 -->，引入 antd 的按钮组件。<!-- /react-text --></p><pre class="language-jsx" data-reactid="360"><code data-reactid="361"><span class="token keyword">import</span> React<span class="token punctuation">,</span> <span class="token punctuation">{</span> Component <span class="token punctuation">}</span> <span class="token keyword">from</span> <span class="token string">'react'</span><span class="token punctuation">;</span>
<span class="token keyword">import</span> <span class="token punctuation">{</span> Button <span class="token punctuation">}</span> <span class="token keyword">from</span> <span class="token string">'antd'</span><span class="token punctuation">;</span>
<span class="token keyword">import</span> <span class="token string">'./App.css'</span><span class="token punctuation">;</span>
<span class="token keyword">class</span> <span class="token class-name">App</span> <span class="token keyword">extends</span> <span class="token class-name">Component</span> <span class="token punctuation">{</span>
<span class="token function">render</span><span class="token punctuation">(</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
<span class="token keyword">return</span> <span class="token punctuation">(</span>
<span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>div</span> <span class="token attr-name">className</span><span class="token attr-value"><span class="token punctuation">=</span><span class="token punctuation">"</span>App<span class="token punctuation">"</span></span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>Button</span> <span class="token attr-name">type</span><span class="token attr-value"><span class="token punctuation">=</span><span class="token punctuation">"</span>primary<span class="token punctuation">"</span></span><span class="token punctuation">></span></span>Button<span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>Button</span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>div</span><span class="token punctuation">></span></span>
<span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token punctuation">}</span>
<span class="token punctuation">}</span>
<span class="token keyword">export</span> <span class="token keyword">default</span> App<span class="token punctuation">;</span></code></pre><p data-reactid="362"><!-- react-text: 363 -->修改 <!-- /react-text --><code data-reactid="364"><!-- react-text: 365 -->src/App.css<!-- /react-text --></code><!-- react-text: 366 -->，在文件顶部引入 <!-- /react-text --><code data-reactid="367"><!-- react-text: 368 -->antd/dist/antd.css<!-- /react-text --></code><!-- react-text: 369 -->。<!-- /react-text --></p><pre class="language-css" data-reactid="370"><code data-reactid="371"><span class="token atrule"><span class="token rule">@import</span> <span class="token string">'~antd/dist/antd.css'</span><span class="token punctuation">;</span></span>
<span class="token selector"><span class="token class">.App</span> </span><span class="token punctuation">{</span>
<span class="token property">text-align</span><span class="token punctuation">:</span> center<span class="token punctuation">;</span>
<span class="token punctuation">}</span>
<span class="token number">...</span></code></pre><p data-reactid="372"><!-- react-text: 373 -->好了，现在你应该能看到页面上已经有了 antd 的蓝色按钮组件，接下来就可以继续选用其他组件开发应用了。其他开发流程你可以参考 create-react-app 的<!-- /react-text --><a href="https://github.com/facebookincubator/create-react-app/blob/master/packages/react-scripts/template/README.md" data-reactid="374"><!-- react-text: 375 -->官方文档<!-- /react-text --></a><!-- react-text: 376 -->。<!-- /react-text --></p><h2 id="高级配置" data-reactid="377"><span data-reactid="378"><!-- react-text: 379 -->高级配置<!-- /react-text --></span><a href="#高级配置" class="anchor" data-reactid="380">#</a></h2><p data-reactid="381"><!-- react-text: 382 -->我们现在已经把组件成功运行起来了，但是在实际开发过程中还有很多问题，例如上面的例子实际上加载了全部的 antd 组件的代码（对前端性能是个隐患）。<!-- /react-text --></p><blockquote data-reactid="383"><p data-reactid="384"><!-- react-text: 385 -->你会在控制台看到如下警告。
<!-- /react-text --><img src="https://zos.alipayobjects.com/rmsportal/vgcHJRVZFmPjAawwVoXK.png" data-reactid="386"/></p></blockquote><p data-reactid="387"><!-- react-text: 388 -->我们需要对 create-react-app 的默认配置进行自定义。可以使用 <!-- /react-text --><code data-reactid="389"><!-- react-text: 390 -->eject<!-- /react-text --></code><!-- react-text: 391 --> 命令将所有内建的配置暴露出来。<!-- /react-text --></p><pre class="language-bash" data-reactid="392"><code data-reactid="393">$ yarn run <span class="token function">eject</span></code></pre><h3 id="按需加载" data-reactid="394"><span data-reactid="395"><!-- react-text: 396 -->按需加载<!-- /react-text --></span><a href="#按需加载" class="anchor" data-reactid="397">#</a></h3><p data-reactid="398"><a href="https://github.com/ant-design/babel-plugin-import" data-reactid="399"><!-- react-text: 400 -->babel-plugin-import<!-- /react-text --></a><!-- react-text: 401 --> 是一个用于按需加载组件代码和样式的 babel 插件（<!-- /react-text --><a href="/docs/react/getting-started-cn#按需加载" data-reactid="402">原理</a><!-- react-text: 403 -->），现在我们尝试安装它并修改 <!-- /react-text --><code data-reactid="404"><!-- react-text: 405 -->config/webpack.config.dev.js<!-- /react-text --></code><!-- react-text: 406 --> 文件。<!-- /react-text --></p><pre class="language-bash" data-reactid="407"><code data-reactid="408">$ yarn add babel-plugin-import --save-dev</code></pre><pre class="language-diff" data-reactid="409"><code data-reactid="410">// Process JS with Babel.
{
test: /\.(js|jsx)$/,
include: paths.appSrc,
loader: 'babel',
query: {
<span class="token inserted">+ plugins: [</span>
<span class="token inserted">+ ['import', [{ libraryName: "antd", style: 'css' }]],</span>
<span class="token inserted">+ ],</span>
// This is a feature of `babel-loader` for webpack (not Babel itself).
// It enables caching results in ./node_modules/.cache/babel-loader/
// directory for faster rebuilds.
cacheDirectory: true
}
},</code></pre><blockquote data-reactid="411"><p data-reactid="412"><!-- react-text: 413 -->注意，由于 create-react-app eject 之后的配置中没有 <!-- /react-text --><code data-reactid="414"><!-- react-text: 415 -->.babelrc<!-- /react-text --></code><!-- react-text: 416 --> 文件，所以需要把配置放到 <!-- /react-text --><code data-reactid="417"><!-- react-text: 418 -->webpack.config.js<!-- /react-text --></code><!-- react-text: 419 --> 或 <!-- /react-text --><code data-reactid="420"><!-- react-text: 421 -->package.json<!-- /react-text --></code><!-- react-text: 422 --> 的 <!-- /react-text --><code data-reactid="423"><!-- react-text: 424 -->babel<!-- /react-text --></code><!-- react-text: 425 --> 属性中。<!-- /react-text --></p></blockquote><p data-reactid="426"><!-- react-text: 427 -->然后移除前面在 <!-- /react-text --><code data-reactid="428"><!-- react-text: 429 -->src/App.css<!-- /react-text --></code><!-- react-text: 430 --> 里全量添加的 <!-- /react-text --><code data-reactid="431"><!-- react-text: 432 -->@import &#x27;~antd/dist/antd.css&#x27;;<!-- /react-text --></code><!-- react-text: 433 --> 样式代码，现在 babel-plugin-import 会按需加载样式。<!-- /react-text --></p><p data-reactid="434"><!-- react-text: 435 -->最后重启 <!-- /react-text --><code data-reactid="436"><!-- react-text: 437 -->yarn start<!-- /react-text --></code><!-- react-text: 438 --> 访问页面，此时上面的警告信息应该没了，antd 组件的 js 和 css 代码都会按需加载。<!-- /react-text --></p><h3 id="自定义主题" data-reactid="439"><span data-reactid="440"><!-- react-text: 441 -->自定义主题<!-- /react-text --></span><a href="#自定义主题" class="anchor" data-reactid="442">#</a></h3><p data-reactid="443"><!-- react-text: 444 -->按照 <!-- /react-text --><a href="/docs/react/customize-theme" data-reactid="445">配置主题</a><!-- react-text: 446 --> 的要求，自定义主题需要用到 less 变量覆盖功能，因此首先我们需要引入 <!-- /react-text --><a href="https://github.com/webpack/less-loader" data-reactid="447"><!-- react-text: 448 -->less-loader<!-- /react-text --></a><!-- react-text: 449 --> 来加载 less 样式，同时修改 <!-- /react-text --><code data-reactid="450"><!-- react-text: 451 -->config/webpack.config.dev.js<!-- /react-text --></code><!-- react-text: 452 --> 文件。<!-- /react-text --></p><pre class="language-bash" data-reactid="453"><code data-reactid="454">$ yarn add <span class="token function">less</span> less-loader --save-dev</code></pre><pre class="language-diff" data-reactid="455"><code data-reactid="456">loaders: [
{
exclude: [
/\.html$/,
/\.(js|jsx)$/,
<span class="token inserted">+ /\.less$/,</span>
/\.css$/,
/\.json$/,
/\.svg$/
],
loader: 'url',
},
...
// Process JS with Babel.
{
test: /\.(js|jsx)$/,
include: paths.appSrc,
loader: 'babel',
query: {
plugins: [
<span class="token deleted">- ['import', [{ libraryName: "antd", style: 'css' }]],</span>
<span class="token inserted">+ ['import', [{ libraryName: "antd", style: true }]], // 加载 less 文件</span>
],
},
...
<span class="token inserted">+ // 解析 less 文件，并加入变量覆盖配置</span>
<span class="token inserted">+ {</span>
<span class="token inserted">+ test: /\.less$/,</span>
<span class="token inserted">+ loader: 'style!css!postcss!less?{modifyVars:{"@primary-color":"#1DA57A"}}'</span>
<span class="token inserted">+ },</span>
]</code></pre><p data-reactid="457"><!-- react-text: 458 -->这里利用了 <!-- /react-text --><a href="https://github.com/webpack/less-loader#less-options" data-reactid="459"><!-- react-text: 460 -->less-loader<!-- /react-text --></a><!-- react-text: 461 --> 的 <!-- /react-text --><code data-reactid="462"><!-- react-text: 463 -->modifyVars<!-- /react-text --></code><!-- react-text: 464 --> 来进行主题配置，
变量和其他配置方式可以参考 <!-- /react-text --><a href="/docs/react/customize-theme" data-reactid="465">配置主题</a><!-- react-text: 466 --> 文档。<!-- /react-text --></p><p data-reactid="467"><!-- react-text: 468 -->修改后重启 <!-- /react-text --><code data-reactid="469"><!-- react-text: 470 -->yarn start<!-- /react-text --></code><!-- react-text: 471 -->，如果看到一个绿色的按钮就说明配置成功了。<!-- /react-text --></p><hr data-reactid="472"/><p data-reactid="473"><!-- react-text: 474 -->以上是在 create-react-app 中使用 antd 的相关实践，你也可以借鉴此文的做法在自己的 webpack 工作流中使用 antd，更多 webpack 配置可参考 <!-- /react-text --><a href="https://github.com/ant-tool/atool-build/blob/master/src/getWebpackCommonConfig.js" data-reactid="475"><!-- react-text: 476 -->atool-build<!-- /react-text --></a><!-- react-text: 477 -->。（例如加入 <!-- /react-text --><a href="https://github.com/ant-tool/atool-build/blob/e4bd2959689b6a95cb5c1c854a5db8c98676bdb3/src/getWebpackCommonConfig.js#L90" data-reactid="478"><!-- react-text: 479 -->moment noParse<!-- /react-text --></a><!-- react-text: 480 --> 避免加载所有语言文件）<!-- /react-text --></p><p data-reactid="481"><!-- react-text: 482 -->本例所有源码可见：<!-- /react-text --><a href="https://github.com/ant-design/create-react-app-antd" data-reactid="483"><!-- react-text: 484 -->https://github.com/ant-design/create-react-app-antd<!-- /react-text --></a></p></section></article></div></div><div class="ant-row" data-reactid="485"><div class="ant-col-xs-24 ant-col-sm-24 ant-col-md-18 ant-col-md-offset-6 ant-col-lg-20 ant-col-lg-offset-4" data-reactid="486"><section class="prev-next-nav" data-reactid="487"><a class="prev-page" href="/docs/react/practical-projects-cn" data-reactid="488">项目实战</a><a class="next-page" href="/docs/react/customize-theme-cn" data-reactid="489">定制主题</a></section></div></div></div><footer id="footer" data-reactid="490"><ul data-reactid="491"><li data-reactid="492"><h2 data-reactid="493">GitHub</h2><div data-reactid="494"><a target="_blank " href="https://github.com/ant-design/ant-design" data-reactid="495"><span data-reactid="496">仓库</span></a></div><div data-reactid="497"><a target="_blank" rel="noopener noreferrer" href="https://github.com/dvajs/dva" data-reactid="498">dva</a><!-- react-text: 499 --> - <!-- /react-text --><span data-reactid="500">应用框架</span></div><div data-reactid="501"><a target="_blank" rel="noopener noreferrer" href="https://github.com/dvajs/dva-cli" data-reactid="502">dva-cli</a><!-- react-text: 503 --> -<!-- /react-text --><span data-reactid="504">脚手架</span></div><div data-reactid="505"><a target="_blank" rel="noopener noreferrer" href="http://ant-tool.github.io" data-reactid="506">ant-tool</a><!-- react-text: 507 --> - <!-- /react-text --><span data-reactid="508">开发工具</span></div></li><li data-reactid="509"><h2 data-reactid="510"><span data-reactid="511">相关站点</span></h2><div data-reactid="512"><a href="http://mobile.ant.design" data-reactid="513">Ant Design Mobile</a><span data-reactid="514"> - </span><span data-reactid="515">移动版</span></div><div data-reactid="516"><a href="https://g2.alipay.com/" data-reactid="517">G2</a><span data-reactid="518"> - </span><span data-reactid="519">数据可视化</span></div><div data-reactid="520"><a href="https://antv.alipay.com/" data-reactid="521">AntV</a><span data-reactid="522"> - </span><span data-reactid="523">数据可视化规范</span></div><div data-reactid="524"><a href="http://motion.ant.design" data-reactid="525">Ant Motion</a><span data-reactid="526"> - </span><span data-reactid="527">设计动效</span></div><div data-reactid="528"><a href="http://library.ant.design/" data-reactid="529">AntD Library</a><span data-reactid="530"> - </span><span data-reactid="531">Axure 部件库</span></div><div data-reactid="532"><a href="http://ux.ant.design" data-reactid="533">Ant UX</a><span data-reactid="534"> - </span><span data-reactid="535">页面逻辑素材</span></div></li><li data-reactid="536"><h2 data-reactid="537"><span data-reactid="538">社区</span></h2><div data-reactid="539"><a rel="noopener noreferrer" href="/changelog" data-reactid="540"><span data-reactid="541">更新记录</span></a></div><div data-reactid="542"><a target="_blank" rel="noopener noreferrer" href="https://github.com/ant-design/ant-design/issues" data-reactid="543"><span data-reactid="544">反馈和建议</span></a></div><div data-reactid="545"><a target="_blank" rel="noopener noreferrer" href="https://gitter.im/ant-design/ant-design" data-reactid="546"><span data-reactid="547">讨论</span></a></div><div data-reactid="548"><a target="_blank" rel="noopener noreferrer" href="https://github.com/ant-design/ant-design/issues/new" data-reactid="549"><span data-reactid="550">报告 Bug</span></a></div></li><li data-reactid="551"><div data-reactid="552"><!-- react-text: 553 -->©2016 <!-- /react-text --><span data-reactid="554">蚂蚁金服体验技术部出品</span></div><div data-reactid="555"><!-- react-text: 556 -->Powered by <!-- /react-text --><a href="https://github.com/benjycui/bisheng" data-reactid="557">BiSheng</a></div><div style="margin-top:10px;" data-reactid="558"><span data-reactid="559">文档版本：</span><div class="ant-select-sm ant-select ant-select-enabled" data-reactid="560"><div class="ant-select-selection
ant-select-selection--single" role="combobox" aria-autocomplete="list" aria-haspopup="true" aria-expanded="false" tabindex="0" data-reactid="561"><div class="ant-select-selection__rendered" data-reactid="562"><div class="ant-select-selection-selected-value" title="2.6.4" style="display:block;opacity:1;" data-reactid="563">2.6.4</div></div><span class="ant-select-arrow" style="user-select:none;-webkit-user-select:none;" unselectable="unselectable" data-reactid="564"><b data-reactid="565"></b></span></div></div></div></li></ul></footer></div>
</div>
<script>
function isZhCN(pathname) {
return /-cn\/?$/.test(pathname);
}
function getLocalizedPathname(path, zhCN) {
var pathname = path.startsWith('/') ? path : '/' + path;
if (!zhCN) { // to enUS
return /\/?index-cn/.test(pathname) ? '/' : pathname.replace('-cn', '');
} else if (pathname === '/') {
return '/index-cn';
} else if (pathname.endsWith('/')) {
return pathname.replace(/\/$/, '-cn/');
}
return pathname + '-cn';
}
var queryString = location.search;
if (queryString) {
var pathname = location.pathname;
var isZhCNConfig = queryString.indexOf('zh-CN') > -1;
if (isZhCNConfig !== isZhCN(pathname)) {
location.pathname = getLocalizedPathname(pathname, isZhCNConfig)
}
}
</script>
<script src="/common.js"></script>
<script src="/index.js"></script>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink