element/examples/docs/es/quickstart.md

267 lines
5.2 KiB
Markdown
Raw Normal View History

## Inicio rápido
2017-11-06 19:22:02 +08:00
Esta sección te guía en el proceso de usar Element con webpack en un proyecto.
2017-11-06 19:22:02 +08:00
### Usa la plantilla de Kit de inicio
2017-11-06 19:22:02 +08:00
2017-12-03 18:03:06 +08:00
Proveemos una plantilla general [project template](https://github.com/ElementUI/element-starter). Para los usuarios de Laravel, también tenemos [template](https://github.com/ElementUI/element-in-laravel-starter). Puedes descargarlas y agregarlas directamente también.
2017-11-06 19:22:02 +08:00
2017-12-03 18:03:06 +08:00
Si prefiere no utilizarlas, lee las siguientes secciones de este documento.
2017-11-06 19:22:02 +08:00
### Usando vue-cli
2017-11-06 19:22:02 +08:00
Podemos empezar un proyecto utilizando [vue-cli](https://github.com/vuejs/vue-cli):
2017-11-06 19:22:02 +08:00
```shell
> npm i -g vue-cli
> mkdir my-project && cd my-project
> vue init webpack
> npm i && npm i element-ui
```
### Importando Element
2017-11-06 19:22:02 +08:00
2017-12-03 18:03:06 +08:00
Puede importar Element completamente o solamente importar lo que necesite. Comencemos importando todo.
2017-11-06 19:22:02 +08:00
#### Importando todo
2017-11-06 19:22:02 +08:00
In main.js:
```javascript
import Vue from 'vue'
import ElementUI from 'element-ui'
import 'element-ui/lib/theme-chalk/index.css'
import App from './App.vue'
Vue.use(ElementUI)
new Vue({
el: '#app',
render: h => h(App)
})
```
El código anterior importa Element completamente. Nótese que el archivo CSS necesita ser incluido por separado.
2017-11-06 19:22:02 +08:00
#### En demanda
2017-11-06 19:22:02 +08:00
2017-12-03 18:03:06 +08:00
Con la ayuda de [babel-plugin-component](https://github.com/QingWei-Li/babel-plugin-component), podemos importar los componentes que necesitamos, haciendo nuestro proyecto más pequeño que de la otra manera.
2017-11-06 19:22:02 +08:00
2017-12-03 18:03:06 +08:00
Primero, instale babel-plugin-component:
2017-11-06 19:22:02 +08:00
```bash
npm install babel-plugin-component -D
```
2017-12-03 18:03:06 +08:00
Luego edite .babelrc:
2017-11-06 19:22:02 +08:00
```json
{
"presets": [
["es2015", { "modules": false }]
],
"plugins": [["component", {
2017-11-06 19:22:02 +08:00
"libraryName": "element-ui",
"styleLibraryName": "theme-chalk"
}
]]
2017-11-06 19:22:02 +08:00
}
```
2017-12-03 18:03:06 +08:00
Luego, si necesita Button y Select, edite main.js:
2017-11-06 19:22:02 +08:00
```javascript
import Vue from 'vue'
import { Button, Select } from 'element-ui'
import App from './App.vue'
Vue.component(Button.name, Button)
Vue.component(Select.name, Select)
/* or
* Vue.use(Button)
* Vue.use(Select)
*/
new Vue({
el: '#app',
render: h => h(App)
})
```
Ejemplo completo (Referencia completa de componentes [components.json](https://github.com/ElemeFE/element/blob/master/components.json))
2017-11-06 19:22:02 +08:00
```javascript
import Vue from 'vue'
import {
Pagination,
Dialog,
Autocomplete,
Dropdown,
DropdownMenu,
DropdownItem,
Menu,
Submenu,
MenuItem,
MenuItemGroup,
Input,
InputNumber,
Radio,
RadioGroup,
RadioButton,
Checkbox,
CheckboxButton,
CheckboxGroup,
Switch,
Select,
Option,
OptionGroup,
Button,
ButtonGroup,
Table,
TableColumn,
DatePicker,
TimeSelect,
TimePicker,
Popover,
Tooltip,
Breadcrumb,
BreadcrumbItem,
Form,
FormItem,
Tabs,
TabPane,
Tag,
Tree,
Alert,
Slider,
Icon,
Row,
Col,
Upload,
Progress,
Badge,
Card,
Rate,
Steps,
Step,
Carousel,
CarouselItem,
Collapse,
CollapseItem,
Cascader,
ColorPicker,
Transfer,
Container,
Header,
Aside,
Main,
Footer,
Loading,
MessageBox,
Message,
Notification
} from 'element-ui'
Vue.use(Pagination)
Vue.use(Dialog)
Vue.use(Autocomplete)
Vue.use(Dropdown)
Vue.use(DropdownMenu)
Vue.use(DropdownItem)
Vue.use(Menu)
Vue.use(Submenu)
Vue.use(MenuItem)
Vue.use(MenuItemGroup)
Vue.use(Input)
Vue.use(InputNumber)
Vue.use(Radio)
Vue.use(RadioGroup)
Vue.use(RadioButton)
Vue.use(Checkbox)
Vue.use(CheckboxGroup)
Vue.use(Switch)
Vue.use(Select)
Vue.use(Option)
Vue.use(OptionGroup)
Vue.use(Button)
Vue.use(ButtonGroup)
Vue.use(Table)
Vue.use(TableColumn)
Vue.use(DatePicker)
Vue.use(TimeSelect)
Vue.use(TimePicker)
Vue.use(Popover)
Vue.use(Tooltip)
Vue.use(Breadcrumb)
Vue.use(BreadcrumbItem)
Vue.use(Form)
Vue.use(FormItem)
Vue.use(Tabs)
Vue.use(TabPane)
Vue.use(Tag)
Vue.use(Tree)
Vue.use(Alert)
Vue.use(Slider)
Vue.use(Icon)
Vue.use(Row)
Vue.use(Col)
Vue.use(Upload)
Vue.use(Progress)
Vue.use(Badge)
Vue.use(Card)
Vue.use(Rate)
Vue.use(Steps)
Vue.use(Step)
Vue.use(Carousel)
Vue.use(CarouselItem)
Vue.use(Collapse)
Vue.use(CollapseItem)
Vue.use(Cascader)
Vue.use(ColorPicker)
Vue.use(Container)
Vue.use(Header)
Vue.use(Aside)
Vue.use(Main)
Vue.use(Footer)
Vue.use(Loading.directive)
Vue.prototype.$loading = Loading.service
Vue.prototype.$msgbox = MessageBox
Vue.prototype.$alert = MessageBox.alert
Vue.prototype.$confirm = MessageBox.confirm
Vue.prototype.$prompt = MessageBox.prompt
Vue.prototype.$notify = Notification
Vue.prototype.$message = Message
```
### Configuración global
2017-12-03 18:03:06 +08:00
Cuando importa Element, puede definir un objeto global de configuración. Por ahora este elemento solo contiene una propiedad: `size`, que define el tamaño por defecto de todos los componentes:
2017-11-06 19:22:02 +08:00
Importando Element completamente
2017-11-06 19:22:02 +08:00
```JS
import Vue from 'vue'
import Element from 'element-ui'
Vue.use(Element, { size: 'small' })
```
Importando Element parcialmente
2017-11-06 19:22:02 +08:00
```JS
import Vue from 'vue'
import { Button } from 'element-ui'
Vue.prototype.$ELEMENT = { size: 'small' }
Vue.use(Button)
```
2017-12-03 18:03:06 +08:00
Con la anterior configuración, el tamaño por defecto de todos los componentes que tienen el atributo `size` será `small`.
2017-11-06 19:22:02 +08:00
2017-12-03 18:03:06 +08:00
### Empiece ya!
Ahora ha incorporado Vue y Element a su proyecto y es el momento para comenzar a programar. Inicie el modo de desarrollo:
2017-11-06 19:22:02 +08:00
```bash
npm run dev
```
Build:
```bash
npm run build
```
Por favor, refiérase a la documentación de cada componente para aprender cómo usarlos.