You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Object details give customers a primarily read-only view of the properties of an object, such as a message log or sent email.
52
52
53
-
If the customer is primarily editing information, use the [Settings](/page-templates/settings) page instead.
53
+
If the customer is primarily editing information, use the [settings](/page-templates/settings) page template instead.
54
54
55
55
## Accessibility
56
56
57
57
A well-structured [document hierarchy](https://www.w3.org/WAI/tutorials/page-structure/) helps provide efficient in-page navigation for keyboard users, assistive technologies, and mobile web users.
58
58
59
-
Proper hierarchy allows users to skip directly to content that is most relevant to them. This is especially important on an Object details page where there may be many different types of information and customers are more likely to skim through.
59
+
Proper hierarchy allows users to skip directly to content that is most relevant to them. This is especially important on an object details page where there may be many different types of information and customers are more likely to skim through.
An Objects list shows a list of unique items or records (objects), such as logs or contacts. The page can include [search and filtering](/patterns/filter-group) to help customers find an item they’re looking for, and bulk actions like [export](/patterns/data-export) or [delete](/patterns/delete).
50
+
An objects list shows a list of unique items or records (objects), such as logs or contacts. The page can include [search and filtering](/patterns/filter) to help customers find an item they’re looking for, and bulk actions like [export](/patterns/data-export) or [delete](/patterns/delete).
51
51
52
-
Use an Objects list when a customer needs to:
52
+
Use an objects list when a customer needs to:
53
53
54
54
- View objects of a single type
55
55
- Find specific objects quickly so they can view more [object details](/page-templates/object-details), edit, or delete them
56
56
- Create a new object of this type
57
57
- Perform bulk actions on multiple objects
58
58
59
-
If the customer is primarily editing information, use the [Settings](/page-templates/settings) page instead.
59
+
If the customer is primarily editing information, use the [settings](/page-templates/settings) page instead.
60
60
61
61
## Ingredients
62
62
@@ -78,9 +78,9 @@ The full header should be responsive to the width of the browser window. Heading
78
78
79
79
### Body
80
80
81
-
The rest of the page follows the [Filter Group pattern](/patterns/filter-group) and uses a [Data Grid](/components/data-grid). If there’s already a primary action in the page header, make the filter button a secondary button. If there are no interactive cells, use a Table instead of a Data Grid.
81
+
The rest of the page follows the [filter pattern](/patterns/filter) and uses a [Data Grid](/components/data-grid). If there are no interactive cells, use a Table instead of a Data Grid.
82
82
83
-
If the customer needs to examine each object in more detail, link each object to its [Object details](/page-templates/object-details) page.
83
+
If the customer needs to examine each object in more detail, link each object to its [object details](/page-templates/object-details) page.
84
84
85
85
The body should be responsive to the width of the browser window.
Copy file name to clipboardExpand all lines: packages/paste-website/src/pages/page-templates/settings/index.mdx
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
exportconst meta = {
2
2
title: 'Settings',
3
-
description: 'The Settings page template lets customers edit information and update simple settings.',
3
+
description: 'The settings page template lets customers edit information and update simple settings.',
4
4
slug: '/page-templates/settings/',
5
5
};
6
6
@@ -52,7 +52,7 @@ Settings pages let customers edit information and update simple settings.
52
52
53
53
If a customer is creating an object or the editing process is complex and requires additional guidance or focus, use the [create](/patterns/create) pattern and [wizard](/page-templates/wizard) template instead.
54
54
55
-
A Settings page can be a standalone page, or you can use a Settings overview page that links to multiple Settings pages.
55
+
A settings page can be a standalone page, or you can use a settings overview page that links to multiple settings pages.
56
56
57
57
## Ingredients
58
58
@@ -62,21 +62,21 @@ A Settings page can be a standalone page, or you can use a Settings overview pag
62
62
63
63
### Page header
64
64
65
-
At the top of the page, add a page heading using the format “[Settings type] settings.” For example, “Workplace settings” or “Source settings.” Optionally, use text under the heading to explain the primary settings on the page.
65
+
At the top of the page, add a page heading using the format “[settings type] settings.” For example, “Workplace settings” or “Source settings.” Optionally, use text under the heading to explain the primary settings on the page.
66
66
67
67
Heading and Paragraph should have a max width of `$size-70`.
68
68
69
69
### Body
70
70
71
-
Like [Object details](/page-templates/object-details), Settings should also allow a customer to easily scan for the information they’re looking to edit. Group related settings under Headings. Use sentence case for all Headings (“Billing details” not “Billing Details”).
71
+
Like [object details](/page-templates/object-details), settings should also allow a customer to easily scan for the information they’re looking to edit. Group related settings under Headings. Use sentence case for all Headings (“Billing details” not “Billing Details”).
72
72
73
73
If a group of settings needs additional explanation, use a Paragraph under a single Heading. If a single setting needs additional explanation, use Help Text with its form field.
74
74
75
-
Use customer research to inform how to order sections on the Settings page.
75
+
Use customer research to inform how to order sections on the settings page.
76
76
77
77
### Settings overview page
78
78
79
-
If there are too many settings to fit on a single page, split related settings into separate pages or Modals, and link to them from a Settings overview page. On a Settings overview page, use [Cards](/components/card) to group sections and surface the most relevant information with [Description Lists](components/description-list).
79
+
If there are too many settings to fit on a single page, split related settings into separate pages or Modals, and link to them from a Settings overview page. On a settings overview page, use [Cards](/components/card) to group sections and surface the most relevant information with [Description Lists](components/description-list).
80
80
81
81
Position the page content in the center with a max width of `$size-90`.
Use a Wizard when a customer’s goal is long or complex, and breaking it up into smaller page-by-page tasks allows the user to focus and not feel overwhelmed. A Wizard can be useful when the tasks to reach a goal are dependent on each other, and customers need to finish different tasks based on previous ones.
52
+
Use a wizard when a customer’s goal is long or complex, and breaking it up into smaller page-by-page tasks allows the user to focus and not feel overwhelmed. A wizard can be useful when the tasks to reach a goal are dependent on each other, and customers need to finish different tasks based on previous ones.
53
53
54
54
Start by splitting the goal across multiple tasks with each page containing just one main task, for example:
55
55
- One piece of information the customer needs to know
@@ -84,16 +84,16 @@ Before deciding on a page layout, make a few content and experience decisions fi
84
84
-**Task content:** Decide what content and components will help a customer finish each task.
85
85
-**Goal linearity and duration:** Decide whether a customer can achieve the entire goal in one session. Decide whether they need to leave Twilio to finish a task and whether they need to wait for Twilio to do something before finishing the flow.
86
86
87
-
There are 3 standard max-widths for the content of each Wizard page. Based on the content you need for each task, start with the smallest max-width and size up as needed:
87
+
There are 3 standard max-widths for the content of each wizard page. Based on the content you need for each task, start with the smallest max-width and size up as needed:
88
88
1.`size-70` (712px). If this is too small, use:
89
89
2.`size-100` (1024px). If this is too small, use:
90
90
3. Full-width, with a max-width of `size-70` for the Page Header.
91
91
92
-
Use the same max-width for each page of the Wizard if possible.
92
+
Use the same max-width for each page of the wizard if possible.
93
93
94
94
### Default template
95
95
96
-
In most scenarios, you’ll take customers through a Wizard without having to change the Sidebar or Topbar.
96
+
In most scenarios, you’ll take customers through a wizard without having to change the Sidebar or Topbar.
97
97
98
98
<StoryPreview
99
99
title="Wizard page template - default with content"
@@ -103,7 +103,7 @@ In most scenarios, you’ll take customers through a Wizard without having to ch
103
103
104
104
#### Page header
105
105
106
-
At the top of each page of the Wizard, add:
106
+
At the top of each page of the wizard, add:
107
107
- Wizard title as [Detail Text](/components/detail-text) (optional)
108
108
- Task [Heading](/components/heading)
109
109
-[Paragraph](/components/paragraph) text under the heading to explain the step (optional)
@@ -122,14 +122,14 @@ There may be cases where you need to show multiple tasks on the same page becaus
122
122
123
123
<Calloutvariant='neutral'marginY="space70">
124
124
<CalloutHeadingas="h2">Looking for guidelines on progressive disclosures?</CalloutHeading>
125
-
<CalloutText>We don’t have guidelines yet for this part of Wizard. If you need it for your work, please consider partnering with us to contribute it.</CalloutText>
125
+
<CalloutText>We don’t have guidelines yet for this part of wizard. If you need it for your work, please consider partnering with us to contribute it.</CalloutText>
126
126
</Callout>
127
127
128
128
#### Actions footer
129
129
130
130
Use these actions in the footer, starting from the right side of the page:
131
131
- A primary, right-aligned next [Button](/components/button) to let a customer move to the next task. The Button is right-aligned to signal that the flow is moving forward. If there are more tasks, use the word “Next” followed by [ArrowForwardIcon](/components/icon). If the customer is on the last task, the Button should indicate they are finishing the goal, and not include the arrow icon.
132
-
- A secondary, right-aligned Button with the word “Cancel” if customers can’t save their progress, or “Close” if they can. Follow the [confirmation pattern](/patterns/confirmation) for guidance on how to ask a customer to confirm that they want to leave a Wizard or save their progress.
132
+
- A secondary, right-aligned Button with the word “Cancel” if customers can’t save their progress, or “Close” if they can. Follow the [confirmation pattern](/patterns/confirmation) for guidance on how to ask a customer to confirm that they want to leave a wizard or save their progress.
133
133
- A secondary, left-aligned back Button. If there were previous tasks, use the [ArrowBackIcon](/components/icon) followed by the word “Back”. If there are no previous tasks, don’t show the Button.
134
134
135
135
If the task contents don’t fill the width of the page body, use a [Separator](/components/separator) above the actions with a gap of `space-50`. However this should be used sparingly because in most cases your content should fill the width of the page body.
@@ -151,11 +151,11 @@ Don’t disable any footer Buttons unless it’s immediately obvious to customer
151
151
code={WizardFullPageExample}
152
152
/>
153
153
154
-
Use the full-page Wizard template when it’s absolutely critical that a customer remains focused to finish the task.
154
+
Use the full-page wizard template when it’s absolutely critical that a customer remains focused to finish the task.
155
155
156
-
If your app allows it, load the Wizard without a Sidebar, and replace the content in the Topbar with:
156
+
If your app allows it, load the wizard without a Sidebar, and replace the content in the Topbar with:
157
157
158
-
- The Wizard title as a left-aligned [Heading](/components/heading)
158
+
- The wizard title as a left-aligned [Heading](/components/heading)
159
159
- A secondary, right-aligned Button with the word “Cancel” if customers can’t save their progress, or “Close” if they can. Follow the [confirmation pattern](/patterns/confirmation) for guidance on how to ask a customer to confirm that they want to leave a Wizard or save their progress.
160
160
161
161
If your app doesn’t allow loading a page without the navigation frame, [collapse the Sidebar](/components/sidebar#compact-push-sidebar) and follow the [default Wizard template](#default-template).
@@ -166,11 +166,11 @@ At the top of the page, add the Task [Heading](/components/heading) and if neede
166
166
167
167
#### Body
168
168
169
-
Follow the [default Wizard template](#default-template).
169
+
Follow the [default wizard template](#default-template).
170
170
171
171
#### Actions footer
172
172
173
-
Follow the [default Wizard template](#default-template), but don’t include a close button in the footer.
173
+
Follow the [default wizard template](#default-template), but don’t include a close button in the footer.
174
174
175
175
### When to use Progress Steps
176
176
@@ -180,7 +180,7 @@ Only use [Progress Steps](/components/progress-steps) when necessary. Some scena
180
180
- A goal takes a long time to finish.
181
181
- A customer is trying a feature out or going through more of an exploratory flow. Progress Steps can help them understand if they want to complete the steps.
182
182
183
-
If the customer’s journey through a Wizard is relatively linear, continuous, and short, don’t use Progress Steps.
183
+
If the customer’s journey through a wizard is relatively linear, continuous, and short, don’t use Progress Steps.
184
184
185
185
When in doubt, start by not using Progress Steps, and add it in once it’s clear the experience suffers without it.
186
186
@@ -193,7 +193,7 @@ Match Progress Steps labels to task headings for each page. If you need to use P
193
193
194
194
#### With the default template
195
195
196
-
Place Progress Steps above the Wizard title.
196
+
Place Progress Steps above the wizard title.
197
197
198
198
<StoryPreview
199
199
title="Wizard page template - default header with progress steps"
0 commit comments