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

  <info>
    <credit type="author">
      <name>Allan Day</name>
      <email>aday@gnome.org</email>
    </credit>
    <credit>
      <name>Calum Benson</name>
    </credit>
    <credit>
      <name>Adam Elman</name>
    </credit>
    <credit>
      <name>Seth Nickell</name>
    </credit>
    <credit>
      <name>Colin Robertson</name>
    </credit>

    <link type="guide" xref="ui-elements"/>
    <uix:thumb mime="image/svg" src="figures/ui-elements/text-fields.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>Campos de texto</title>

<p>Un campo de entrada de texto es un elemento de la interfaz para introducir o editar texto. Es un elemento básico con varios usos, incluyendo la entrada de una búsqueda, configuración y preferencias, o la configuración de una cuenta. Un campo de texto se puede rellenar previamente con texto y puede incluir botones o iconos adicionales.</p>

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

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

<list>
<item><p>Asigne un tamaño a los campos de texto acorde al tamaño del contenido que habitualmente contendrán. Esto da una pista visual de la cantidad de entrada esperada y evita desbordamientos.</p></item>
<item><p>En un <link xref="dialogs#instant-and-explicit-apply">diálogo de aplicación instantánea</link>, valide el contenido del campo de entrada cuando pierda el foco o se cierre la ventana, no después de cada pulsación de tecla. La excepción es si el campo solo acepta un número fijo de caracteres, como un código de color hexadecimal: valide y aplique el cambio tan pronto como se haya introducido ese número de caracteres.</p></item>
<item><p>Si implementa un campo de entrada que sólo acepta unos determinados caracteres, tales como dígitos, reproduzca el pitido de advertencia del sistema cuando el usuario intente introducir un carácter no válido.</p></item>
<item><p>Normalmente, al pulsar <key>Tab</key> en un campo de entrada de una sola línea se debería mover el foco al siguiente control, y el un campo de entrada de varias líneas debe insertar un carácter tabulador. Pulsar <keyseq><key>Ctrl</key><key>Tab</key></keyseq> un campo de entrada de varias líneas debe mover el foco al siguiente control.</p></item>
<item><p>Si necesita proporcionar un atajo del teclado que inserte un tabulador en un campo de entrada de una sola línea, use <keyseq><key>Ctrl</key><key>Tab</key></keyseq>. Sin embargo, es poco probable que encuentre muchas situaciones como esta.</p></item>
</list>

</section>

<section id="embedding-info-and-controls">
<title>Empotrar información y controles</title>

<p>Se puede insertar una amplia variedad de información o controles en un campo de entrada de texto.</p>

<p>Los iconos o los botones de iconos se pueden colocar dentro de un campo de texto para proporcionar información sobre el estado o controles adicionales.</p>

<list>
<item><p>Se puede usar un icono al principio de la entrada para indicar su propósito, eliminando así la necesidad de etiquetar la entrada. Los campos de búsqueda son un ejemplo clásico de esto, donde se coloca un icono de búsqueda en la parte izquierda del campo de entrada.</p></item>
<item><p>Si el texto que introducir es sensible a mayúsculas y minúsculas, se debe mostrar un icono de advertencia dentro del campo de texto si las mayúsculas están activadas. Normalmente esto se muestra en la parte derecha de la entrada.</p></item>
<item><p>Si es habitual que se limpie el campo de texto, se puede poner un botón dentro del campo, en la parte derecha.</p></item>
<item><p>Si coloca un icono en un campo de entrada de texto (ya sea como un indicador o un botón), use su variante simbólico del tema de iconos simbólicos de GNOME.</p></item>
</list>

<p>Cuando un usuario quiera apoyarse en información adicional para usar un campo de entrada de texto, este puede estar rellenado previamente con un texto de sugerencia. Como cualquier decisión para desplegar información adicional, esto deberá hacerse solo cuando sea necesario.</p>

</section>

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

<list>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkEntry.html">GtkEntry</link></p></item>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkSearchEntry.html">GtkSearchEntry</link></p></item>
</list>

</section>
</page>
