Skip to content

Commit

Permalink
Merge branch 'master' of github.com:NervJS/taro
Browse files Browse the repository at this point in the history
  • Loading branch information
yuche committed Jun 25, 2018
2 parents aab2a76 + df1f794 commit 911462d
Show file tree
Hide file tree
Showing 41 changed files with 2,291 additions and 592 deletions.
11 changes: 7 additions & 4 deletions .travis.yml
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,10 @@ jobs:
- stage: deploy
if: (branch = master) AND (NOT (type IN (pull_request)))
script: yarn run build:docs
provider: pages
skip-cleanup: true
github-token: $GITHUB_TOKEN
local-dir: docs/_book
deploy:
- provider: pages
skip-cleanup: true
github-token: $GITHUB_TOKEN
local-dir: docs/_book
on:
branch: master
4 changes: 4 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -176,6 +176,10 @@ $ npx taro build --type h5

本项目遵从 [Angular Style Commit Message Conventions](https://gist.github.com/stephenparish/9941e89d80e2bc58a153),更新日志由 `conventional-changelog` 自动生成。完整日志请点击 [CHANGELOG.md](./CHANGELOG.md)

## 开发交流

[官方交流微信群](https://github.com/NervJS/taro/issues/198)

## License

MIT License
Expand Down
8 changes: 4 additions & 4 deletions docs/components/base/icon.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,9 +5,9 @@
| 微信小程序 | H5 | ReactNative| 属性名 | 类型 | 默认值 | 说明 |
| :-: | :-: | :-: | :- | :- | :- | :- |
||| | type | String | | icon 的类型,有效值:success, success_no_circle, info, warn, waiting, cancel, download, search, clear |
||| | size | Number | 23 | icon 的大小,单位 px |
||| | color | Color | | icon 的颜色,同 css 的 color |
||| | type | String | | icon 的类型,有效值:success, success_no_circle, info, warn, waiting, cancel, download, search, clear |
||| | size | Number | 23 | icon 的大小,单位 px |
||| | color | Color | | icon 的颜色,同 css 的 color |



Expand All @@ -24,4 +24,4 @@
<Icon size='20' type='download' />
<Icon size='20' type='clear' color='red' />
<Icon size='20' type='search' />
```
```
18 changes: 9 additions & 9 deletions docs/components/base/progress.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,19 +5,19 @@
| 微信小程序 | H5 | ReactNative| 属性名 | 类型 | 默认值 | 说明 |
| :-: | :-: | :-: | :- | :- | :- | :- |
||| |percent | Float || 百分比 0~100 |
||| | showInfo | Boolean | false | 在进度条右侧显示百分比 |
||| | strokeWidth | Number | 6 | 进度条线的宽度,单位 px |
|| | | color | Color | #09BB07 | 进度条颜色 (请使用 activeColor)|
||| | activeColor | Color | 6 | 已选择的进度条的颜色 |
||| |backgroundColor | Color | 6 | 未选择的进度条的颜色 |
||| | active | Boolean | false | 进度条从左往右的动画 |
|| | |activeMode | String | backwards | backwards: 动画从头播;forwards:动画从上次结束点接着播 |
||| |percent | Float || 百分比 0~100 |
||| | showInfo | Boolean | false | 在进度条右侧显示百分比 |
||| | strokeWidth | Number | 6 | 进度条线的宽度,单位 px |
|| | | color | Color | #09BB07 | 进度条颜色 (请使用 activeColor)|
||| | activeColor | Color | 6 | 已选择的进度条的颜色 |
||| |backgroundColor | Color | 6 | 未选择的进度条的颜色 |
||| | active | Boolean | false | 进度条从左往右的动画 |
|| | |activeMode | String | backwards | backwards: 动画从头播;forwards:动画从上次结束点接着播 |

###### 示例:
```
<Progress percent={20} showInfo strokeWidth={2} />
<Progress percent={40} strokeWidth={2} active />
<Progress percent={60} strokeWidth={2} active />
<Progress percent={80} strokeWidth={2} active activeColor='blue' />
```
```
4 changes: 2 additions & 2 deletions docs/components/base/rich-text.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,5 +5,5 @@
| 微信小程序 | H5 | ReactNative |
| :-: | :-: | :-: |
| ✔️ | x | x |
| ✔️ | x | x |
| ✔️ | x | |
| ✔️ | x | |
8 changes: 4 additions & 4 deletions docs/components/base/text.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,9 +5,9 @@
| 微信小程序 | H5 | ReactNative| 属性名 | 类型 | 默认值 | 说明 |
| :-: | :-: | :-: | :- | :- | :- | :- |
||| | selectable | Boolean | false | 文本是否可选 |
|| | | space | Boolean | false | 显示连续空格 |
|| | | decode | Boolean | false | 是否解码 |
||| | selectable | Boolean | false | 文本是否可选 |
|| | x | space | Boolean | false | 显示连续空格 |
|| | x (true) | decode | Boolean | false | 是否解码 |

###### 示例:
```
Expand Down Expand Up @@ -54,4 +54,4 @@ export default class PageView extends Component {
)
}
}
```
```
32 changes: 16 additions & 16 deletions docs/components/forms/button.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,21 +5,21 @@
| 微信小程序 | H5 | ReactNative| 属性名 | 类型 | 默认值 | 说明 |
| :-: | :-: | :-: | :- | :- | :- | :- |
||| | type | String | default | 按钮的样式类型 |
||| | size | String | default | 按钮的大小 px |
||| | plain | Boolean | false | 按钮是否镂空,背景色透明 |
||| | disabled | Boolean | false | 是否禁用 |
||| | loading | Boolean | false | 名称前是否带 loading 图标 |
|| | | formType | String | | 用于 form 组件,点击分别会触发 form 组件的 submit/reset 事件 |
|| | | openType | String | | 微信开放能力 |
|| | | appParameter | String | | 打开 APP 时,向 APP 传递的参数 |
||| | hoverClass | String | button-hover | 指定按钮按下去的样式类。当 hover-class="none" 时,没有点击态效果 |
|| | | hoverStopPropagation | Boolean | false | 指定是否阻止本节点的祖先节点出现点击态 |
||| | hoverStartTime | Number | 20 | 按住后多久出现点击态,单位毫秒 |
||| | hoverStayTime | Number | 70 | 手指松开后点击态保留时间,单位毫秒 |
|| | | onGetUserInfo | Handler | | 用户点击该按钮时,会返回获取到的用户信息,从返回参数的 detail 中获取到的值同 wx.getUserInfo |
|| | | onGetPhoneNumber | Handler | | 获取用户手机号回调 |
|| | | lang | String | en | 指定返回用户信息的语言,zh_CN 简体中文,zh_TW 繁体中文,en 英文。 |
||| | type | String | default | 按钮的样式类型 |
||| | size | String | default | 按钮的大小 px |
||| | plain | Boolean | false | 按钮是否镂空,背景色透明 |
||| | disabled | Boolean | false | 是否禁用 |
||| | loading | Boolean | false | 名称前是否带 loading 图标 |
|| | x | formType | String | | 用于 form 组件,点击分别会触发 form 组件的 submit/reset 事件 |
|| | x | openType | String | | 微信开放能力 |
|| | x | appParameter | String | | 打开 APP 时,向 APP 传递的参数 |
||| x | hoverClass | String | button-hover | 指定按钮按下去的样式类。当 hover-class="none" 时,没有点击态效果 |
|| | x | hoverStopPropagation | Boolean | false | 指定是否阻止本节点的祖先节点出现点击态 |
||| x | hoverStartTime | Number | 20 | 按住后多久出现点击态,单位毫秒 |
||| x | hoverStayTime | Number | 70 | 手指松开后点击态保留时间,单位毫秒 |
|| | x | onGetUserInfo | Handler | | 用户点击该按钮时,会返回获取到的用户信息,从返回参数的 detail 中获取到的值同 wx.getUserInfo |
|| | x | onGetPhoneNumber | Handler | | 获取用户手机号回调 |
|| | x | lang | String | en | 指定返回用户信息的语言,zh_CN 简体中文,zh_TW 繁体中文,en 英文。 |


###### 示例:
Expand Down Expand Up @@ -102,4 +102,4 @@ export default class PageButton extends Component {
}
}
```
```
12 changes: 6 additions & 6 deletions docs/components/forms/checkbox.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
| 微信小程序 | H5 | ReactNative| 属性名 | 类型 | 默认值 | 说明 |
| :-: | :-: | :-: | :- | :- | :- | :- |
||| | onChange | EventHandle | | <CheckboxGroup/>中选中项发生改变是触发 change 事件,detail = value:[选中的 Checkbox 的 value 的数组] |
||| | onChange | EventHandle | | <CheckboxGroup/>中选中项发生改变是触发 change 事件,detail = value:[选中的 Checkbox 的 value 的数组] |

##### Checkbox
##### 多选项目。
Expand All @@ -14,11 +14,11 @@
| 微信小程序 | H5 | ReactNative| 属性名 | 类型 | 默认值 | 说明 |
| :-: | :-: | :-: | :- | :- | :- | :- |
|| | | value | String | | <Checkbox/>标识,选中时触发<CheckboxGroup/>的 change 事件,并携带 <checkbox/> 的 value |
||| | checked | Boolean | false | 当前是否选中 |
||| | disabled | Boolean | false | 是否禁用 |
||| | color | Color | | checkbox 的颜色,同 css 的 color |
||| | onChange | EventHandle | | 选中项发生变化时触发 change 事件 |
|| | | value | String | | <Checkbox/>标识,选中时触发<CheckboxGroup/>的 change 事件,并携带 <checkbox/> 的 value |
||| | checked | Boolean | false | 当前是否选中 |
||| | disabled | Boolean | false | 是否禁用 |
||| | color | Color | | checkbox 的颜色,同 css 的 color |
||| | onChange | EventHandle | | 选中项发生变化时触发 change 事件 |

###### 示例:

Expand Down
4 changes: 2 additions & 2 deletions docs/components/forms/form.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,5 +6,5 @@
| 微信小程序 | H5 | ReactNative | 属性值 | 类型 | 说明 |
| :-: | :-: | :-: | :-: |:-: | :-: | :-: |
|| x | x | reportSubmit | Boolean | 是否返回 formId 用于发送模板消息 |
| √ | √ | x | onSubmit | EventHandle | 携带 form 中的数据触发 submit 事件,event.detail = {value : {'name': 'value'}}
| √ | √ | x | onReset | EventHandle | 表单重置时会触发 reset 事件
||| | onSubmit | EventHandle | 携带 form 中的数据触发 submit 事件,event.detail = {value : {'name': 'value'}} |
||| x | onReset | EventHandle | 表单重置时会触发 reset 事件 |
42 changes: 21 additions & 21 deletions docs/components/forms/input.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,26 +4,26 @@
| 微信小程序 | H5 | ReactNative| 属性名 | 类型 | 默认值 | 说明 |
| :-: | :-: | :-: | :- | :- | :- | :- |
||| | value | String | | 输入框的初始内容 |
||| | type | String | "text" | input 的类型 |
||| | password | Boolean | false | 是否是密码类型 |
||| | placeholder | String | | 输入框为空时占位符 |
|| | | placeholderStyle | String | | 指定 placeholder 的样式 |
|| | | placeholderClass | String | "input-placeholder" | 指定 placeholder 的样式类 |
||| | disabled | Boolean | false | 是否禁用 |
||| | maxlength | Number | 140 | 最大输入长度,设置为 -1 的时候不限制最大长度 |
|| | | cursorSpacing | Number | 0 | 指定光标与键盘的距离,单位 px 。取 input 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离 |
|| | | autoFocus | Boolean | false | (即将废弃,请直接使用 focus )自动聚焦,拉起键盘 |
|| | | focus | Boolean | false | 获取焦点 |
|| | | confirmType | String | "done" | 设置键盘右下角按钮的文字 |
|| | | cursor | Number | | 指定 focus 时的光标位置 |
|| | | selectionStart | Number | -1 | 光标起始位置,自动聚集时有效,需与 selection-end 搭配使用 |
|| | | selectionEnd | Number | -1 | 光标结束位置,自动聚集时有效,需与 selection-start 搭配使用 |
|| | | adjustPosition | Boolean | true | 键盘弹起时,是否自动上推页面 |
||| | (onChange) onInput | EventHandle | | 当键盘输入时,触发 input 事件,处理函数可以直接 return 一个字符串,将替换输入框的内容。 |
||| | (onFocus) onFocus | EventHandle | | 输入框聚焦时触发,height 参数在基础库 1.9.90 起支持 |
||| | (onBlur) onBlur | EventHandle | | 输入框失去焦点时触发 |
|| | | onConfirm | EventHandle | | 点击完成按钮时触发 |
||| | value | String | | 输入框的初始内容 |
||| x (部分支持) | type | String | "text" | input 的类型 |
||| | password | Boolean | false | 是否是密码类型 |
||| | placeholder | String | | 输入框为空时占位符 |
|| | x | placeholderStyle | String | | 指定 placeholder 的样式 |
|| | x | placeholderClass | String | "input-placeholder" | 指定 placeholder 的样式类 |
||| | disabled | Boolean | false | 是否禁用 |
||| | maxlength | Number | 140 | 最大输入长度,设置为 -1 的时候不限制最大长度 |
|| | x | cursorSpacing | Number | 0 | 指定光标与键盘的距离,单位 px 。取 input 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离 |
|| | x | autoFocus | Boolean | false | (即将废弃,请直接使用 focus )自动聚焦,拉起键盘 |
|| | | focus | Boolean | false | 获取焦点 |
|| | | confirmType | String | "done" | 设置键盘右下角按钮的文字 |
|| | | cursor | Number | | 指定 focus 时的光标位置 |
|| | | selectionStart | Number | -1 | 光标起始位置,自动聚集时有效,需与 selection-end 搭配使用 |
|| | | selectionEnd | Number | -1 | 光标结束位置,自动聚集时有效,需与 selection-start 搭配使用 |
|| | x | adjustPosition | Boolean | true | 键盘弹起时,是否自动上推页面 |
||| | (onChange) onInput | EventHandle | | 当键盘输入时,触发 input 事件,处理函数可以直接 return 一个字符串,将替换输入框的内容。 |
||| | (onFocus) onFocus | EventHandle | | 输入框聚焦时触发,height 参数在基础库 1.9.90 起支持 |
||| | (onBlur) onBlur | EventHandle | | 输入框失去焦点时触发 |
|| | | onConfirm | EventHandle | | 点击完成按钮时触发 |

###### 示例:
```
Expand All @@ -43,4 +43,4 @@
<Input type='idcard' placeholder='身份证输入键盘'/>
<Text>控制占位符颜色的input</Text>
<Input type='text' placeholder='占位符字体是红色的' placeholderStyle="color:red"/>
```
```
Loading

0 comments on commit 911462d

Please sign in to comment.