summaryrefslogtreecommitdiff
path: root/design/widgets/listbox.tex
diff options
context:
space:
mode:
Diffstat (limited to 'design/widgets/listbox.tex')
-rw-r--r--design/widgets/listbox.tex25
1 files changed, 25 insertions, 0 deletions
diff --git a/design/widgets/listbox.tex b/design/widgets/listbox.tex
new file mode 100644
index 0000000..3689ee9
--- /dev/null
+++ b/design/widgets/listbox.tex
@@ -0,0 +1,25 @@
+\subsubsection{\texttt{listbox} elementet}
+En listbox bruges til at vælge præcis et element ud af en gruppe via en liste.\\
+En listbox har flg. attributter:
+\begin{itemize}
+\item \textit{value} - Indikerer hvilket element på listen som skal være
+ valgt initielt. Hvis udeladt eller ikke-matchende vil ingenting være valgt,
+ hvilket vil svare til at et regulært udtryk på et tekstfelt ikke er
+ opfyldt.
+\end{itemize}
+Listboxen indeholder \texttt{item} tags som beskriver hvilke linier der skal
+være i listen.\\
+Et listbox 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. Skal udelades hvis type er sat.
+\item \textit{type} - Et typefelt, som beskriver hvordan dette item skal vise.
+ Kan have værdierne ``separator'', hvilket indikerer at elementet skal vises
+ som en horisontal streg der ikke kan vælges, eller ``header'' som indikerer at
+ elementet skal vises som en overskrift der ikke kan vælges. Når typen er sat
+ til ``header'' benyttes \textit{caption} attributen som den tekst der skal
+ vises i overskriften.
+\end{itemize}
+Ved commit returneres listboxens navn med det valgte items value.