summaryrefslogtreecommitdiff
path: root/design/widgets/combobox.tex
blob: feef168d70926738d6cd692360dab3d990acb22e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
% -*- coding: utf-8 -*-
\subsubsection{\texttt{combobox} elementet}
\label{combobox}
En combobox gruppe bruges til at vælge et element ud af en gruppe.\\
En combobox har flg. attributter:
\begin{itemize}
\item \textit{value} - Inidikerer hvilket element i gruppen som skal være
  valgt initielt. Hvis udeladt eller ikke-matchende vil comboboxen være tom,
  hvilket vil svare til at et regulært udtryk på et tekstfelt ikke er
  opfyldt.
\item \textit{type} - Denne attribut bruges til at styre comboboxens
  funktionalitet. Feltet kan have følgende værdier:
  \begin{description}
  \item[select] Får comboboxen til at opføre sig som en single select
                liste. Altså en list hvor præcis et element skal
                vælges, og man ikke selv kan skrive.
  \item[edit] Får comboboxen til at opføre sig som en single select
              liste, men hvor brugeren kan skrive fritekst i feltet,
              og derved vælge værdier som ikke allerede er på listen.
  \item[search] Får comboboxsen til at opføre sig som hvis den havde
                typen \texttt{select}, bortset fra at brugeren nu kan
                skrive i feltet, hvorved en søgning i listen
                foretages, og det bedst matchene resultat vælges.
  \end{description}
  Hvis \texttt{type} feltet er undladt, laves comboboxen med
  typen \texttt{select}.
\end{itemize}
Comboboxen indeholder \texttt{item} tags som beskriver hvilke valgmuligheder
den givne gruppe har.\\
Et combobox item har flg. attributter:
\begin{itemize}
\item \textit{caption} - Den tekst som skal vises for denne valgmulighed. Hvis
  udeladt vises den uden tekst.
\item \textit{value} - Den værdi som valgmuligheden har og som sendes som værdi
  af gruppen hvis den er valgt ved commit.
\end{itemize}
Ved commit returneres comboboxens navn med det valgte items value.

\begin{lstlisting}[title={Et eksempel på et combobox tag med item tags indeni.}]
<combobox name="foobar" value="option1" layout="vbox">
  <item caption="Option 1" value="option1"/>
  <item caption="Option 2" value="option2"/>
  <item caption="Option 3" value="option3"/>
</combobox>
\end{lstlisting}