|
|
@@ -1,143 +1,217 @@
|
|
|
## 常见问题
|
|
|
|
|
|
<details>
|
|
|
-<summary>给组件绑定的事件为什么无法触发？</summary>
|
|
|
-
|
|
|
-在 Vue 2.0 中，为**自定义**组件绑定**原生**事件必须使用 `.native` 修饰符：
|
|
|
-```html
|
|
|
-<my-component @click.native="handleClick">Click Me</my-component>
|
|
|
-```
|
|
|
-
|
|
|
-从易用性的角度出发，我们对 `Button` 组件进行了处理，使它可以监听 `click` 事件：
|
|
|
-```html
|
|
|
-<el-button @click="handleButtonClick">Click Me</el-button>
|
|
|
-```
|
|
|
-
|
|
|
-但是对于其他组件，还是需要添加 `.native` 修饰符。
|
|
|
+ <summary>给组件绑定的事件为什么无法触发？</summary>
|
|
|
+
|
|
|
+ 在 Vue 2.0 中，为**自定义**组件绑定**原生**事件必须使用 `.native` 修饰符：
|
|
|
+ ```html
|
|
|
+ <my-component @click.native="handleClick">Click Me</my-component>
|
|
|
+ ```
|
|
|
+
|
|
|
+ 从易用性的角度出发，我们对 `Button` 组件进行了处理，使它可以监听 `click` 事件：
|
|
|
+ ```html
|
|
|
+ <el-button @click="handleButtonClick">Click Me</el-button>
|
|
|
+ ```
|
|
|
+
|
|
|
+ 但是对于其他组件，还是需要添加 `.native` 修饰符。
|
|
|
</details>
|
|
|
|
|
|
<details>
|
|
|
-<summary>如何在 Table 组件的每一行添加操作该行数据的按钮？</summary>
|
|
|
-
|
|
|
-使用 [Scoped slot](https://vuejs.org/v2/guide/components.html#Scoped-Slots) 即可：
|
|
|
-```html
|
|
|
-<el-table-column label="操作">
|
|
|
- <template slot-scope="props">
|
|
|
- <el-button @click.native="showDetail(props.row)">查看详情</el-button>
|
|
|
- </template>
|
|
|
-</el-table-column>
|
|
|
-```
|
|
|
-参数 `row` 即为对应行的数据。
|
|
|
+ <summary>如何在 Table 组件的每一行添加操作该行数据的按钮？</summary>
|
|
|
+
|
|
|
+ 使用 [Scoped slot](https://vuejs.org/v2/guide/components.html#Scoped-Slots) 即可：
|
|
|
+ ```html
|
|
|
+ <el-table-column label="操作">
|
|
|
+ <template slot-scope="props">
|
|
|
+ <el-button @click.native="showDetail(props.row)">查看详情</el-button>
|
|
|
+ </template>
|
|
|
+ </el-table-column>
|
|
|
+ ```
|
|
|
+ 参数 `row` 即为对应行的数据。
|
|
|
</details>
|
|
|
|
|
|
<details>
|
|
|
-<summary>Tree 组件的 `render-content` 和 Table 组件的 `render-header` 怎么用？</summary>
|
|
|
-
|
|
|
-请阅读 Vue 文档 [Render Function](http://vuejs.org/v2/guide/render-function.html) 的相关内容。注意，使用 JSX 来写 Render Function 的话，需要安装 `babel-plugin-transform-vue-jsx`，并参照其[文档](https://github.com/vuejs/babel-plugin-transform-vue-jsx)进行配置。
|
|
|
+ <summary>Tree 组件的 `render-content` 和 Table 组件的 `render-header` 怎么用？</summary>
|
|
|
+
|
|
|
+ 请阅读 Vue 文档 [Render Function](http://vuejs.org/v2/guide/render-function.html) 的相关内容。注意，使用 JSX 来写 Render Function 的话，需要安装 `babel-plugin-transform-vue-jsx`，并参照其[文档](https://github.com/vuejs/babel-plugin-transform-vue-jsx)进行配置。
|
|
|
</details>
|
|
|
|
|
|
<details>
|
|
|
-<summary>所有组件的任意属性都支持 `.sync` 修饰符吗？</summary>
|
|
|
+ <summary>所有组件的任意属性都支持 `.sync` 修饰符吗？</summary>
|
|
|
|
|
|
-不是。对于支持 `.sync` 修饰符的属性，我们会在文档的 API 表格中注明。更多 `.sync` 的用法请查看 [Vue 文档](https://vuejs.org/v2/guide/components.html#sync-Modifier)。
|
|
|
+ 不是。对于支持 `.sync` 修饰符的属性，我们会在文档的 API 表格中注明。更多 `.sync` 的用法请查看 [Vue 文档](https://vuejs.org/v2/guide/components.html#sync-Modifier)。
|
|
|
</details>
|
|
|
|
|
|
<details>
|
|
|
-<summary>你们的文档怎么偷偷更新了？</summary>
|
|
|
-
|
|
|
-我们只会在 Element 发布新版本时同步更新文档，以体现最新的变化。详细的更新内容可以查看 [changelog](https://github.com/ElemeFE/element/blob/master/CHANGELOG.zh-CN.md)。
|
|
|
+ <summary>你们的文档怎么偷偷更新了？</summary>
|
|
|
+
|
|
|
+ 我们只会在 Element 发布新版本时同步更新文档，以体现最新的变化。详细的更新内容可以查看 [changelog](https://github.com/ElemeFE/element/blob/master/CHANGELOG.zh-CN.md)。
|
|
|
</details>
|
|
|
|
|
|
<details>
|
|
|
-<summary>在项目中引入 Element，但是 CSS 报错/字体文件报错/组件没有样式是什么原因？</summary>
|
|
|
-
|
|
|
-请参考我们提供的 [starter kit](https://github.com/ElementUI/element-starter)，在 webpack 的 loaders 中正确配置 file-loader、css-loader 和 style-loader。此外，我们还提供了基于 [cooking](https://github.com/ElementUI/element-cooking-starter) 和 [laravel](https://github.com/ElementUI/element-in-laravel-starter) 的项目模板。
|
|
|
+ <summary>在项目中引入 Element，但是 CSS 报错/字体文件报错/组件没有样式是什么原因？</summary>
|
|
|
+
|
|
|
+ 请参考我们提供的 [starter kit](https://github.com/ElementUI/element-starter)，在 webpack 的 loaders 中正确配置 file-loader、css-loader 和 style-loader。此外，我们还提供了基于 [cooking](https://github.com/ElementUI/element-cooking-starter) 和 [laravel](https://github.com/ElementUI/element-in-laravel-starter) 的项目模板。
|
|
|
</details>
|
|
|
|
|
|
<details>
|
|
|
-<summary>将 Element 克隆至本地，运行时为何会报错/跑不起来？</summary>
|
|
|
-
|
|
|
-首先，确保克隆的是 master 分支的最新代码，并且文件完整。其次，确保本地的 node 版本在 4.0 以上，npm 版本在 3.0 以上。最后，可以启动开发环境：
|
|
|
-
|
|
|
-```bash
|
|
|
-npm run dev
|
|
|
-```
|
|
|
-
|
|
|
-或是直接打包：
|
|
|
-
|
|
|
-```bash
|
|
|
-npm run dist
|
|
|
-```
|
|
|
+ <summary>将 Element 克隆至本地，运行时为何会报错/跑不起来？</summary>
|
|
|
+
|
|
|
+ 首先，确保克隆的是 master 分支的最新代码，并且文件完整。其次，确保本地的 node 版本在 4.0 以上，npm 版本在 3.0 以上。最后，可以启动开发环境：
|
|
|
+
|
|
|
+ ```bash
|
|
|
+ npm run dev
|
|
|
+ ```
|
|
|
+
|
|
|
+ 或是直接打包：
|
|
|
+
|
|
|
+ ```bash
|
|
|
+ npm run dist
|
|
|
+ ```
|
|
|
</details>
|
|
|
|
|
|
## FAQ
|
|
|
|
|
|
<details>
|
|
|
-<summary>Why are my event listeners not working?</summary>
|
|
|
-
|
|
|
-In Vue 2.0, adding **native** event handlers in **custom** components requires a `.native` modifier:
|
|
|
-```html
|
|
|
-<my-component @click.native="handleClick">Click Me</my-component>
|
|
|
-```
|
|
|
-
|
|
|
-For the sake of usability, we processed `Button` so it can listen to `click` events:
|
|
|
-```html
|
|
|
-<el-button @click="handleButtonClick">Click Me</el-button>
|
|
|
-```
|
|
|
-
|
|
|
-For other components, the `.native` modifier is still mandatory.
|
|
|
+ <summary>Why are my event listeners not working?</summary>
|
|
|
+
|
|
|
+ In Vue 2.0, adding **native** event handlers in **custom** components requires a `.native` modifier:
|
|
|
+ ```html
|
|
|
+ <my-component @click.native="handleClick">Click Me</my-component>
|
|
|
+ ```
|
|
|
+
|
|
|
+ For the sake of usability, we processed `Button` so it can listen to `click` events:
|
|
|
+ ```html
|
|
|
+ <el-button @click="handleButtonClick">Click Me</el-button>
|
|
|
+ ```
|
|
|
+
|
|
|
+ For other components, the `.native` modifier is still mandatory.
|
|
|
</details>
|
|
|
|
|
|
<details>
|
|
|
-<summary>How do I add buttons in each row of Table to operate data of that row?</summary>
|
|
|
-
|
|
|
-Just use [Scoped slot](https://vuejs.org/v2/guide/components.html#Scoped-Slots):
|
|
|
-```html
|
|
|
-<el-table-column label="Operations">
|
|
|
- <template slot-scope="props">
|
|
|
- <el-button @click.native="showDetail(props.row)">Details</el-button>
|
|
|
- </template>
|
|
|
-</el-table-column>
|
|
|
-```
|
|
|
-The parameter `row` is the data object of corresponding row.
|
|
|
+ <summary>How do I add buttons in each row of Table to operate data of that row?</summary>
|
|
|
+
|
|
|
+ Just use [Scoped slot](https://vuejs.org/v2/guide/components.html#Scoped-Slots):
|
|
|
+ ```html
|
|
|
+ <el-table-column label="Operations">
|
|
|
+ <template slot-scope="props">
|
|
|
+ <el-button @click.native="showDetail(props.row)">Details</el-button>
|
|
|
+ </template>
|
|
|
+ </el-table-column>
|
|
|
+ ```
|
|
|
+ The parameter `row` is the data object of corresponding row.
|
|
|
</details>
|
|
|
|
|
|
<details>
|
|
|
-<summary>How do `render-content` of Tree and `render-header` of Table work?</summary>
|
|
|
+ <summary>How do `render-content` of Tree and `render-header` of Table work?</summary>
|
|
|
+
|
|
|
+ Please refer to [Render Function](http://vuejs.org/v2/guide/render-function.html) in Vue's documentation. In addition, if you are writing render functions with JSX, `babel-plugin-transform-vue-jsx` is required. See [here](https://github.com/vuejs/babel-plugin-transform-vue-jsx) for its configurations.
|
|
|
+</details>
|
|
|
|
|
|
-Please refer to [Render Function](http://vuejs.org/v2/guide/render-function.html) in Vue's documentation. In addition, if you are writing render functions with JSX, `babel-plugin-transform-vue-jsx` is required. See [here](https://github.com/vuejs/babel-plugin-transform-vue-jsx) for its configurations.
|
|
|
+<details>
|
|
|
+ <summary>Can I use `.sync` modifier on every attribute?</summary>
|
|
|
+
|
|
|
+ No, only a few attributes supports the `.sync` modifier, and we have explicitly marked them on the documentation's API table. For more information about `.sync`, please refer to [Vue documentation](https://vuejs.org/v2/guide/components.html#sync-Modifier).
|
|
|
</details>
|
|
|
|
|
|
<details>
|
|
|
-<summary>Can I use `.sync` modifier on every attribute?</summary>
|
|
|
+ <summary>When do you update documentations of Element?</summary>
|
|
|
|
|
|
-No, only a few attributes supports the `.sync` modifier, and we have explicitly marked them on the documentation's API table. For more information about `.sync`, please refer to [Vue documentation](https://vuejs.org/v2/guide/components.html#sync-Modifier).
|
|
|
+ We update documentations only when a new version of Element is published so that it reflects all the changes introduced in that version. Updated changed can be found in the [changelog](https://github.com/ElemeFE/element/blob/master/CHANGELOG.en-US.md)。
|
|
|
</details>
|
|
|
|
|
|
<details>
|
|
|
-<summary>When do you update documentations of Element?</summary>
|
|
|
+ <summary>I imported Element in my project, but why does it report CSS error/font file error/components have no style?</summary>
|
|
|
+
|
|
|
+ Please refer to our [starter kit](https://github.com/ElementUI/element-starter) and correctly configure file-loader, css-loader and style-loader in webpack config file. Besides, we also provide templated based on [cooking](https://github.com/ElementUI/element-cooking-starter) and [laravel](https://github.com/ElementUI/element-in-laravel-starter).
|
|
|
+</details>
|
|
|
|
|
|
-We update documentations only when a new version of Element is published so that it reflects all the changes introduced in that version. Updated changed can be found in the [changelog](https://github.com/ElemeFE/element/blob/master/CHANGELOG.en-US.md)。
|
|
|
+<details>
|
|
|
+ <summary>I cloned Element's repo, but failed to run it. How do I solve it?</summary>
|
|
|
+
|
|
|
+ First, please make sure to clone the latest code in master branch and cloned files are intact. Then, note that the version of Nodejs should be 4.0+ and npm 3.0+. Finally, activate development:
|
|
|
+
|
|
|
+ ```bash
|
|
|
+ npm run dev
|
|
|
+ ```
|
|
|
+
|
|
|
+ or build it:
|
|
|
+
|
|
|
+ ```bash
|
|
|
+ npm run dist
|
|
|
+ ```
|
|
|
</details>
|
|
|
|
|
|
+## Preguntas más frecuentes
|
|
|
+
|
|
|
<details>
|
|
|
-<summary>I imported Element in my project, but why does it report CSS error/font file error/components have no style?</summary>
|
|
|
+ <summary>¿Porque mis receptores de eventos no funcionan?</summary>
|
|
|
+
|
|
|
+ En Vue 2.0, agregando **nativos** receptores de evento **a medida** componentes requiere el modificador `.native`:
|
|
|
+ ```
|
|
|
+ html
|
|
|
+ <mi-componente @click.native="handleClick">Haga Clic Aquí</mi-componente>
|
|
|
+ ```
|
|
|
+
|
|
|
+ Para conveniencia, hemos ya procesado eventos para el componente `Button` para que el interfaz sea consistente con `clic` eventos de otros componentes:
|
|
|
+
|
|
|
+ ```html
|
|
|
+ <el-button @click="handleButtonClick">Haga Clic Aquí</el-button>
|
|
|
+ ```
|
|
|
+
|
|
|
+ Para otros componentes el uso del modificador `.native` sigue siendo obligatorio.
|
|
|
+</details>
|
|
|
|
|
|
-Please refer to our [starter kit](https://github.com/ElementUI/element-starter) and correctly configure file-loader, css-loader and style-loader in webpack config file. Besides, we also provide templated based on [cooking](https://github.com/ElementUI/element-cooking-starter) and [laravel](https://github.com/ElementUI/element-in-laravel-starter).
|
|
|
+<details>
|
|
|
+ <summary>¿Como agrego botones en cada linea de una tabla para que operen en los datos de esa linea?</summary>
|
|
|
+
|
|
|
+ Simplemente agregue [“Scoped slot”](https://vuejs.org/v2/guide/components.html#Scoped-Slots):
|
|
|
+ ```html
|
|
|
+ <el-table-column label="Operaciones">
|
|
|
+ <template slot-scope="props">
|
|
|
+ <el-button @click.native="verDetalles(props.row)">Detalles</el-button>
|
|
|
+ </template>
|
|
|
+ </el-table-column>
|
|
|
+ ```
|
|
|
+ El parámetro `row` contiene los datos de la linea correspondiente de la tabla.
|
|
|
</details>
|
|
|
|
|
|
<details>
|
|
|
-<summary>I cloned Element's repo, but failed to run it. How do I solve it?</summary>
|
|
|
+ <summary>¿Como funcionan `render-content` de `Tree` y `render-header` de `Table`?</summary>
|
|
|
+
|
|
|
+ Por favor refiérase a [Función de representación](http://vuejs.org/v2/guide/render-function.html) en la documentación de `Vue`. Adicionalmente, sí usted está escribiendo funciones de representar con JSX, se requiere el componente `babel-plugin-transform-vue-jsx`. Más información [aquí](https://github.com/vuejs/babel-plugin-transform-vue-jsx) para su uso y configuración.
|
|
|
+</details>
|
|
|
|
|
|
-First, please make sure to clone the latest code in master branch and cloned files are intact. Then, note that the version of Nodejs should be 4.0+ and npm 3.0+. Finally, activate development:
|
|
|
+<details>
|
|
|
+ <summary>¿Puedo usar el modificador `.sync` con cada atributo?</summary>
|
|
|
+
|
|
|
+ No, solamente un grupo pequeño de atributos apoyan el modificador `.sync`, y están anotados claramente en la documentación del IPA. Para información adicional sobre `.sync`, por favor refiérase a [documentación de Vue](https://vuejs.org/v2/guide/components.html#sync-Modifier).
|
|
|
+</details>
|
|
|
|
|
|
-```bash
|
|
|
-npm run dev
|
|
|
-```
|
|
|
+<details>
|
|
|
+ <summary>¿Cuando añaden a la documentación de `Element`?</summary>
|
|
|
+
|
|
|
+ Añadamos la documentación con cada versión nueva de `Element` y los cambios reflejan los cambios del software de esa versión. Los cambios actuales y históricos se encuentran [aquí](https://github.com/ElemeFE/element/blob/master/CHANGELOG.en-US.md).
|
|
|
+</details>
|
|
|
|
|
|
-or build it:
|
|
|
+<details>
|
|
|
+ <summary>¿Importé `Element` a mi proyecto pero tengo errores con `CSS` y/o fuentes y mis componentes no tienen ningún estilo?</summary>
|
|
|
+
|
|
|
+ Refiérase a [nuestro ‘kit’ de inicio](https://github.com/ElementUI/element-starter) y configure correctamente `file-loader`, `css-loader` y `style-loader` en el archivo `webpack config`. Además, proveemos un ejemplar para [cooking](https://github.com/ElementUI/element-cooking-starter) y para [laravel](https://github.com/ElementUI/element-in-laravel-starter).
|
|
|
+</details>
|
|
|
|
|
|
-```bash
|
|
|
-npm run dist
|
|
|
-```
|
|
|
+<details>
|
|
|
+ <summary>Hice un clon del repositorio de `Element` pero no arranca. ¿Como lo resuelvo?</summary>
|
|
|
+
|
|
|
+ Primero, pro favor, asegúrese de usar la versión más corriente en la rama `master` y que los archivos están en orden. Después, revise sí la versión de `Nodejs` es 4.0+ y `npm` debe ser 3.0+. Finalmente active el modo desarrollo:
|
|
|
+
|
|
|
+ ```bash
|
|
|
+ npm run dev
|
|
|
+ ```
|
|
|
+
|
|
|
+ O arme su aplicación así:
|
|
|
+
|
|
|
+ ```bash
|
|
|
+ npm run dist
|
|
|
+ ```
|
|
|
</details>
|
Leopoldthecoder