Skip to content

Commit 289fc10

Browse files
committed
Consistently use search appearance rather than autocomplete
1 parent 745535a commit 289fc10

File tree

3 files changed

+13
-9
lines changed

3 files changed

+13
-9
lines changed

docs/form-question-types.rst

+13-9
Original file line numberDiff line numberDiff line change
@@ -796,7 +796,7 @@ type
796796
appearance
797797
``minimal``
798798

799-
Adding the ``minimal`` appearance shows the choices in a compact way. This is particularly helpful when the list of choices is long and the select question is displayed on :ref:`the same screen as other questions <field-list>`. It is often combined with :ref:`the autocomplete appearance <select-autocomplete>`.
799+
Adding the ``minimal`` appearance shows the choices in a compact way. This is particularly helpful when the list of choices is long and the select question is displayed on :ref:`the same screen as other questions <field-list>`. It is often combined with :ref:`the search appearance <select-search>`.
800800

801801
.. image:: /img/form-question-types/select-one-minimal-start.*
802802
:alt: The Single Select form widget, with minimal appearance, as displayed in the ODK Collect app on an Android phone. The question text is "Select widget." The hint text is "select_one type with minimal appearance, 4 text choices." Below that is a drop-down style select menu with the prompt "Select One Answer." Above the question text is the form group name "Select one widgets."
@@ -857,23 +857,27 @@ once a selection is made.
857857
opt_abcd,c,C
858858
opt_abcd,d,D
859859

860-
.. _select-autocomplete:
860+
.. _select-search:
861861

862-
Select widget with autocomplete
862+
Select widget with search
863863
""""""""""""""""""""""""""""""""
864864

865865
type
866866
``select_one {list_name}``
867867
appearance
868-
``autocomplete``
868+
``search``
869869

870-
The ``autocomplete`` appearance allows the enumerator to filter the list of available choices. This is especially helpful for questions with a large number of choices.
870+
The ``search`` appearance allows the enumerator to filter the list of available choices. This is especially helpful for questions with a large number of choices.
871871

872-
.. image:: /img/form-question-types/select-autocomplete.*
873-
:alt: The Select One form widget with autocomplete, as displayed in the ODK Collect app on an Android phone. The question text is "Select one widget." The hint text is, "select one type with autocomplete appearance, 4 text choices." Below that is a text input followed by four radio buttons labeled A, B, C, and D. Above the question text is the form group name "Select one widgets." The device keyboard is active.
872+
.. note::
873+
874+
``autocomplete`` is an alias for ``search`` and can be used to serve the same purpose.
875+
876+
.. image:: /img/form-question-types/select-search.*
877+
:alt: The Select One form widget with search, as displayed in the ODK Collect app on an Android phone. The question text is "Select one widget." The hint text is, "select one type with search appearance, 4 text choices." Below that is a text input followed by four radio buttons labeled A, B, C, and D. Above the question text is the form group name "Select one widgets." The device keyboard is active.
874878
:class: device-screen-vertical
875879

876-
.. image:: /img/form-question-types/select-autocomplete-filtered.*
880+
.. image:: /img/form-question-types/select-search-filtered.*
877881
:alt: The Select One form widget as displayed previously. The text input contains a lowercase 'b'. There is a single radio button: B. The other three radio buttons are no longer displayed.
878882
:class: device-screen-vertical
879883

@@ -882,7 +886,7 @@ The ``autocomplete`` appearance allows the enumerator to filter the list of avai
882886
.. csv-table:: survey
883887
:header: type, name, label, appearance, hint
884888

885-
select_one opt_abcd,select_one_autocomplete_widget,Select one widget,autocomplete,"select_one type with autocomplete appearance, 4 text choices"
889+
select_one opt_abcd,select_one_search_widget,Select one widget,search,"select_one type with search appearance, 4 text choices"
886890

887891
.. csv-table:: choices
888892
:header: list_name, name, label

0 commit comments

Comments
 (0)