From 064ec7ef39b9e32a2a1fb7bcc6611309ce78dcf5 Mon Sep 17 00:00:00 2001 From: honlyHuang Date: Tue, 27 Aug 2019 10:35:34 +0800 Subject: [PATCH 1/4] =?UTF-8?q?fix(taroize):=20=E7=BB=99app.js=E6=B7=BB?= =?UTF-8?q?=E5=8A=A0withWeapp?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- packages/taroize/src/script.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/taroize/src/script.ts b/packages/taroize/src/script.ts index 9b1946296b86..3a580da6809b 100644 --- a/packages/taroize/src/script.ts +++ b/packages/taroize/src/script.ts @@ -70,7 +70,7 @@ export function parseScript ( refId, wxses ) - if (componentType !== 'App' && classDecl.decorators!.length === 0) { + if (classDecl.decorators!.length === 0) { classDecl.decorators = [buildDecorator(componentType)] } ast.program.body.push( From 9d94380ee33af32b393f9dc3e52e831f97d02906 Mon Sep 17 00:00:00 2001 From: honlyHuang Date: Tue, 27 Aug 2019 10:38:20 +0800 Subject: [PATCH 2/4] =?UTF-8?q?fix(with-weapp):=20=E7=BB=99onShow=E4=BC=A0?= =?UTF-8?q?=E9=80=92options?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- packages/taro-with-weapp/src/index.ts | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/packages/taro-with-weapp/src/index.ts b/packages/taro-with-weapp/src/index.ts index 562832f8bc38..5032a3db0396 100644 --- a/packages/taro-with-weapp/src/index.ts +++ b/packages/taro-with-weapp/src/index.ts @@ -148,7 +148,9 @@ export default function withWeapp (componentType: string, weappConf?: Object) { componentDidShow () { this.safeExecute(this.onShow) - this.safeExecute(super.componentDidShow) + if (super.componentDidShow) { + super.componentDidShow.call(this, this.$router.params || {}) + } } componentDidMount () { From cbc75e4daaa9accc99db3e0dba398740ee94880d Mon Sep 17 00:00:00 2001 From: Pines-Cheng Date: Tue, 27 Aug 2019 11:15:33 +0800 Subject: [PATCH 3/4] docs: update docs --- docs/README.md | 32 +++++++++++++++++++++++++------- website/i18n/en.json | 22 ++++++++++++++++++++++ website/sidebars.json | 2 +- 3 files changed, 48 insertions(+), 8 deletions(-) diff --git a/docs/README.md b/docs/README.md index eb1d6f484ba2..b06c3c8bfba1 100644 --- a/docs/README.md +++ b/docs/README.md @@ -4,7 +4,9 @@ title: Taro 介绍 ## 简介 -**Taro** 是一套遵循 [React](https://reactjs.org/) 语法规范的 **多端开发** 解决方案。现如今市面上端的形态多种多样，Web、React-Native、微信小程序等各种端大行其道，当业务要求同时在不同的端都要求有所表现的时候，针对不同的端去编写多套代码的成本显然非常高，这时候只编写一套代码就能够适配到多端的能力就显得极为需要。 +**Taro** 是一套遵循 [React](https://reactjs.org/) 语法规范的 **多端开发** 解决方案。 + +现如今市面上端的形态多种多样，Web、React-Native、微信小程序等各种端大行其道，当业务要求同时在不同的端都要求有所表现的时候，针对不同的端去编写多套代码的成本显然非常高，这时候只编写一套代码就能够适配到多端的能力就显得极为需要。 使用 **Taro**，我们可以只书写一套代码，再通过 **Taro** 的编译工具，将源代码分别编译出可以在不同端（微信/百度/支付宝/字节跳动/QQ小程序、快应用、H5、React-Native 等）运行的代码。 @@ -12,7 +14,7 @@ title: Taro 介绍 #### React 语法风格 -**Taro** 遵循 [React](https://reactjs.org/) 语法规范，它采用与 React 一致的组件化思想，组件生命周期与 React 保持一致，同时支持使用 JSX 语法，让代码具有更丰富的表现力，使用 **Taro** 进行开发可以获得和 React 一致的开发体验。 +**Taro** 遵循 [React](https://reactjs.org/) 语法规范，它采用与 React 一致的组件化思想，组件生命周期与 React 保持一致，同时支持使用 [JSX 语法](jsx.html)，让代码具有更丰富的表现力，使用 **Taro** 进行开发可以获得和 React 一致的开发体验。 代码示例 @@ -63,6 +65,8 @@ export default class Index extends Component { } ``` +> 由于微信小程序端的限制，有极少数 JSX 的优秀用法暂时不能得到很好地支持，同时，为了遵循 React 与法，Taro 在写法上也有一些自己的规范，具体可以参考：[Taro 开发最佳实践](best-practice.html) 。 + #### 快速开发微信小程序 Taro 立足于微信小程序开发，众所周知小程序的开发体验并不是非常友好，比如小程序中无法使用 npm 来进行第三方库的管理，无法使用一些比较新的 ES 规范等等，针对小程序端的开发弊端，Taro 具有以下的优秀特性 @@ -93,22 +97,36 @@ Taro 方案的初心就是为了打造一个多端开发的解决方案。目前 ## Taro UI -一款基于 `Taro` 框架开发的多端 UI 组件库 +一款基于 `Taro` 框架开发的多端 UI 组件库。 -#### Taro UI 特性 +[Taro UI](https://taro-ui.jd.com) 特性： - 基于 `Taro` 开发 UI 组件 - 一套组件可以在 `微信小程序`，`支付宝小程序`，`百度小程序`，`H5` 多端适配运行（`ReactNative` 端暂不支持） - 提供友好的 API，可灵活的使用组件 -[Taro UI 官网](https://taro-ui.jd.com) +## 学习资源 +### 官方文章精选 +- [使用 React Hooks 重构你的小程序](https://aotu.io/notes/2019/07/10/taro-hooks/) +- [Taro 1.3 震撼发布：全面支持 JSX 语法和 HOOKS](https://aotu.io/notes/2019/06/13/taro-1-3/) +- [小程序框架全面测评](https://aotu.io/notes/2019/03/12/mini-program-framework-full-review/) +- [Taro 在京东购物小程序上的实践](https://aotu.io/notes/2018/09/11/taro-in-jd/) +- [用 React 开发小程序的探索之路 （演讲内容整理）| 掘金开发者大会](https://juejin.im/post/5ba346a7f265da0ad13b78bd) +- [为何我们要用 React 来写小程序 - Taro 诞生记](https://aotu.io/notes/2018/06/25/the-birth-of-taro/) +- [多端统一开发框架 - Taro介绍](https://aotu.io/notes/2018/06/07/Taro/) -## 学习资源 +### 分享交流 +- [第十三届 D2 前端技术论坛——使用 Taro 快速构建多端应用](https://www.yuque.com/d2forum/content/d213#6a1363f4) +- [WeGeek直播课：从0到1快速开发电商小程序](https://link.juejin.im/?target=https%3A%2F%2Fcloud.tencent.com%2Fedu%2Flearning%2Flive-1497) +- [掘金开发者大会——用React开发小程序的探索之路](https://www.itdks.com/Course/detail?id=16289) -[awesome-taro](https://github.com/NervJS/awesome-taro) +### 其他 +更多文章教程、开源项目等，请参考：[awesome-taro](https://github.com/NervJS/awesome-taro) 掘金小册：[Taro 多端开发实现原理与实战](https://juejin.im/book/5b73a131f265da28065fb1cd?referrer=5ba228f16fb9a05d3251492d) ## 开发交流 +扫码添加 `凹凸实验室-小助手` ，回复 `Taro` 即可进群。（Taro 开发交流12群 已满） + ![image](https://camo.githubusercontent.com/519861ac48c204c6038cea71ea10e1d991f36163/68747470733a2f2f696d6733302e333630627579696d672e636f6d2f6c696e672f6a66732f74312f38313133312f31332f3730302f33353431312f35636566343339664538616366366163342f323331393531336663303734303465362e706e67) diff --git a/website/i18n/en.json b/website/i18n/en.json index f08abc9b564e..0da907af5a6c 100644 --- a/website/i18n/en.json +++ b/website/i18n/en.json @@ -2063,6 +2063,28 @@ }, "version-1.3.14/version-1.3.14-wxcloud": { "title": "小程序云开发模板" + }, + "version-1.3.15/components/open/version-1.3.15-ad": { + "title": "Ad", + "sidebar_label": "Ad" + }, + "version-1.3.15/components/open/version-1.3.15-official-account": { + "title": "OfficialAccount", + "sidebar_label": "OfficialAccount" + }, + "version-1.3.15/components/open/version-1.3.15-open-data": { + "title": "OpenData", + "sidebar_label": "OpenData" + }, + "version-1.3.15/components/open/version-1.3.15-others": { + "title": "其他", + "sidebar_label": "其他" + }, + "version-1.3.15/version-1.3.15-GETTING-STARTED": { + "title": "安装及使用" + }, + "version-1.3.15/version-1.3.15-size": { + "title": "设计稿及尺寸单位" } }, "links": { diff --git a/website/sidebars.json b/website/sidebars.json index cdea5c7f307e..e1be05cca274 100644 --- a/website/sidebars.json +++ b/website/sidebars.json @@ -19,6 +19,7 @@ "size", "static-reference", "component-style", + "best-practice", { "label": "语法特性", "type": "subcategory", @@ -36,7 +37,6 @@ "ref" ] }, - "best-practice", "debug", { "label": "多端开发", From d3bd247c1c48214885a8ab9ec6b75789554c5acd Mon Sep 17 00:00:00 2001 From: Pines-Cheng Date: Tue, 27 Aug 2019 14:03:44 +0800 Subject: [PATCH 4/4] docs: update docs --- docs/README.md | 2 +- docs/css-modules.md | 2 +- website/sidebars.json | 6 +++--- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/README.md b/docs/README.md index b06c3c8bfba1..4422536d9ab9 100644 --- a/docs/README.md +++ b/docs/README.md @@ -129,4 +129,4 @@ Taro 方案的初心就是为了打造一个多端开发的解决方案。目前 ## 开发交流 扫码添加 `凹凸实验室-小助手` ，回复 `Taro` 即可进群。（Taro 开发交流12群 已满） -![image](https://camo.githubusercontent.com/519861ac48c204c6038cea71ea10e1d991f36163/68747470733a2f2f696d6733302e333630627579696d672e636f6d2f6c696e672f6a66732f74312f38313133312f31332f3730302f33353431312f35636566343339664538616366366163342f323331393531336663303734303465362e706e67) +![image](https://user-images.githubusercontent.com/9441951/63744620-7994e800-c8d2-11e9-9e66-ab43d1d75fe8.png) diff --git a/docs/css-modules.md b/docs/css-modules.md index 8c297f1cb23a..7d550484bb36 100644 --- a/docs/css-modules.md +++ b/docs/css-modules.md @@ -1,5 +1,5 @@ --- -title: CSS Modules 的使用 +title: 使用 CSS Modules --- > 1.2.0 版本开始支持，RN 端已兼容 diff --git a/website/sidebars.json b/website/sidebars.json index e1be05cca274..18c2a6b10870 100644 --- a/website/sidebars.json +++ b/website/sidebars.json @@ -15,11 +15,11 @@ "spec-for-taro", "tutorial", "project-config", + "best-practice", "router", "size", "static-reference", "component-style", - "best-practice", { "label": "语法特性", "type": "subcategory", @@ -37,7 +37,6 @@ "ref" ] }, - "debug", { "label": "多端开发", "type": "subcategory", @@ -49,7 +48,8 @@ "quick-app", "react-native" ] - } + }, + "debug" ], "进阶指南": [ "config",