index.md 2.5 KB


category: 开始 title: Getting Started 快速开始 subTitle: 快速开始 localeCode: zh-CN icon: doc-gettingstarted

order: 2

1、安装 Semi

# 使用 npm
npm i @douyinfe/semi-ui

# 使用 yarn
yarn add @douyinfe/semi-ui

2、模块化方式使用组件

import React, { Component } from 'react';
import { Button, Toast } from '@douyinfe/semi-ui';

class Demo extends React.Component {
    constructor() {
        super();
    }

    render() {
        return <Button onClick={() => Toast.warning({ content: 'welcome' })}>Hello Semi</Button>;
    }
}

推荐在项目中引入 reset.css,它可以避免引入浏览器自带的默认样式。

3、UMD 方式使用组件

我们并不推荐直接使用已构建文件,这样会全量引入所有组件,无法实现按需加载。但如果确实有非构建场景的需求,可以通过以下方式引用

在浏览器中使用 script 和 link 标签直接引入文件,并使用全局变量 SemiUI

  1. 请确保你已提前引入 react 以及 react-dom
  2. 引入 JS 文件,以下示例 URL 中 2.0.0 为 version 标识,希望使用不同版本 Semi 时,将 version 中对应的值替换即可(注意构建文件仅在 v1.3.0 后开始提供)
  3. 引入 Semi 默认主题的 CSS 样式文件
    https://unpkg.com/@douyinfe/[email protected]/dist/css/semi.css

    <!DOCTYPE html>
    <html lang="zh-cn">
    <head>
        <script src="https://unpkg.com/[email protected]/babel.min.js"></script>
    +       <script crossorigin src="https://unpkg.com/react@16/umd/react.development.js"></script>
    +       <script crossorigin src="https://unpkg.com/react-dom@16/umd/react-dom.development.js"></script>
    
    +       <script src="https://unpkg.com/@douyinfe/[email protected]/dist/umd/semi-ui.min.js"></script>
    +       <link rel="stylesheet" href="https://unpkg.com/@douyinfe/[email protected]/dist/css/semi.css">
    
    </head>
    <body>
        <div id="root">1</div>
    </body>
    </html>
    
    <script type="text/babel">
    const { Input, Button, Toast, Icon, Form } = SemiUI;
    ReactDOM.render(
        <div>
            <Button onClick={() => Toast.warning({ duration: 0, content: 'Semi Design' })}>test</Button>
            <Input defaultValue="semi" onChange={value => Toast.info('hello semi')}></Input>
        </div>, document.getElementById("root"));
    </script>