From 166c70b94c58e2a3a511b6fe5f2a6f7433645919 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=89=A7=E6=AF=85?= <changyun.pcy@alibaba-inc.com>
Date: Fri, 21 Aug 2020 11:03:10 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E2=9C=8F=EF=B8=8F=20=E6=95=B4=E7=90=86?=
 =?UTF-8?q?=E4=BC=98=E5=8C=96=E6=B3=A8=E9=87=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../src/plugins/component/rax/jsx.ts          | 23 ++++---------------
 1 file changed, 5 insertions(+), 18 deletions(-)

diff --git a/packages/code-generator/src/plugins/component/rax/jsx.ts b/packages/code-generator/src/plugins/component/rax/jsx.ts
index 7cdb0c661..9cb1e9558 100644
--- a/packages/code-generator/src/plugins/component/rax/jsx.ts
+++ b/packages/code-generator/src/plugins/component/rax/jsx.ts
@@ -36,30 +36,12 @@ type PluginConfig = {
   fileType: string;
 };
 
-// TODO: componentName 若并非大写字符打头，甚至并非是一个有效的 JS 标识符怎么办？？
 const pluginFactory: BuilderComponentPluginFactory<PluginConfig> = (config?) => {
   const cfg: PluginConfig = {
     fileType: FileType.JSX,
     ...config,
   };
 
-  // 什么都不做的的话，会有 3 个问题：
-  // 1. 小程序出码的时候，循环变量没法拿到
-  // 2. 小程序出码的时候，很容易出现 Uncaught TypeError: Cannot read property 'avatar' of undefined 这样的异常(如下图的 50 行) -- 因为若直接出码，Rax 构建到小程序的时候会立即计算所有在视图中用到的变量
-  // 3. 通过 this.xxx 能拿到的东西太多了，而且自定义的 methods 可能会无意间破坏 Rax 框架或小程序框架在页面 this 上的东东
-  // const transformers = {
-  //   transformThis2Context: (expr: string) => expr,
-  //   transformJsExpr: (expr: string) => expr,
-  //   transformLoopExpr: (expr: string) => expr,
-  // };
-
-  // 不转换 this.xxx 到 __$$context.xxx 的话，依然会有上述的 1 和 3 的问题。
-  // const transformers = {
-  //   transformThis2Context: (expr: string) => expr,
-  //   transformJsExpr: (expr: string) => (isLiteralAtomicExpr(expr) ? expr : `__$$eval(() => (${expr}))`),
-  //   transformLoopExpr: (expr: string) => `__$$evalArray(() => (${expr}))`,
-  // };
-
   const plugin: BuilderComponentPlugin = async (pre: ICodeStruct) => {
     const next: ICodeStruct = {
       ...pre,
@@ -76,12 +58,17 @@ const pluginFactory: BuilderComponentPluginFactory<PluginConfig> = (config?) =>
       }
     });
 
+    // 注意：这里其实隐含了一个假设：schema 中的 componentName 应该是一个有效的 JS 标识符，而且是大写字母打头的
     const mapComponentNameToAliasOrKeepIt = (componentName: string) =>
       componentsNameAliasMap.get(componentName) || componentName;
 
     // 然后过滤掉所有的别名 chunks
     next.chunks = next.chunks.filter((chunk) => !isImportAliasDefineChunk(chunk));
 
+    // 如果直接按目前的 React 的方式之间出码 JSX 的话，会有 3 个问题：
+    // 1. 小程序出码的时候，循环变量没法拿到
+    // 2. 小程序出码的时候，很容易出现 Uncaught TypeError: Cannot read property 'avatar' of undefined 这样的异常(如下图的 50 行) -- 因为若直接出码，Rax 构建到小程序的时候会立即计算所有在视图中用到的变量
+    // 3. 通过 this.xxx 能拿到的东西太多了，而且自定义的 methods 可能会无意间破坏 Rax 框架或小程序框架在页面 this 上的东东
     const customHandlers: CustomHandlerSet = {
       expression(this: CustomHandlerSet, input: JSExpression) {
         return transformJsExpr(generateExpression(input), this);