Skip to content

Commit

Permalink
feat: 完善文档
Browse files Browse the repository at this point in the history
  • Loading branch information
fjc0k committed Mar 18, 2019
1 parent 142a476 commit 4a1a2cf
Showing 1 changed file with 95 additions and 0 deletions.
95 changes: 95 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,98 @@
<p align="center">
<img src="https://raw.githubusercontent.com/fjc0k/mounted/master/assets/logo.png" width="150" />
</p>

# Mounted

一款基于 [Taro](https://github.com/NervJS/taro) 的微信小程序组件库。

## 特性

- 使用 **TypeScript** 编写
- 专注 **微信小程序**
- 只产出与业务低耦合的 **基础组件**
- 支持 **自定义主题**

## 使用

首先,使用以下命令安装:

```bash
# yarn
yarn add mounted

# 或者,npm
npm i mounted --save
```

然后,在 `app.scss` 中引入组件样式:

> 若你未使用 `scss`,请在 `app.js` 同级目录新建 `app.scss`,并在 `app.js` 中引入:`import './app.scss'`
```scss
@import '~mounted/src/styles/components.scss';
```

最后,在页面中按需引入组件:

```js
import Taro from '@tarojs/taro'
import { View, Text } from '@tarojs/components'
import { MSticky } from 'mounted'

export default class Demo extends Taro.Component {
render() {
return (
<View>
<MSticky>
<View className='title'>
<Text>标题</Text>
</View>
</MSticky>
</View>
)
}
}
```

## 自定义主题

若需自定义主题,直接在 `app.scss` 中覆盖变量即可,如:

```scss
// 主色调
$primaryColor: #1AAD19;

@import '~mounted/src/styles/components.scss';
```

> 组件库所使用的样式变量都在 [src/styles/settings.scss](./src/styles/settings.scss) 文件内。
## 设计稿尺寸

组件库内部采用的是 `375` 尺寸,若你的项目也是基于 `375` 的,可跳过。

若你的项目是基于其他尺寸,比如 `750` 的,请在 `app.scss` 中覆盖设计稿尺寸变量:

```scss
// 设计稿尺寸
$designWidth: 750;

@import '~mounted/src/styles/components.scss';
```

## 组件列表

下面列出 `mounted` 包含的组件,点击相应组件名称进入可查看其 **~~文档~~** 代码:

- [FormIdCollector - Form ID 收集器](./src/components/FormIdCollector/index.tsx#L6)
- Picker - 选择器
- PickerView - 选择器视图
- [Popup - 弹出层](./src/components/Popup/index.tsx#L17)
- SinglePicker - 单项选择器
- [Sticky - 内容吸顶](./src/components/Sticky/index.tsx#L8)
- [Transition - 动画过渡](./src/components/Transition/index.tsx#L13)

## 许可

MIT © Jay Fong

0 comments on commit 4a1a2cf

Please sign in to comment.