summaryrefslogtreecommitdiff
path: root/Documentation/HumanInterfaceGuidelines/Text.md
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation/HumanInterfaceGuidelines/Text.md')
-rw-r--r--Documentation/HumanInterfaceGuidelines/Text.md23
1 files changed, 23 insertions, 0 deletions
diff --git a/Documentation/HumanInterfaceGuidelines/Text.md b/Documentation/HumanInterfaceGuidelines/Text.md
index cd45aca7e5..5592317ff5 100644
--- a/Documentation/HumanInterfaceGuidelines/Text.md
+++ b/Documentation/HumanInterfaceGuidelines/Text.md
@@ -52,3 +52,26 @@ of proper names, weekdays, etc.
- Radio button labels
- Status bar text
- Text box labels
+
+## Ellipses
+
+The ellipsis, represented by a series of three periods (...), has two special
+functions in the interface:
+
+- Eliding text
+- Foreshadowing additional user input
+
+The first occurs programmatically, but the second requires care when setting
+text manually.
+
+Control text which implies an action whose effect is incomplete pending further
+user input should end in an ellipsis. Opening a new window does not in itself
+justify the use of an ellipsis; the dialog must be an intermediate step toward
+completing the action.
+
+Ellipses should be used sparingly elsewhere to avoid confusion with elision.
+
+#### Examples:
+- Save As...
+- Browse...
+- Insert Emoji...