diff --git a/HIG/source/patterns/content/picker.rst b/HIG/source/patterns/content/picker.rst index df53906..6f3c00b 100644 --- a/HIG/source/patterns/content/picker.rst +++ b/HIG/source/patterns/content/picker.rst @@ -1,58 +1,58 @@ Picker ====== Pickers implement a pattern to select multiple items from a list of available choices. The main component only displays the selected items, and more items can be added by choosing them from a list or grid in a dialog or overlay. In compairison to dual lists, they work well on desktop and mobile. Example ------- .. figure:: /img/LanguagePicker.png :alt: Picker in Language KCM :scale: 60% Use of a picker to select aditional languages. When to Use ----------- - Use a picker for multiple selection and in case of large lists. - Don't use it if both selected and unselected items need to be visible at once. Use a dual list instead. - Don't use a picker to show data primarily. - If selection state needs to change often, think about using a list with checkboxes or similar instead. How to Use ---------- .. figure:: /img/PickerOverlay.png :alt: Using an overlay :scale: 60% Using an overlay to pick aditional items. - Use a :doc:`grid ` or a - :doc:`list ` to display the selected elemets. -- Open list of additional items to choose in a overlay sheet or a dialog + :doc:`list ` to display the selected elements. +- Open a list of additional items to choose in an overlay sheet or a dialog. - Allow the user to select multiple items at once. -- Use either an on-demand control or display an button to allow the user +- Use either an on-demand control or display a button to allow the user to deselect items. - If the list of selected items can be reordered, place up/down buttons to the right of the list of current items. Only enable the up/down buttons when an item is selected and can be moved. -- Don't have blank list items; use meta-options, (e.g. "None") instead. +- Don't have blank list items; use meta-options (e.g. "None") instead. - Place options that represent general options (e.g. "All", "None") at the beginning of the list. - Sort list items in a logical order. Alphabetical sorting should be able to change when the text is translated. -- If the lists or grids appears in a dialog, consider making the window and +- If the lists or grids appear in a dialog, consider making the window and the lists or grids within it resizeable so that the user can choose how many list items are visible at a time without scrolling. - Use :doc:`sentence style capitalization ` for items.