Source code for enaml.widgets.form
#------------------------------------------------------------------------------
# Copyright (c) 2013, Nucleic Development Team.
#
# Distributed under the terms of the Modified BSD License.
#
# The full license is in the file LICENSE, distributed with this software.
#------------------------------------------------------------------------------
from atom.api import Int
from enaml.layout.constrainable import ConstraintMember
from enaml.layout.layout_helpers import align, vertical, horizontal, spacer
from enaml.core.declarative import d_, observe
from .container import Container
[docs]
class Form(Container):
""" A Container subclass that arranges its children in two columns.
The left column is typically Labels, but this is not a requirement.
The right are the actual widgets for data entry. The children should
be in alternating label/widget order. If there are an odd number
of children, the last child will span both columns.
The Form provides an extra constraint variable, 'midline', which
is used as the alignment anchor for the columns.
"""
#: The ConstraintVariable giving the midline along which the labels
#: and widgets are aligned.
midline = ConstraintMember()
#: The spacing to place between the form rows, in pixels.
row_spacing = d_(Int(10))
#: The spacing to place between the form columns, in pixels.
column_spacing = d_(Int(10))
#--------------------------------------------------------------------------
# Observers
#--------------------------------------------------------------------------
@observe('row_spacing', 'column_spacing')
def _layout_invalidated(self, change):
""" A private observer which invalidates the layout.
"""
# The superclass handler is sufficient.
super(Form, self)._layout_invalidated(change)
#--------------------------------------------------------------------------
# Layout Constraints
#--------------------------------------------------------------------------
[docs]
def layout_constraints(self):
""" Get the layout constraints for a Form.
A Form supplies default constraints which will arrange the
children in a two column layout. User defined 'constraints'
will be added on top of the generated form constraints.
This method cannot be overridden from Enaml syntax.
"""
children = self.visible_widgets()
labels = children[::2]
widgets = children[1::2]
n_labels = len(labels)
n_widgets = len(widgets)
if n_labels != n_widgets:
if n_labels > n_widgets:
odd_child = labels.pop()
else:
odd_child = widgets.pop()
else:
odd_child = None
# Boundary flex spacer
b_flx = spacer(0).flex()
# Inter-column flex spacer
c_flx = spacer(max(0, self.column_spacing)).flex()
# Inter-row flex spacer
r_flx = spacer(max(0, self.row_spacing)).flex()
# Generate the row constraints and make the column stacks
midline = self.midline
top = self.contents_top
left = self.contents_left
right = self.contents_right
constraints = self.constraints[:]
column1 = [top, b_flx]
column2 = [top, b_flx]
push = constraints.append
push_col1 = column1.append
push_col2 = column2.append
for label, widget in zip(labels, widgets):
push((widget.left == midline) | 'strong')
push(align('v_center', label, widget) | 'strong')
push(horizontal(left, b_flx, label, c_flx, widget, b_flx, right))
push_col1(label)
push_col1(r_flx)
push_col2(widget)
push_col2(r_flx)
# Handle the odd child and create the column constraints
if odd_child is not None:
push_col1(odd_child)
push_col2(odd_child)
push(horizontal(left, b_flx, odd_child, b_flx, right))
else:
column1.pop()
column2.pop()
bottom = self.contents_bottom
push_col1(b_flx)
push_col1(bottom)
push_col2(b_flx)
push_col2(bottom)
push(vertical(*column1))
push(vertical(*column2))
return constraints