<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:uix="http://projectmallard.org/experimental/ui/" type="topic" id="popovers" lang="es">

  <info>
    <credit type="author">
      <name>Allan Day</name>
      <email>aday@gnome.org</email>
    </credit>

    <link type="guide" xref="ui-elements"/>
    <uix:thumb mime="image/svg" src="figures/ui-elements/popover.svg"/>

    <license xmlns="http://projectmallard.org/1.0/" href="http://creativecommons.org/licenses/by-sa/4.0/">

  <p>This work is licensed under a
  <link href="http://creativecommons.org/licenses/by-sa/4.0/">Creative
  Commons Attribution-Share Alike 4.0 International License</link>.</p>

</license>
  <credit type="translator copyright"><name>Daniel Mustieles</name><email>daniel.mustieles@gmail.com</email><years>2011 - 2021</years></credit><credit type="translator copyright"><name>Alex Puchades</name><email>alex94puchades@gmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>Nicolás Satragno</name><email>nsatragno@gnome.org</email><years>2013</years></credit><credit type="translator copyright"><name>Benjamín Valero Espinosa</name><email>benjavalero@gmail.com</email><years>2011</years></credit><credit type="translator copyright"><name>Jorge González</name><email>jorgegonz@svn.gnome.org</email><years>2009</years></credit><credit type="translator copyright"><name>Rosa Elena Pérez</name><email>rozydicemiau@gmail.com</email><years>2014</years></credit><credit type="translator copyright"><name>Oscar Rafael Arachi</name><email>arachi910@gmail.com</email><years>2014 - 2015</years></credit><credit type="translator copyright"><name>Miguel Ajuech</name><email>miguel.ann.28@gmail.com</email><years>2014</years></credit><credit type="translator copyright"><name>Adrián Pérez Domínguez</name><email>adrian@aztli.org</email><years>2015</years></credit><credit type="translator copyright"><name>Celina Osorio Ochoa</name><email>chelinoska@gmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>Dario Amigon Espinoza</name><email>daramigon@gmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>Yenisei Ramírez Pérez</name><email>yeniseirape@gmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>José Roberto Ramíres Mendoza</name><email>aczella@gmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>Bernardo Sánchez Romero</name><email>b.sanchez.rom@gmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>Emmanuel Márquez Juárez</name><email>resident3333@gmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>David Romero Serrano</name><email>lemi136@hotmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>Omar Garcia Guzman</name><email>garciag.omar91@gmail.com</email><years>2015</years></credit><credit type="translator copyright"><name>Edilberto Huerta Niño</name><email>edilberto.huerta0290@gmail.com</email><years>2015</years></credit></info>

<title>Ventanas emergentes</title>

<p>Una ventana emergente es un contenedor transitorio que aparece sobre la ventana padre en respuesta a una acción del usuario. Las ventanas emergentes pueden contener diversos elementos de la IU, incluyendo botones, listas o menús. A menudo se usan como parte de botones de menú o menús contextuales.</p>

<media type="image" mime="image/svg" src="figures/ui-elements/popover.svg"/>

<section id="when-to-use">
<title>Cuándo usarlas</title>

<p>Las ventanas emergentes se pueden usar para mostrar controles adicionales que no siempre el usuario necesita. Pueden permitir al usuario realizar acciones o pueden contener configuración y preferencias. Son un elemento de la interfaz muy flexible que permite crear soluciones de diseños creativos.</p>

<p>Una ventana emergente siempre debe ser relativa a un elemento específico de la interfaz que actúa como origen de la ventana. Normalmente, esto es un botón o un elemento de contenido. Cuando se muestran por una pulsación en un botón, la ventana emergente se puede usar como una versión más flexible de un menú de botón, permitiendo acceder a grupos de controles cuando se necesita. Un ejemplo de esto sería:</p>

<list>
<item><p>Mostrar una pequeña caja de herramientas con controles de formato de texto.</p></item>
<item><p>Una interfaz de búsqueda, con una caja de búsqueda y espacio para la lista de resultados.</p></item>
<item><p>Una colección de controles de vista, como ampliación, lista/rejilla y ordenación de contenido.</p></item>
</list>

<p>Como mecanismo para mostrar controles o información, las ventanas emergentes</p>

</section>

<section id="popover-content">
<title>Contenido de la ventana emergente</title>

<list>
<item><p>Una ventana emergente es un contenedor genérico que puede incluir diferentes controles, tales como botones, deslizadores, listas, interruptores y campos de texto. Sin embargo, procure no mezclar muchos tipos de controles diferentes, e intente agrupar los del mismo tipo.</p></item>
<item><p>Las ventanas emergentes pueden actuar como un contenedor para un menú, o par aun menú junto con un pequeño número de controles adicionales.</p></item>
<item><p>Si el propósito de los controles de la ventana emergente es ambiguo, se puede poner un encabezado en la ventana emergente.</p></item>
<item><p>Normalmente, los botones <gui>Cerrar</gui> o <gui>Hecho</gui> no son obligatorios en una ventana emergente.</p></item>
</list>

</section>


<section id="general-guidelines">
<title>Guías Generales</title>

<p>Las ventanas emergentes siempre deben tener un tamaño pequeño (como regla general, no deben cubrir más de la tercera parte de la ventana padre) y ser poco complejas. Siempre deben aparece como subordinadas a su ventana padre.</p>
<p>Una ventana emergente sólo debe aparecer como respuesta a una acción del usuario, y nunca deben aparecer por sorpresa o de manera inesperada.</p>

</section>


<section id="api-reference">
<title>Referencia de la API</title>

<list>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkPopover.html">GtkPopover</link></p></item>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkPopoverMenu.html">GtkPopoverMenu</link></p></item>
</list>
</section>

</page>
