design/widgets/metawidget.tex


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

% -*- coding: utf-8 -*-
\subsubsection{\texttt{metawidget} elementet}
En metawidget er en widget som fungerer som container for andre
widgets.\\
En metawidget sammensætter værdierne fra de indre widgets igennem en
formatstreng, og producerer på den måde et fælles output.\\
De indre widgets kommer ikke til at indgå som en del af den ydre
makros værdi liste, og deres værdier bliver således aldrig lagret
direkte på serveren.\\
En metawidget kan ikke sætte sin værdi i de indre widgets (grundet
måden hvorpå disse oprindeligt er indsamlet), så en sat værdi i en
meta widget vil blot blive ignoreret.\\
En metawidget har flg. attributter:
\begin{itemize}
\item \textit{name} - Navnet på meta widgeten.
\item \textit{layout} - ``hbox'' eller ``vbox'', specificerer hvordan
  de indre widgets skal lægges ud.
\item \textit{format} - Formatstreng som beskriver hvordan værdierne
  i de indre widgets skal sammensættes Se dokumentation for
  formatstrengens format i kapitel \ref{format}.
\end{itemize}

\begin{lstlisting}[title={Et eksempel på en metawidget.}]
<metawidget name="cave_metawidget" layout="vbox"
            format="Prep: ${prep}, Reak: ${reak}.">
  <textedit name="prep"/>
  <textedit name="reak"/>
</metawidget>
\end{lstlisting}