Allan Day
aday@gnome.org
Calum Benson
Adam Elman
Seth Nickell
Colin Robertson
Anders Jonsson
anders.jonsson@norsjovallen.se 2015, 2018
Sebastian Rasmussen
sebras@gmail.com 2017, 2018

# Textfält

Ett textinmatningsfält är ett gränssnittselement för att mata in eller redigera text. Det är ett grundläggande element med ett flertal användningsområden, inklusive sökinmatning, inställningar eller kontokonfigurering och inställning. Ett textinmatningsfält kan förifyllas med text och kan inkludera ytterligare knappar eller ikoner.

# Allmänna riktlinjer

Ställ in storleken på textfält efter den troliga storleken på innehållet de kommer att ha. Detta ger en användbar visuell antydan till hur mycket inmatning som förväntas och förhindrar överspill.

I en ”tillämpas omedelbart”-dialog, validera innehållet i inmatningsfältet när det tappar fokus eller när fönstret stängs, inte efter varje tangentnedslag. Undantag: om fältet endast accepterar ett begränsat antal tecken, så som hexadecimala färgkoder, validera och tillämpa ändringen så snart det antalet tecken har matats in.

Om du implementerar ett inmatningsfält som endast accepterar vissa tecken, så som siffror, spela upp systemets varningspip när användaren försöker att mata in ett ogiltigt tecken.

Normalt när användaren trycker Tabb i ett enradsinmatningsfält bör fokus flyttas till nästa komponent och i ett flerradsinmatningsfält bör det infoga ett tabbtecken. Att trycka på Ctrl Tabb i ett flerradsinmatningsfält bör flytta fokus till nästa komponent.

Om du behöver tillhandahålla en tangentbordsgenväg som infogar ett tabbtecken i ett enradsinmatningsfält, använd Ctrl Tabb. Det är dock osannolikt att du kommer att hitta många situationer där detta är användbart.

# Bädda in information och komponenter

En mängd av ytterligare information eller komponenter kan infogas i ett textinmatningsfält.

Ikoner eller ikonknappar kan placeras i ett textfält för att tillhandahålla statusinformation eller ytterligare komponenter.

En ikon i början av inmatningsfältet kan användas för att indikera dess syfte — vilket då ersätter behovet av att ha en etikett på inmatningsfältet. Inmatningsfält för sökning är det klassiska exemplet på detta, där en sökikon placeras till vänster i inmatningsfältet.

Om texten som ska matas in är skiftlägeskänslig kan en varningsikon visas inuti textfältet om caps lock är på. Detta visas vanligen på den högra sidan om inmatningsfältet.

Om det är vanligt att textfältet rensas så kan en ikonknapp för rensning placeras i fältet, på höger sida.

Om du placerar en ikon i ett textinmatningsfält (antingen som en indikator eller en knapp), använd dess symboliska variant från GNOME:s symboliska ikontema.

Då en användare skulle ha nytta av ytterligare information för att använda ett textinmatningsfält så kan det förifyllas med en hjälptext. Som med varje beslut om att visa ytterligare information så bör detta endast göras då det är nödvändigt.

# API-referens

GtkEntry

GtkSearchEntry