element

10 KiB

Raw Blame History

Diálogo

Informar usuarios cuando preserva el estado de página corriente.

Basic usage

Diálogo que se surge una caja de diálogo,y es bastante personalizable.

:::demo Establece el atributo con un Boolean, y Diálogo muestra cuando es true.El Diálogo tiene dos partes:body y footer, y el último exige un slotllamado footer.El atributo opcional title (vacío por defecto) es para definir un título.Finalmente,este ejemplo demostra cómo before-close es usado.

<el-button type="text" @click="dialogVisible = true">click to open the Dialog</el-button>

<el-dialog
  title="Tips"
  :visible.sync="dialogVisible"
  width="30%"
  :before-close="handleClose">
  <span>This is a message</span>
  <span slot="footer" class="dialog-footer">
    <el-button @click="dialogVisible = false">Cancel</el-button>
    <el-button type="primary" @click="dialogVisible = false">Confirm</el-button>
  </span>
</el-dialog>

<script>
  export default {
    data() {
      return {
        dialogVisible: false
      };
    },
    methods: {
      handleClose(done) {
        this.$confirm('Are you sure to close this dialog?')
          .then(_ => {
            done();
          })
          .catch(_ => {});
      }
    }
  };
</script>

:::

:::tip

before-close solamente funciona cuando usuarios se hacen clic el icono de cerrar o el fondo.Si tienes botones que cercan el Diálogo en el footer que se llamado slot,puedes añadir que harías con before-close en controlador del evento click de los botones. :::

Personalizaciones

El contenido de Diálogo puede ser cualquier cosa,hasta una mesa o un formulario.Este ejemplo muestra cómo utilizar Mesa y Formulario de Element con Diálogo.

:::demo

<!-- Table -->
<el-button type="text" @click="dialogTableVisible = true">open a Table nested Dialog</el-button>

<el-dialog title="Shipping address" :visible.sync="dialogTableVisible">
  <el-table :data="gridData">
    <el-table-column property="date" label="Date" width="150"></el-table-column>
    <el-table-column property="name" label="Name" width="200"></el-table-column>
    <el-table-column property="address" label="Address"></el-table-column>
  </el-table>
</el-dialog>

<!-- Form -->
<el-button type="text" @click="dialogFormVisible = true">open a Form nested Dialog</el-button>

<el-dialog title="Shipping address" :visible.sync="dialogFormVisible">
  <el-form :model="form">
    <el-form-item label="Promotion name" :label-width="formLabelWidth">
      <el-input v-model="form.name" auto-complete="off"></el-input>
    </el-form-item>
    <el-form-item label="Zones" :label-width="formLabelWidth">
      <el-select v-model="form.region" placeholder="Please select a zone">
        <el-option label="Zone No.1" value="shanghai"></el-option>
        <el-option label="Zone No.2" value="beijing"></el-option>
      </el-select>
    </el-form-item>
  </el-form>
  <span slot="footer" class="dialog-footer">
    <el-button @click="dialogFormVisible = false">Cancel</el-button>
    <el-button type="primary" @click="dialogFormVisible = false">Confirm</el-button>
  </span>
</el-dialog>

<script>
  export default {
    data() {
      return {
        gridData: [{
          date: '2016-05-02',
          name: 'John Smith',
          address: 'No.1518,  Jinshajiang Road, Putuo District'
        }, {
          date: '2016-05-04',
          name: 'John Smith',
          address: 'No.1518,  Jinshajiang Road, Putuo District'
        }, {
          date: '2016-05-01',
          name: 'John Smith',
          address: 'No.1518,  Jinshajiang Road, Putuo District'
        }, {
          date: '2016-05-03',
          name: 'John Smith',
          address: 'No.1518,  Jinshajiang Road, Putuo District'
        }],
        dialogTableVisible: false,
        dialogFormVisible: false,
        form: {
          name: '',
          region: '',
          date1: '',
          date2: '',
          delivery: false,
          type: [],
          resource: '',
          desc: ''
        },
        formLabelWidth: '120px'
      };
    }
  };
</script>

:::

Diálogo anidado

Si un cuadro de diálogo está anidado en otro cuadro de diálogo,append-to-body es requerido. :::demo Normalmente no recomendamos el uso de Diálogo anidado.Si necesitas varios cuadros de diálogo representados en la página,puedes aplastarlos simplemente así que serían hermanos el uno al otro.Si tienes que anidar un cuadro de diálogo dentro de otro cuadro de diálogo,establece append-to-body del diálogo anidado a verdadero,y se agregará al cuerpo en combio de su nodo padre,asi que ambos diálogos pueden ser renderizados correctamente.

<template>
  <el-button type="text" @click="outerVisible = true">open the outer Dialog</el-button>
  
  <el-dialog title="Outter Dialog" :visible.sync="outerVisible">
    <el-dialog
        width="30%"
        title="Inner Dialog"
        :visible.sync="innerVisible"
        append-to-body>
    </el-dialog>
    <div slot="footer" class="dialog-footer">
      <el-button @click="outerVisible = false">Cancel</el-button>
      <el-button type="primary" @click="innerVisible = true">open the inner Dialog</el-button>
    </div>
  </el-dialog>
</template>

<script>
  export default {
    data() {
      return {
        outerVisible: false,
        innerVisible: false
      };
    }
  }
</script>

:::

Contenido centrado

el contenido de Diálogo se puede centrar.

:::demo establecer center en true se centrará el encabezado y el pie de página del cuadro de diálogo horizontalmente.

<el-button type="text" @click="centerDialogVisible = true">Click to open the Dialog</el-button>

<el-dialog
  title="Warning"
  :visible.sync="centerDialogVisible"
  width="30%"
  center>
  <span>It should be noted that the content will not be aligned in center by default</span>
  <span slot="footer" class="dialog-footer">
    <el-button @click="centerDialogVisible = false">Cancel</el-button>
    <el-button type="primary" @click="centerDialogVisible = false">Confirm</el-button>
  </span>
</el-dialog>

<script>
  export default {
    data() {
      return {
        centerDialogVisible: false
      };
    }
  };
</script>

:::

:::tip center afecta a cabezazos y pies de Diálogo.El cuerpo de Diálogo puede ser cualquier cosa,asi que a veces no puede verse bien cuando está centrado.Necesitas escribir algunos CSS si quieres centrar el cuerpo también. :::

:::tip Si el variable obligado a visible es manejado en el almacén Vuex,el .sync no puede funcionar correctamente.En este caso,quita el modificador .sync por favor,escucha a eventos open y close de Diálogo,y comete Vuex mutaciones para actualizar el valor de la variable en los controladores de eventos.

:::

Atributo

Atributo	Descripción	Tipo	Valores aceptados	Defecto
visible	visibilidad del Diálogo, apoya el modificador .sync	boolean	—	false
title	título de Diálogo. También se puede pasar con una ranura nombrada (ver la tabla siguiente)	string	—	—
width	anchura de Diálogo	string	—	50%
fullscreen	si el diálogo ocupa pantalla completa	boolean	—	false
top	valor de `margin-top` del Diálogo CSS	string	—	15vh
modal	si se muestra una máscara	boolean	—	true
modal-append-to-body	si adjuntar modal al elemento de cuerpo. Si es falso,el modal se agregará al elemento principal de Diálogo	boolean	—	true
append-to-body	Si adjuntar el cuadro de diálogo al cuerpo	boolean	—	false
lock-scroll	Si voluta de cuerpo está desactivado mientras se muestra el cuadro de diálogo	boolean	—	true
custom-class	nombres de clase personalizada para el Diálogo	string	—	—
close-on-click-modal	si el Diálogo puede ser cerrado por haciendo clic en la máscara	boolean	—	true
close-on-press-escape	si el Diálogo puede ser cerrado por presionando ESC	boolean	—	true
show-close	si mostrar un botón de cerrar	boolean	—	true
before-close	una devolución de llamada antes de que se cierre el cuadro de diálogo, y evitará el cuadro de diálogo de cerrar	función(done) `done`se usa para cerrar el diálog	—	—
center	si alinear el encabezado y el pie de página en el centro	boolean	—	false

Ranura

Nombre	Descripcíon
—	contenido de Diálogo
title	contenido del título de Diálogo
footer	contenido del pie de página de Diálogo

Eventos

Nombre de Eventos	Descripcíon	Parámetros
open	se activa cuando se abre el cuadro de Diálogo	—
close	se dispara cuando el Diálogo se cierra	—

10 KiB Raw Blame History