Skip to content

Commit 1958c5c

Browse files
committed
Document the hidden-answer appearance for external string question types
1 parent 7219bff commit 1958c5c

File tree

1 file changed

+12
-0
lines changed

1 file changed

+12
-0
lines changed

docs/form-question-types.rst

+12
Original file line numberDiff line numberDiff line change
@@ -140,6 +140,18 @@ The external app widget is displayed when the ``appearance`` attribute begins wi
140140

141141
text,ex_string_widget,Ex string widget,ex:change.uw.android.BREATHCOUNT,text type with ex:change.uw.android.BREATHCOUNT appearance (can use other external apps)
142142

143+
Hiding the received value
144+
""""""""""""""""""""""""""""
145+
146+
By default, the received value is shown below the widget button. In some cases, the raw received value is not helpful to display. For example, it may be very long or may represent a list of values. In that case, you can use the ``hidden-answer`` appearance. We generally recommend putting this question in a :ref:`field-list <field-list>` to provide some useful feedback about the received value.
147+
148+
.. rubric:: XLSForm
149+
150+
.. csv-table:: survey
151+
:header: type, name, label, appearance, hint
152+
153+
text,ex_string_widget,Ex string widget,ex:change.uw.android.BREATHCOUNT hidden-answer,text type with ex:change.uw.android.BREATHCOUNT hidden-answer appearance (can use other external apps)
154+
143155

144156
.. _masked-text-widget:
145157

0 commit comments

Comments
 (0)