org.opensingular.lib.wicket.util.bootstrap.layout

Class BSFormHorizontal

java.lang.Object

org.apache.wicket.Component

org.apache.wicket.MarkupContainer

org.apache.wicket.markup.html.WebMarkupContainer

org.apache.wicket.markup.html.panel.Panel

org.opensingular.lib.wicket.util.bootstrap.layout.BSContainer<BSFormHorizontal>

org.opensingular.lib.wicket.util.bootstrap.layout.BSFormHorizontal

All Implemented Interfaces:

Serializable, Iterable<org.apache.wicket.Component>, org.apache.wicket.event.IEventSink, org.apache.wicket.event.IEventSource, org.apache.wicket.IConverterLocator, org.apache.wicket.IQueueRegion, org.apache.wicket.markup.html.IHeaderContributor, org.apache.wicket.request.component.IRequestableComponent, org.apache.wicket.util.IHierarchical<org.apache.wicket.Component>, org.apache.wicket.util.io.IClusterable

public class BSFormHorizontal
extends BSContainer<BSFormHorizontal>

Componente para gerar formularios horizontais do bootstrap de forma programática (sem ter que escrever HTML). Este componente possui facilidades para a criação de componentes, com métodos para a criação de inputs, selects, textareas, etc., com suporte para feedback de erro abaixo do campo, labels nos componentes e marcador de obrigatoriedade.

Ele utiliza uma grid unificada de 12 colunas, ao invés de grid dentro de grid. Isto evita o cálculo de divisores comuns para alinhar as labels, porém restringe o layout a 12 colunas. Se necessário, é possível adicionar um BSFormHorizontal dentro de um BSGrid, para criar um layout grid dentro de grid.

Os métodos desta API que geram containers (groups, labels, controls) podem ser utilizados de duas formas:

• os métodos prefixados com new- (newGroup(), newLabel(), newControls()) retornam a instância do container criado, permitindo um uso mais 'procedural' da API.
• os métodos prefixados com append- (appendGroup(), appendLabel(), appendControls()) recebem callbacks que consomem o container criado (ou um componente pré-inicializado), mas retornam 'this' (o container no qual o método foi chamado), para encadeamento, permitindo um uso mais 'declarativo' da API.

A forma procedural resulta em um código mais natural se você precisa guardar referências para os containers, por exemplo, para ter controle fino da renderização de respostas Ajax.

    // TODO

A forma declarativa resulta em um código hierarquizado, semelhante à estrutura do HTML que será gerada:

    // TODO

Ambos os códigos acima geram algo do tipo:

    // TODO

Ambos os estilos são válidos, e podem ser misturados de acordo com a necessidade.

See Also:

Serialized Form

Field Summary

Fields inherited from class org.opensingular.lib.wicket.util.bootstrap.layout.BSContainer

items

Fields inherited from class org.apache.wicket.markup.html.panel.Panel

PANEL

Fields inherited from class org.apache.wicket.Component

ENABLE, FLAG_AFTER_RENDERING, FLAG_INITIALIZED, FLAG_PREPARED_FOR_RENDER, FLAG_REMOVING_FROM_HIERARCHY, FLAG_RENDERING, FLAG_RESERVED1, FLAG_RESERVED2, FLAG_RESERVED3, FLAG_RESERVED4, FLAG_RESERVED5, FLAG_RESERVED8, PARENT_PATH, PATH_SEPARATOR, RENDER, RFLAG_CONTAINER_DEQUEING

Constructor Summary

Constructors

Constructor and Description
BSFormHorizontal(String id)
BSFormHorizontal(String id, org.apache.wicket.model.IModel<?> model)

Method Summary

Modifier and Type	Method and Description
BSFormHorizontal	add(org.apache.wicket.behavior.Behavior... behaviors)
BSFormHorizontal	appendGroup(IBSComponentFactory<BSFormGroup> factory)
BSFormHorizontal	appendGroupLabelControls(int labelColspan, Serializable labelValueOrModel, int controlsColspan, IBSComponentFactory<BSControls> factory)
BSFormHorizontal	appendGroupLabelControlsFeedback(int labelColspan, org.apache.wicket.Component labelFor, Serializable labelValueOrModel, int controlsColspan, org.apache.wicket.Component feedback, IBSComponentFactory<BSControls> factory)
BSFormHorizontal	appendGroupLabelControlsFeedback(int labelColspan, Serializable labelValueOrModel, int controlsColspan, org.apache.wicket.Component feedback, IBSComponentFactory<BSControls> factory)
BSFormHorizontal	appendGroupOffsetControls(int mdOffset, int controlsColspan, IBSComponentFactory<BSControls> factory)
IBSGridCol.BSGridSize	getDefaultGridSize()
BSControls	newControlsInGroup(int mdOffset, int controlsColspan)
BSControls	newControlsInGroup(int labelColspan, Serializable labelValueOrModel, int controlsColspan)
BSFormGroup	newGroup()
BSFormHorizontal	setDefaultGridSize(IBSGridCol.BSGridSize defaultGridSize)

Methods inherited from class org.opensingular.lib.wicket.util.bootstrap.layout.BSContainer

addInfoMessage, appendComponent, appendGrid, appendTag, appendTag, appendTag, getCssClass, getInnerStyle, getItems, getTagName, newChildId, newComponent, newFormGroup, newFormGroup, newGrid, newTag, newTag, newTagWithFactory, newTemplateTag, onComponentTag, onInitialize, removeItem, setCssClass, setInnerStyle, setTagName

Methods inherited from class org.apache.wicket.markup.html.panel.Panel

getRegionMarkup, newMarkupSourcingStrategy

Methods inherited from class org.apache.wicket.markup.html.WebMarkupContainer

getWebApplication, getWebPage, getWebRequest, getWebResponse, getWebSession

Methods inherited from class org.apache.wicket.MarkupContainer

add, addDequeuedComponent, addOrReplace, autoAdd, canDequeueTag, contains, dequeue, dequeue, dequeuePreamble, findComponentToDequeue, get, get, getAssociatedMarkup, getAssociatedMarkupStream, getMarkup, getMarkupType, internalAdd, internalInitialize, iterator, iterator, newDequeueContext, onAfterRenderChildren, onComponentTagBody, onDetach, onRender, queue, remove, remove, removeAll, renderAll, renderAssociatedMarkup, renderNext, replace, setDefaultModel, size, swap, toString, toString, visitChildren, visitChildren, visitChildren, visitChildren

Methods inherited from class org.apache.wicket.Component

addStateChange, afterRender, beforeRender, canCallListenerInterface, canCallListenerInterfaceAfterExpiry, checkComponentTag, checkComponentTagAttribute, checkHierarchyChange, clearOriginalDestination, configure, continueToOriginalDestination, debug, detach, detachModel, detachModels, determineVisibility, error, exceptionMessage, fatal, findMarkupStream, findPage, findParent, findParentWithAssociatedMarkup, getAjaxRegionMarkupId, getApplication, getBehaviorById, getBehaviorId, getBehaviors, getBehaviors, getClassRelativePath, getConverter, getDefaultModel, getDefaultModelObject, getDefaultModelObjectAsString, getDefaultModelObjectAsString, getEscapeModelStrings, getFeedbackMessages, getFlag, getId, getInnermostModel, getInnermostModel, getLocale, getLocalizer, getMarkup, getMarkupAttributes, getMarkupId, getMarkupId, getMarkupIdFromMarkup, getMarkupIdImpl, getMarkupSourcingStrategy, getMetaData, getModelComparator, getOutputMarkupId, getOutputMarkupPlaceholderTag, getPage, getPageRelativePath, getParent, getPath, getRenderBodyOnly, getRequest, getRequestCycle, getRequestFlag, getResponse, getSession, getSizeInBytes, getStatelessHint, getString, getString, getString, getStyle, getVariation, hasBeenRendered, hasErrorMessage, hasFeedbackMessage, info, initModel, internalOnModelChanged, internalPrepareForRender, internalRenderComponent, internalRenderHead, isActionAuthorized, isAuto, isBehaviorAccepted, isEnableAllowed, isEnabled, isEnabledInHierarchy, isIgnoreAttributeModifier, isRenderAllowed, isRendering, isStateless, isVersioned, isVisibilityAllowed, isVisible, isVisibleInHierarchy, markRendering, modelChanged, modelChanging, onAfterRender, onBeforeRender, onConfigure, onEvent, onModelChanged, onModelChanging, onReAdd, onRemove, prepareForRender, redirectToInterceptPage, remove, remove, render, renderComponentTag, rendered, renderHead, renderHead, renderPlaceholderTag, replaceComponentTagBody, replaceWith, sameInnermostModel, sameInnermostModel, send, setAuto, setDefaultModelObject, setEnabled, setEscapeModelStrings, setFlag, setIgnoreAttributeModifier, setMarkup, setMarkupId, setMarkupIdImpl, setMetaData, setOutputMarkupId, setOutputMarkupPlaceholderTag, setParent, setRenderBodyOnly, setRequestFlag, setResponsePage, setResponsePage, setResponsePage, setVersioned, setVisibilityAllowed, setVisible, success, urlFor, urlFor, urlFor, urlFor, urlFor, visitParents, visitParents, warn, wrap

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.wicket.IQueueRegion

dequeue, newDequeueContext

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

BSFormHorizontal

public BSFormHorizontal(String id,
                        org.apache.wicket.model.IModel<?> model)

BSFormHorizontal

public BSFormHorizontal(String id)

Method Detail

getDefaultGridSize

public IBSGridCol.BSGridSize getDefaultGridSize()

setDefaultGridSize

public BSFormHorizontal setDefaultGridSize(IBSGridCol.BSGridSize defaultGridSize)

appendGroup

public BSFormHorizontal appendGroup(IBSComponentFactory<BSFormGroup> factory)

appendGroupLabelControlsFeedback

public BSFormHorizontal appendGroupLabelControlsFeedback(int labelColspan,
                                                         org.apache.wicket.Component labelFor,
                                                         Serializable labelValueOrModel,
                                                         int controlsColspan,
                                                         org.apache.wicket.Component feedback,
                                                         IBSComponentFactory<BSControls> factory)

appendGroupLabelControlsFeedback

public BSFormHorizontal appendGroupLabelControlsFeedback(int labelColspan,
                                                         Serializable labelValueOrModel,
                                                         int controlsColspan,
                                                         org.apache.wicket.Component feedback,
                                                         IBSComponentFactory<BSControls> factory)

appendGroupLabelControls

public BSFormHorizontal appendGroupLabelControls(int labelColspan,
                                                 Serializable labelValueOrModel,
                                                 int controlsColspan,
                                                 IBSComponentFactory<BSControls> factory)

appendGroupOffsetControls

public BSFormHorizontal appendGroupOffsetControls(int mdOffset,
                                                  int controlsColspan,
                                                  IBSComponentFactory<BSControls> factory)

newGroup

public BSFormGroup newGroup()

newControlsInGroup

public BSControls newControlsInGroup(int labelColspan,
                                     Serializable labelValueOrModel,
                                     int controlsColspan)

newControlsInGroup

public BSControls newControlsInGroup(int mdOffset,
                                     int controlsColspan)

add

public BSFormHorizontal add(org.apache.wicket.behavior.Behavior... behaviors)

Overrides:

add in class org.apache.wicket.Component