home/ant-design
2
0
Fork 0
mirror of https://github.com/wahyd4/ant-design.git synced 2026-08-13 23:07:49 +10:00
Code Issues Packages Projects Releases Wiki Activity
Files
8200affa7f3ff9def0dbaaaa111157e36ccb4d31
ant-design/docs/react/use-with-create-react-app-cn.html
T
afc163 8200affa7f Updates
2016-12-23 12:01:39 +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 - One 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-1.css"/>
<link rel="stylesheet" type="text/css" href="/index-2.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>
</head>
<body>
<div id="react-content">
<div class="page-wrapper" data-reactroot="" data-reactid="1" data-react-checksum="-951980086"><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 style="display:block;" class="ant-col-xs-0 ant-col-sm-17 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"><!-- react-text: 23 -->EN<!-- /react-text --></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="24"><li class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="25"><a href="/index-cn" data-reactid="26"><span data-reactid="27"><!-- react-text: 28 -->首页<!-- /react-text --></span></a></li><li class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="29"><a href="/docs/spec/introduce-cn" data-reactid="30"><span data-reactid="31"><!-- react-text: 32 -->规范<!-- /react-text --></span></a></li><li class="ant-menu-item-selected ant-menu-item" role="menuitem" aria-selected="true" data-reactid="33"><a href="/docs/react/introduce-cn" data-reactid="34"><span data-reactid="35"><!-- react-text: 36 -->组件<!-- /react-text --></span></a></li><li class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="37"><a href="/docs/pattern/navigation-cn" data-reactid="38"><span data-reactid="39"><!-- react-text: 40 -->模式<!-- /react-text --></span></a></li><li class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="41"><a href="/docs/practice/cases-cn" data-reactid="42"><span data-reactid="43"><!-- react-text: 44 -->实践<!-- /react-text --></span></a></li><li class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="45"><a href="/docs/resource/download-cn" data-reactid="46"><span data-reactid="47"><!-- react-text: 48 -->资源<!-- /react-text --></span></a></li></ul></div></div></header><div class="main-wrapper" data-reactid="49"><div class="ant-row" data-reactid="50"><div class="ant-col-xs-24 ant-col-sm-24 ant-col-md-6 ant-col-lg-4" data-reactid="51"><ul class="ant-menu ant-menu-inline aside-container ant-menu-light ant-menu-root" role="menu" aria-activedescendant="" tabindex="0" data-reactid="52"><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="53"><a href="/docs/react/introduce-cn" data-reactid="54">Ant Design of React</a></li><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="55"><a href="/docs/react/getting-started-cn" data-reactid="56">快速上手</a></li><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="57"><a href="/docs/react/install-cn" data-reactid="58">安装</a></li><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="59"><a href="/docs/react/practical-projects-cn" data-reactid="60">项目实战</a></li><li style="padding-left:24px;" class="ant-menu-item-selected ant-menu-item" role="menuitem" aria-selected="true" data-reactid="61"><a href="/docs/react/use-with-create-react-app-cn" data-reactid="62">在 create-react-app 中使用</a></li><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="63"><a href="/docs/react/customize-theme-cn" data-reactid="64">定制主题</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" data-reactid="66">i18n 方案</a></li><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="67"><a href="/changelog-cn" data-reactid="68">更新日志</a></li><li class="ant-menu-submenu-inline ant-menu-submenu-open ant-menu-submenu" data-reactid="69"><div style="padding-left:24px;" class="ant-menu-submenu-title" aria-open="true" aria-owns="1482465667355_13" aria-haspopup="true" data-reactid="70"><h4 data-reactid="71">Components</h4></div><ul class="ant-menu ant-menu-inline ant-menu-sub" role="menu" aria-activedescendant="" id="1482465667355_13" data-reactid="72"><li class=" ant-menu-item-group" data-reactid="73"><div class="ant-menu-item-group-title" data-reactid="74">General</div><ul class="ant-menu-item-group-list" data-reactid="75"><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="76"><a href="/components/button-cn/" data-reactid="77"><span data-reactid="78">Button</span><span class="chinese" data-reactid="79">按钮</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="80"><a href="/components/icon-cn/" data-reactid="81"><span data-reactid="82">Icon</span><span class="chinese" data-reactid="83">图标</span></a></li></ul></li><li class=" ant-menu-item-group" data-reactid="84"><div class="ant-menu-item-group-title" data-reactid="85">Layout</div><ul class="ant-menu-item-group-list" data-reactid="86"><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="87"><a href="/components/grid-cn/" data-reactid="88"><span data-reactid="89">Grid</span><span class="chinese" data-reactid="90">栅格</span></a></li></ul></li><li class=" ant-menu-item-group" data-reactid="91"><div class="ant-menu-item-group-title" data-reactid="92">Navigation</div><ul class="ant-menu-item-group-list" data-reactid="93"><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="94"><a href="/components/affix-cn/" data-reactid="95"><span data-reactid="96">Affix</span><span class="chinese" data-reactid="97">固钉</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="98"><a href="/components/anchor-cn/" data-reactid="99"><span data-reactid="100">Anchor</span><span class="chinese" data-reactid="101">锚点</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="102"><a href="/components/back-top-cn/" data-reactid="103"><span data-reactid="104">BackTop</span><span class="chinese" data-reactid="105">回到顶部</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="106"><a href="/components/breadcrumb-cn/" data-reactid="107"><span data-reactid="108">Breadcrumb</span><span class="chinese" data-reactid="109">面包屑</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="110"><a href="/components/dropdown-cn/" data-reactid="111"><span data-reactid="112">Dropdown</span><span class="chinese" data-reactid="113">下拉菜单</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="114"><a href="/components/menu-cn/" data-reactid="115"><span data-reactid="116">Menu</span><span class="chinese" data-reactid="117">导航菜单</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="118"><a href="/components/pagination-cn/" data-reactid="119"><span data-reactid="120">Pagination</span><span class="chinese" data-reactid="121">分页</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="122"><a href="/components/steps-cn/" data-reactid="123"><span data-reactid="124">Steps</span><span class="chinese" data-reactid="125">步骤条</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="126"><a href="/components/tabs-cn/" data-reactid="127"><span data-reactid="128">Tabs</span><span class="chinese" data-reactid="129">标签页</span></a></li></ul></li><li class=" ant-menu-item-group" data-reactid="130"><div class="ant-menu-item-group-title" data-reactid="131">Data Entry</div><ul class="ant-menu-item-group-list" data-reactid="132"><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="133"><a href="/components/auto-complete-cn/" data-reactid="134"><span data-reactid="135">AutoComplete</span><span class="chinese" data-reactid="136">自动完成</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="137"><a href="/components/checkbox-cn/" data-reactid="138"><span data-reactid="139">Checkbox</span><span class="chinese" data-reactid="140">多选框</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="141"><a href="/components/cascader-cn/" data-reactid="142"><span data-reactid="143">Cascader</span><span class="chinese" data-reactid="144">级联选择</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="145"><a href="/components/date-picker-cn/" data-reactid="146"><span data-reactid="147">DatePicker</span><span class="chinese" data-reactid="148">日期选择框</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="149"><a href="/components/form-cn/" data-reactid="150"><span data-reactid="151">Form</span><span class="chinese" data-reactid="152">表单</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="153"><a href="/components/input-cn/" data-reactid="154"><span data-reactid="155">Input</span><span class="chinese" data-reactid="156">输入框</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="157"><a href="/components/input-number-cn/" data-reactid="158"><span data-reactid="159">InputNumber</span><span class="chinese" data-reactid="160">数字输入框</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="161"><a href="/components/mention-cn/" data-reactid="162"><span data-reactid="163">Mention</span><span class="chinese" data-reactid="164">提及</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="165"><a href="/components/radio-cn/" data-reactid="166"><span data-reactid="167">Radio</span><span class="chinese" data-reactid="168">单选框</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="169"><a href="/components/rate-cn/" data-reactid="170"><span data-reactid="171">Rate</span><span class="chinese" data-reactid="172">评分</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="173"><a href="/components/select-cn/" data-reactid="174"><span data-reactid="175">Select</span><span class="chinese" data-reactid="176">选择器</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="177"><a href="/components/slider-cn/" data-reactid="178"><span data-reactid="179">Slider</span><span class="chinese" data-reactid="180">滑动输入条</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="181"><a href="/components/switch-cn/" data-reactid="182"><span data-reactid="183">Switch</span><span class="chinese" data-reactid="184">开关</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="185"><a href="/components/time-picker-cn/" data-reactid="186"><span data-reactid="187">TimePicker</span><span class="chinese" data-reactid="188">时间选择框</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="189"><a href="/components/transfer-cn/" data-reactid="190"><span data-reactid="191">Transfer</span><span class="chinese" data-reactid="192">穿梭框</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="193"><a href="/components/tree-select-cn/" data-reactid="194"><span data-reactid="195">TreeSelect</span><span class="chinese" data-reactid="196">树选择</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="197"><a href="/components/upload-cn/" data-reactid="198"><span data-reactid="199">Upload</span><span class="chinese" data-reactid="200">上传</span></a></li></ul></li><li class=" ant-menu-item-group" data-reactid="201"><div class="ant-menu-item-group-title" data-reactid="202">Data Display</div><ul class="ant-menu-item-group-list" data-reactid="203"><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="204"><a href="/components/badge-cn/" data-reactid="205"><span data-reactid="206">Badge</span><span class="chinese" data-reactid="207">徽标数</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="208"><a href="/components/card-cn/" data-reactid="209"><span data-reactid="210">Card</span><span class="chinese" data-reactid="211">卡片</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="212"><a href="/components/carousel-cn/" data-reactid="213"><span data-reactid="214">Carousel</span><span class="chinese" data-reactid="215">走马灯</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="216"><a href="/components/collapse-cn/" data-reactid="217"><span data-reactid="218">Collapse</span><span class="chinese" data-reactid="219">折叠面板</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="220"><a href="/components/calendar-cn/" data-reactid="221"><span data-reactid="222">Calendar</span><span class="chinese" data-reactid="223">日历</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="224"><a href="/components/popover-cn/" data-reactid="225"><span data-reactid="226">Popover</span><span class="chinese" data-reactid="227">气泡卡片</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="228"><a href="/components/table-cn/" data-reactid="229"><span data-reactid="230">Table</span><span class="chinese" data-reactid="231">表格</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="232"><a href="/components/tag-cn/" data-reactid="233"><span data-reactid="234">Tag</span><span class="chinese" data-reactid="235">标签</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="236"><a href="/components/timeline-cn/" data-reactid="237"><span data-reactid="238">Timeline</span><span class="chinese" data-reactid="239">时间轴</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="240"><a href="/components/tooltip-cn/" data-reactid="241"><span data-reactid="242">Tooltip</span><span class="chinese" data-reactid="243">文字提示</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="244"><a href="/components/tree-cn/" data-reactid="245"><span data-reactid="246">Tree</span><span class="chinese" data-reactid="247">树形控件</span></a></li></ul></li><li class=" ant-menu-item-group" data-reactid="248"><div class="ant-menu-item-group-title" data-reactid="249">Feedback</div><ul class="ant-menu-item-group-list" data-reactid="250"><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="251"><a href="/components/alert-cn/" data-reactid="252"><span data-reactid="253">Alert</span><span class="chinese" data-reactid="254">警告提示</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="255"><a href="/components/message-cn/" data-reactid="256"><span data-reactid="257">Message</span><span class="chinese" data-reactid="258">全局提示</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="259"><a href="/components/modal-cn/" data-reactid="260"><span data-reactid="261">Modal</span><span class="chinese" data-reactid="262">对话框</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="263"><a href="/components/notification-cn/" data-reactid="264"><span data-reactid="265">Notification</span><span class="chinese" data-reactid="266">通知提醒框</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="267"><a href="/components/popconfirm-cn/" data-reactid="268"><span data-reactid="269">Popconfirm</span><span class="chinese" data-reactid="270">气泡确认框</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="271"><a href="/components/progress-cn/" data-reactid="272"><span data-reactid="273">Progress</span><span class="chinese" data-reactid="274">进度条</span></a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="275"><a href="/components/spin-cn/" data-reactid="276"><span data-reactid="277">Spin</span><span class="chinese" data-reactid="278">加载中</span></a></li></ul></li><li class=" ant-menu-item-group" data-reactid="279"><div class="ant-menu-item-group-title" data-reactid="280">Other</div><ul class="ant-menu-item-group-list" data-reactid="281"><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="282"><a href="/components/locale-provider-cn/" data-reactid="283"><span data-reactid="284">LocaleProvider</span><span class="chinese" data-reactid="285">国际化</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="286"><article class="markdown" data-reactid="287"><h1 data-reactid="288"><!-- react-text: 289 -->在 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="290"><i class="anticon anticon-edit" data-reactid="291"></i></a></h1><section class="markdown" data-reactid="292"><p data-reactid="293"><a href="https://github.com/facebookincubator/create-react-app" data-reactid="294"><!-- react-text: 295 -->create-react-app<!-- /react-text --></a><!-- react-text: 296 --> 是业界最优秀的 React 应用开发工具之一，本文会尝试在 create-react-app 创建的工程中使用 antd 组件，并自定义 webpack 的配置以满足各类工程化需求。<!-- /react-text --></p></section><section class="toc" data-reactid="297"><ul data-reactid="298"><li data-reactid="299"><a class="bisheng-toc-h2" href="#安装和初始化" data-reactid="300"><!-- react-text: 301 -->安装和初始化<!-- /react-text --></a></li><li data-reactid="302"><a class="bisheng-toc-h2" href="#引入-antd" data-reactid="303"><!-- react-text: 304 -->引入 antd<!-- /react-text --></a></li><li data-reactid="305"><a class="bisheng-toc-h2" href="#高级配置" data-reactid="306"><!-- react-text: 307 -->高级配置<!-- /react-text --></a></li></ul></section><section class="markdown" data-reactid="308"><h2 id="安装和初始化" data-reactid="309"><span data-reactid="310"><!-- react-text: 311 -->安装和初始化<!-- /react-text --></span><a href="#安装和初始化" class="anchor" data-reactid="312">#</a></h2><p data-reactid="313"><!-- react-text: 314 -->我们需要在命令行中安装 create-react-app 工具。<!-- /react-text --></p><pre class="language-bash" data-reactid="315"><code data-reactid="316">$ <span class="token function">npm</span> <span class="token function">install</span> -g create-react-app</code></pre><p data-reactid="317"><!-- react-text: 318 -->然后新建一个项目。<!-- /react-text --></p><pre class="language-bash" data-reactid="319"><code data-reactid="320">$ USE_YARN<span class="token operator">=</span>no create-react-app antd-demo</code></pre><p data-reactid="321"><!-- react-text: 322 -->工具会自动初始化一个脚手架并安装 React 项目的各种必要依赖，如果在过程中出现网络问题，请尝试配置代理或使用其他 npm registry。<!-- /react-text --></p><p data-reactid="323"><!-- react-text: 324 -->然后我们进入项目并启动。<!-- /react-text --></p><pre class="language-bash" data-reactid="325"><code data-reactid="326">$ <span class="token function">cd</span> antd-demo
$ <span class="token function">npm</span> start</code></pre><p data-reactid="327"><!-- react-text: 328 -->此时浏览器会访问 <!-- /react-text --><a href="http://localhost:3000/" data-reactid="329"><!-- react-text: 330 -->http://localhost:3000/<!-- /react-text --></a><!-- react-text: 331 --> ，看到 <!-- /react-text --><code data-reactid="332"><!-- react-text: 333 -->Welcome to React<!-- /react-text --></code><!-- react-text: 334 --> 的界面就算成功了。<!-- /react-text --></p><h2 id="引入-antd" data-reactid="335"><span data-reactid="336"><!-- react-text: 337 -->引入 antd<!-- /react-text --></span><a href="#引入-antd" class="anchor" data-reactid="338">#</a></h2><p data-reactid="339"><!-- react-text: 340 -->这是 create-react-app 生成的默认目录结构。<!-- /react-text --></p><pre class="language-null" data-reactid="341"><code data-reactid="342">├── 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="343"><!-- react-text: 344 -->现在从 npm 安装并引入 antd。<!-- /react-text --></p><pre class="language-bash" data-reactid="345"><code data-reactid="346">$ <span class="token function">npm</span> <span class="token function">install</span> antd --save</code></pre><p data-reactid="347"><!-- react-text: 348 -->修改 <!-- /react-text --><code data-reactid="349"><!-- react-text: 350 -->src/App.js<!-- /react-text --></code><!-- react-text: 351 -->，引入 antd 的按钮组件。<!-- /react-text --></p><pre class="language-jsx" data-reactid="352"><code data-reactid="353"><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="354"><!-- react-text: 355 -->修改 <!-- /react-text --><code data-reactid="356"><!-- react-text: 357 -->src/App.css<!-- /react-text --></code><!-- react-text: 358 -->，在文件顶部引入 <!-- /react-text --><code data-reactid="359"><!-- react-text: 360 -->antd/dist/antd.css<!-- /react-text --></code><!-- react-text: 361 -->。<!-- /react-text --></p><pre class="language-css" data-reactid="362"><code data-reactid="363"><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="364"><!-- react-text: 365 -->好了，现在你应该能看到页面上已经有了 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="366"><!-- react-text: 367 -->官方文档<!-- /react-text --></a><!-- react-text: 368 -->。<!-- /react-text --></p><h2 id="高级配置" data-reactid="369"><span data-reactid="370"><!-- react-text: 371 -->高级配置<!-- /react-text --></span><a href="#高级配置" class="anchor" data-reactid="372">#</a></h2><p data-reactid="373"><!-- react-text: 374 -->我们现在已经把组件成功运行起来了，但是在实际开发过程中还有很多问题，例如上面的例子实际上加载了全部的 antd 组件的代码（对前端性能是个隐患）。<!-- /react-text --></p><blockquote data-reactid="375"><p data-reactid="376"><!-- react-text: 377 -->你会在控制台看到如下警告。<!-- /react-text --></p></blockquote><p data-reactid="378"><img src="https://zos.alipayobjects.com/rmsportal/dBLScZPjiUwunfyQVISX.png" data-reactid="379"/></p><p data-reactid="380"><!-- react-text: 381 -->我们需要对 create-react-app 的默认配置进行自定义。可以使用 <!-- /react-text --><code data-reactid="382"><!-- react-text: 383 -->eject<!-- /react-text --></code><!-- react-text: 384 --> 命令将所有内建的配置暴露出来。<!-- /react-text --></p><pre class="language-bash" data-reactid="385"><code data-reactid="386">$ <span class="token function">npm</span> run <span class="token function">eject</span></code></pre><h3 id="按需加载" data-reactid="387"><span data-reactid="388"><!-- react-text: 389 -->按需加载<!-- /react-text --></span><a href="#按需加载" class="anchor" data-reactid="390">#</a></h3><p data-reactid="391"><!-- react-text: 392 -->现在可以安装 <!-- /react-text --><a href="https://github.com/ant-design/babel-plugin-import" data-reactid="393"><!-- react-text: 394 -->babel-plugin-import<!-- /react-text --></a><!-- react-text: 395 --> 并修改 <!-- /react-text --><code data-reactid="396"><!-- react-text: 397 -->src/webconfig.dev.js<!-- /react-text --></code><!-- react-text: 398 --> 文件。<!-- /react-text --></p><pre class="language-bash" data-reactid="399"><code data-reactid="400">$ <span class="token function">npm</span> <span class="token function">install</span> babel-plugin-import --save-dev</code></pre><pre class="language-diff" data-reactid="401"><code data-reactid="402">// 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><p data-reactid="403"><!-- react-text: 404 -->然后移除前面在 <!-- /react-text --><code data-reactid="405"><!-- react-text: 406 -->src/App.css<!-- /react-text --></code><!-- react-text: 407 --> 里全量添加的 <!-- /react-text --><code data-reactid="408"><!-- react-text: 409 -->@import &#x27;~antd/dist/antd.css&#x27;;<!-- /react-text --></code><!-- react-text: 410 --> 样式代码，现在 babel-plugin-import 会按需加载样式。<!-- /react-text --></p><p data-reactid="411"><!-- react-text: 412 -->最后重启 <!-- /react-text --><code data-reactid="413"><!-- react-text: 414 -->npm start<!-- /react-text --></code><!-- react-text: 415 --> 访问页面，此时上面的警告信息应该没了，antd 组件的 js 和 css 代码都会按需加载。<!-- /react-text --></p><h3 id="自定义主题" data-reactid="416"><span data-reactid="417"><!-- react-text: 418 -->自定义主题<!-- /react-text --></span><a href="#自定义主题" class="anchor" data-reactid="419">#</a></h3><p data-reactid="420"><!-- react-text: 421 -->按照 <!-- /react-text --><a href="/docs/react/customize-theme" data-reactid="422">配置主题</a><!-- react-text: 423 --> 的要求，自定义主题需要用到 less 变量覆盖功能，因此首先我们需要引入 <!-- /react-text --><a href="https://github.com/webpack/less-loader" data-reactid="424"><!-- react-text: 425 -->less-loader<!-- /react-text --></a><!-- react-text: 426 --> 来加载 less 样式，同时修改 <!-- /react-text --><code data-reactid="427"><!-- react-text: 428 -->src/webconfig.dev.js<!-- /react-text --></code><!-- react-text: 429 --> 文件。<!-- /react-text --></p><pre class="language-bash" data-reactid="430"><code data-reactid="431">$ <span class="token function">npm</span> <span class="token function">install</span> <span class="token function">less</span> less-loader --save-dev</code></pre><pre class="language-diff" data-reactid="432"><code data-reactid="433">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="434"><!-- react-text: 435 -->这里利用了 <!-- /react-text --><a href="https://github.com/webpack/less-loader#less-options" data-reactid="436"><!-- react-text: 437 -->less-loader<!-- /react-text --></a><!-- react-text: 438 --> 的 <!-- /react-text --><code data-reactid="439"><!-- react-text: 440 -->modifyVars<!-- /react-text --></code><!-- react-text: 441 --> 来进行主题配置，
变量和其他配置方式可以参考 <!-- /react-text --><a href="/docs/react/customize-theme" data-reactid="442">配置主题</a><!-- react-text: 443 --> 文档。<!-- /react-text --></p><p data-reactid="444"><!-- react-text: 445 -->修改后重启 <!-- /react-text --><code data-reactid="446"><!-- react-text: 447 -->npm start<!-- /react-text --></code><!-- react-text: 448 -->，如果看到一个绿色的按钮就说明配置成功了。<!-- /react-text --></p><hr data-reactid="449"/><p data-reactid="450"><!-- react-text: 451 -->以上是在 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="452"><!-- react-text: 453 -->atool-build<!-- /react-text --></a><!-- react-text: 454 -->。<!-- /react-text --></p><p data-reactid="455"><!-- react-text: 456 -->本例源码可见：<!-- /react-text --><a href="https://github.com/ant-design/create-react-app-antd" data-reactid="457"><!-- react-text: 458 -->https://github.com/ant-design/create-react-app-antd<!-- /react-text --></a></p></section></article></div></div><div class="ant-row" data-reactid="459"><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="460"><section class="prev-next-nav" data-reactid="461"><a class="prev-page" href="/docs/react/practical-projects-cn" data-reactid="462">项目实战</a><a class="next-page" href="/docs/react/customize-theme-cn" data-reactid="463">定制主题</a></section></div></div></div><footer id="footer" data-reactid="464"><ul data-reactid="465"><li data-reactid="466"><h2 data-reactid="467">GitHub</h2><div data-reactid="468"><a target="_blank " href="https://github.com/ant-design/ant-design" data-reactid="469"><span data-reactid="470"><!-- react-text: 471 -->仓库<!-- /react-text --></span></a></div><div data-reactid="472"><a target="_blank" rel="noopener noreferrer" href="https://github.com/dvajs/dva" data-reactid="473">dva</a><!-- react-text: 474 --> - <!-- /react-text --><span data-reactid="475"><!-- react-text: 476 -->应用框架<!-- /react-text --></span></div><div data-reactid="477"><a target="_blank" rel="noopener noreferrer" href="https://github.com/dvajs/dva-cli" data-reactid="478">dva-cli</a><!-- react-text: 479 --> -<!-- /react-text --><span data-reactid="480"><!-- react-text: 481 -->脚手架<!-- /react-text --></span></div><div data-reactid="482"><a target="_blank" rel="noopener noreferrer" href="http://ant-tool.github.io" data-reactid="483">ant-tool</a><!-- react-text: 484 --> - <!-- /react-text --><span data-reactid="485"><!-- react-text: 486 -->开发工具<!-- /react-text --></span></div></li><li data-reactid="487"><h2 data-reactid="488"><span data-reactid="489"><!-- react-text: 490 -->相关站点<!-- /react-text --></span></h2><div data-reactid="491"><a href="http://mobile.ant.design" data-reactid="492">Ant Design Mobile</a><span data-reactid="493"> - </span><span data-reactid="494"><!-- react-text: 495 -->移动版<!-- /react-text --></span></div><div data-reactid="496"><a href="https://g2.alipay.com/" data-reactid="497">G2</a><span data-reactid="498"> - </span><span data-reactid="499"><!-- react-text: 500 -->数据可视化<!-- /react-text --></span></div><div data-reactid="501"><a href="https://antv.alipay.com/" data-reactid="502">AntV</a><span data-reactid="503"> - </span><span data-reactid="504"><!-- react-text: 505 -->数据可视化规范<!-- /react-text --></span></div><div data-reactid="506"><a href="http://motion.ant.design" data-reactid="507">Ant Motion</a><span data-reactid="508"> - </span><span data-reactid="509"><!-- react-text: 510 -->设计动效<!-- /react-text --></span></div><div data-reactid="511"><a href="http://library.ant.design/" data-reactid="512">AntD Library</a><span data-reactid="513"> - </span><span data-reactid="514"><!-- react-text: 515 -->Axure 部件库<!-- /react-text --></span></div><div data-reactid="516"><a href="http://ux.ant.design" data-reactid="517">Ant UX</a><span data-reactid="518"> - </span><span data-reactid="519"><!-- react-text: 520 -->页面逻辑素材<!-- /react-text --></span></div></li><li data-reactid="521"><h2 data-reactid="522"><span data-reactid="523"><!-- react-text: 524 -->社区<!-- /react-text --></span></h2><div data-reactid="525"><a rel="noopener noreferrer" href="/changelog" data-reactid="526"><span data-reactid="527"><!-- react-text: 528 -->更新记录<!-- /react-text --></span></a></div><div data-reactid="529"><a target="_blank" rel="noopener noreferrer" href="https://github.com/ant-design/ant-design/issues" data-reactid="530"><span data-reactid="531"><!-- react-text: 532 -->反馈和建议<!-- /react-text --></span></a></div><div data-reactid="533"><a target="_blank" rel="noopener noreferrer" href="https://gitter.im/ant-design/ant-design" data-reactid="534"><span data-reactid="535"><!-- react-text: 536 -->讨论<!-- /react-text --></span></a></div><div data-reactid="537"><a target="_blank" rel="noopener noreferrer" href="https://github.com/ant-design/ant-design/issues/new" data-reactid="538"><span data-reactid="539"><!-- react-text: 540 -->报告 Bug<!-- /react-text --></span></a></div></li><li data-reactid="541"><div data-reactid="542"><!-- react-text: 543 -->©2016 <!-- /react-text --><span data-reactid="544"><!-- react-text: 545 -->蚂蚁金服体验技术部出品<!-- /react-text --></span></div><div data-reactid="546"><!-- react-text: 547 -->Powered by <!-- /react-text --><a href="https://github.com/benjycui/bisheng" data-reactid="548">BiSheng</a></div><div style="margin-top:10px;" data-reactid="549"><span data-reactid="550"><!-- react-text: 551 -->文档版本：<!-- /react-text --></span><div class="ant-select-sm ant-select ant-select-enabled" data-reactid="552"><div class="ant-select-selection
ant-select-selection--single" role="combobox" aria-autocomplete="list" aria-haspopup="true" aria-expanded="false" tabindex="0" data-reactid="553"><div class="ant-select-selection__rendered" data-reactid="554"><div class="ant-select-selection-selected-value" title="1.11.4" style="display:block;opacity:1;" data-reactid="555">1.11.4</div></div><span class="ant-select-arrow" style="user-select:none;-webkit-user-select:none;" unselectable="unselectable" data-reactid="556"><b data-reactid="557"></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>
// 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>
<script src="/common.js"></script>
<script src="/index.js"></script>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink