mirror of
https://gitee.com/ElemeFE/element.git
synced 2024-12-05 05:38:24 +08:00
218 lines
9.2 KiB
Markdown
218 lines
9.2 KiB
Markdown
## 常见问题
|
||
|
||
<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` 修饰符。
|
||
</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` 即为对应行的数据。
|
||
</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)进行配置。
|
||
</details>
|
||
|
||
<details>
|
||
<summary>所有组件的任意属性都支持 `.sync` 修饰符吗？</summary>
|
||
|
||
不是。对于支持 `.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)。
|
||
</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) 的项目模板。
|
||
</details>
|
||
|
||
<details>
|
||
<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.
|
||
</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.
|
||
</details>
|
||
|
||
<details>
|
||
<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>
|
||
|
||
<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>When do you update documentations of Element?</summary>
|
||
|
||
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>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>
|
||
|
||
<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>¿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>
|
||
|
||
<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>¿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>
|
||
|
||
<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>
|
||
|
||
<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>
|
||
|
||
<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>
|
||
|
||
<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>
|