- :param states: a dictionary mapping state values to lists of attribute-value
- pairs; possible attributes are: 'readonly', 'required', 'invisible'
+ :param states: a dictionary mapping state values to lists of UI attribute-value
+ pairs; possible attributes are: 'readonly', 'required', 'invisible'.
+ Note: Any state-based condition requires the ``state`` field value to be
+ available on the client-side UI. This is typically done by including it in
+ the relevant views, possibly made invisible if not relevant for the
+ end-user.