govuk_publishing_components 12.20.0 → 12.21.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (62) hide show
  1. checksums.yaml +4 -4
  2. data/app/assets/stylesheets/govuk_publishing_components/components/_image-card.scss +2 -2
  3. data/app/assets/stylesheets/govuk_publishing_components/components/_related-navigation.scss +8 -0
  4. data/app/views/govuk_publishing_components/components/_contextual_breadcrumbs.html.erb +8 -8
  5. data/app/views/govuk_publishing_components/components/_contextual_footer.html.erb +10 -0
  6. data/app/views/govuk_publishing_components/components/_contextual_sidebar.html.erb +5 -14
  7. data/app/views/govuk_publishing_components/components/_layout_footer.html.erb +5 -3
  8. data/app/views/govuk_publishing_components/components/_related_navigation.html.erb +10 -6
  9. data/app/views/govuk_publishing_components/components/docs/contextual_breadcrumbs.yml +3 -2
  10. data/app/views/govuk_publishing_components/components/docs/contextual_footer.yml +71 -0
  11. data/app/views/govuk_publishing_components/components/docs/contextual_sidebar.yml +18 -9
  12. data/app/views/govuk_publishing_components/components/docs/layout_footer.yml +17 -0
  13. data/app/views/govuk_publishing_components/components/docs/related_navigation.yml +53 -0
  14. data/app/views/govuk_publishing_components/components/related_navigation/_section.html.erb +10 -5
  15. data/config/locales/en.yml +5 -6
  16. data/lib/govuk_publishing_components.rb +0 -2
  17. data/lib/govuk_publishing_components/presenters/contextual_navigation.rb +0 -4
  18. data/lib/govuk_publishing_components/presenters/related_navigation_helper.rb +108 -90
  19. data/lib/govuk_publishing_components/version.rb +1 -1
  20. data/node_modules/govuk-frontend/components/back-link/README.md +4 -73
  21. data/node_modules/govuk-frontend/components/breadcrumbs/README.md +4 -238
  22. data/node_modules/govuk-frontend/components/button/README.md +4 -174
  23. data/node_modules/govuk-frontend/components/character-count/README.md +4 -340
  24. data/node_modules/govuk-frontend/components/character-count/template.njk +0 -3
  25. data/node_modules/govuk-frontend/components/checkboxes/README.md +4 -705
  26. data/node_modules/govuk-frontend/components/checkboxes/template.njk +1 -0
  27. data/node_modules/govuk-frontend/components/date-input/README.md +4 -563
  28. data/node_modules/govuk-frontend/components/date-input/template.njk +1 -0
  29. data/node_modules/govuk-frontend/components/details/README.md +4 -128
  30. data/node_modules/govuk-frontend/components/error-message/README.md +4 -58
  31. data/node_modules/govuk-frontend/components/error-summary/README.md +4 -94
  32. data/node_modules/govuk-frontend/components/fieldset/README.md +4 -92
  33. data/node_modules/govuk-frontend/components/file-upload/README.md +4 -199
  34. data/node_modules/govuk-frontend/components/file-upload/template.njk +1 -0
  35. data/node_modules/govuk-frontend/components/footer/README.md +4 -91
  36. data/node_modules/govuk-frontend/components/footer/_footer.scss +22 -13
  37. data/node_modules/govuk-frontend/components/header/README.md +4 -351
  38. data/node_modules/govuk-frontend/components/hint/README.md +5 -77
  39. data/node_modules/govuk-frontend/components/input/README.md +4 -407
  40. data/node_modules/govuk-frontend/components/input/template.njk +1 -0
  41. data/node_modules/govuk-frontend/components/inset-text/README.md +4 -76
  42. data/node_modules/govuk-frontend/components/label/README.md +5 -97
  43. data/node_modules/govuk-frontend/components/panel/README.md +4 -93
  44. data/node_modules/govuk-frontend/components/phase-banner/README.md +4 -67
  45. data/node_modules/govuk-frontend/components/radios/README.md +4 -665
  46. data/node_modules/govuk-frontend/components/radios/template.njk +1 -0
  47. data/node_modules/govuk-frontend/components/select/README.md +4 -257
  48. data/node_modules/govuk-frontend/components/select/template.njk +1 -0
  49. data/node_modules/govuk-frontend/components/skip-link/README.md +4 -57
  50. data/node_modules/govuk-frontend/components/table/README.md +4 -368
  51. data/node_modules/govuk-frontend/components/tabs/README.md +4 -242
  52. data/node_modules/govuk-frontend/components/tag/README.md +4 -77
  53. data/node_modules/govuk-frontend/components/textarea/README.md +4 -193
  54. data/node_modules/govuk-frontend/components/textarea/template.njk +1 -0
  55. data/node_modules/govuk-frontend/components/warning-text/README.md +4 -63
  56. data/node_modules/govuk-frontend/components/warning-text/_warning-text.scss +1 -2
  57. data/node_modules/govuk-frontend/core/_lists.scss +17 -8
  58. data/node_modules/govuk-frontend/package.json +10 -10
  59. metadata +4 -5
  60. data/app/views/govuk_publishing_components/components/_taxonomy_navigation.html.erb +0 -116
  61. data/app/views/govuk_publishing_components/components/docs/taxonomy_navigation.yml +0 -119
  62. data/lib/govuk_publishing_components/presenters/taxonomy_navigation.rb +0 -47
@@ -1,253 +1,15 @@
1
1
  # Tabs
2
2
 
3
- ## Introduction
3
+ ## Installation
4
4
 
5
- Component for conditionally revealing content, using tabs and tabs panels.
5
+ See the [main README quick start guide](https://github.com/alphagov/govuk-frontend#quick-start) for how to install this component.
6
6
 
7
- ## Guidance
7
+ ## Guidance and Examples
8
8
 
9
9
  Find out when to use the tabs component in your service in the [GOV.UK Design System](https://design-system.service.gov.uk/components/tabs).
10
10
 
11
- ## Quick start examples
12
-
13
- ### Tabs
14
-
15
- [Preview this example in the Frontend review app](http://govuk-frontend-review.herokuapp.com/components/tabs/preview)
16
-
17
- #### Markup
18
-
19
- <div class="govuk-tabs" data-module="tabs">
20
- <h2 class="govuk-tabs__title">
21
- Contents
22
- </h2>
23
-
24
- <ul class="govuk-tabs__list">
25
-
26
- <li class="govuk-tabs__list-item">
27
- <a class="govuk-tabs__tab govuk-tabs__tab--selected" href="#past-day">
28
- Past day
29
- </a>
30
- </li>
31
-
32
- <li class="govuk-tabs__list-item">
33
- <a class="govuk-tabs__tab" href="#past-week">
34
- Past week
35
- </a>
36
- </li>
37
-
38
- <li class="govuk-tabs__list-item">
39
- <a class="govuk-tabs__tab" href="#past-month">
40
- Past month
41
- </a>
42
- </li>
43
-
44
- <li class="govuk-tabs__list-item">
45
- <a class="govuk-tabs__tab" href="#past-year">
46
- Past year
47
- </a>
48
- </li>
49
-
50
- </ul>
51
-
52
- <section class="govuk-tabs__panel" id="past-day">
53
- <h2 class="govuk-heading-l">Past day</h2>
54
- <table class="govuk-table">
55
- <thead class="govuk-table__head">
56
- <tr class="govuk-table__row">
57
- <th class="govuk-table__header" scope="col">Case manager</th>
58
- <th class="govuk-table__header" scope="col">Cases opened</th>
59
- <th class="govuk-table__header" scope="col">Cases closed</th>
60
- </tr>
61
- </thead>
62
- <tbody class="govuk-table__body">
63
- <tr class="govuk-table__row">
64
- <td class="govuk-table__cell">David Francis</td>
65
- <td class="govuk-table__cell">3</td>
66
- <td class="govuk-table__cell">0</td>
67
- </tr>
68
- <tr class="govuk-table__row">
69
- <td class="govuk-table__cell">Paul Farmer</td>
70
- <td class="govuk-table__cell">1</td>
71
- <td class="govuk-table__cell">0</td>
72
- </tr>
73
- <tr class="govuk-table__row">
74
- <td class="govuk-table__cell">Rita Patel</td>
75
- <td class="govuk-table__cell">2</td>
76
- <td class="govuk-table__cell">0</td>
77
- </tr>
78
- </tbody>
79
- </table>
80
-
81
- </section>
82
-
83
- <section class="govuk-tabs__panel govuk-tabs__panel--hidden" id="past-week">
84
- <h2 class="govuk-heading-l">Past week</h2>
85
- <table class="govuk-table">
86
- <thead class="govuk-table__head">
87
- <tr class="govuk-table__row">
88
- <th class="govuk-table__header" scope="col">Case manager</th>
89
- <th class="govuk-table__header" scope="col">Cases opened</th>
90
- <th class="govuk-table__header" scope="col">Cases closed</th>
91
- </tr>
92
- </thead>
93
- <tbody class="govuk-table__body">
94
- <tr class="govuk-table__row">
95
- <td class="govuk-table__cell">David Francis</td>
96
- <td class="govuk-table__cell">24</td>
97
- <td class="govuk-table__cell">18</td>
98
- </tr>
99
- <tr class="govuk-table__row">
100
- <td class="govuk-table__cell">Paul Farmer</td>
101
- <td class="govuk-table__cell">16</td>
102
- <td class="govuk-table__cell">20</td>
103
- </tr>
104
- <tr class="govuk-table__row">
105
- <td class="govuk-table__cell">Rita Patel</td>
106
- <td class="govuk-table__cell">24</td>
107
- <td class="govuk-table__cell">27</td>
108
- </tr>
109
- </tbody>
110
- </table>
111
-
112
- </section>
113
-
114
- <section class="govuk-tabs__panel govuk-tabs__panel--hidden" id="past-month">
115
- <h2 class="govuk-heading-l">Past month</h2>
116
- <table class="govuk-table">
117
- <thead class="govuk-table__head">
118
- <tr class="govuk-table__row">
119
- <th class="govuk-table__header" scope="col">Case manager</th>
120
- <th class="govuk-table__header" scope="col">Cases opened</th>
121
- <th class="govuk-table__header" scope="col">Cases closed</th>
122
- </tr>
123
- </thead>
124
- <tbody class="govuk-table__body">
125
- <tr class="govuk-table__row">
126
- <td class="govuk-table__cell">David Francis</td>
127
- <td class="govuk-table__cell">98</td>
128
- <td class="govuk-table__cell">95</td>
129
- </tr>
130
- <tr class="govuk-table__row">
131
- <td class="govuk-table__cell">Paul Farmer</td>
132
- <td class="govuk-table__cell">122</td>
133
- <td class="govuk-table__cell">131</td>
134
- </tr>
135
- <tr class="govuk-table__row">
136
- <td class="govuk-table__cell">Rita Patel</td>
137
- <td class="govuk-table__cell">126</td>
138
- <td class="govuk-table__cell">142</td>
139
- </tr>
140
- </tbody>
141
- </table>
142
-
143
- </section>
144
-
145
- <section class="govuk-tabs__panel govuk-tabs__panel--hidden" id="past-year">
146
- <h2 class="govuk-heading-l">Past year</h2>
147
- <table class="govuk-table">
148
- <thead class="govuk-table__head">
149
- <tr class="govuk-table__row">
150
- <th class="govuk-table__header" scope="col">Case manager</th>
151
- <th class="govuk-table__header" scope="col">Cases opened</th>
152
- <th class="govuk-table__header" scope="col">Cases closed</th>
153
- </tr>
154
- </thead>
155
- <tbody class="govuk-table__body">
156
- <tr class="govuk-table__row">
157
- <td class="govuk-table__cell">David Francis</td>
158
- <td class="govuk-table__cell">1380</td>
159
- <td class="govuk-table__cell">1472</td>
160
- </tr>
161
- <tr class="govuk-table__row">
162
- <td class="govuk-table__cell">Paul Farmer</td>
163
- <td class="govuk-table__cell">1129</td>
164
- <td class="govuk-table__cell">1083</td>
165
- </tr>
166
- <tr class="govuk-table__row">
167
- <td class="govuk-table__cell">Rita Patel</td>
168
- <td class="govuk-table__cell">1539</td>
169
- <td class="govuk-table__cell">1265</td>
170
- </tr>
171
- </tbody>
172
- </table>
173
-
174
- </section>
175
-
176
- </div>
177
-
178
- #### Macro
179
-
180
- {% from "tabs/macro.njk" import govukTabs %}
181
-
182
- {{ govukTabs({
183
- "items": [
184
- {
185
- "label": "Past day",
186
- "id": "past-day",
187
- "panel": {
188
- "html": "<h2 class=\"govuk-heading-l\">Past day</h2>\n<table class=\"govuk-table\">\n <thead class=\"govuk-table__head\">\n <tr class=\"govuk-table__row\">\n <th class=\"govuk-table__header\" scope=\"col\">Case manager</th>\n <th class=\"govuk-table__header\" scope=\"col\">Cases opened</th>\n <th class=\"govuk-table__header\" scope=\"col\">Cases closed</th>\n </tr>\n </thead>\n <tbody class=\"govuk-table__body\">\n <tr class=\"govuk-table__row\">\n <td class=\"govuk-table__cell\">David Francis</td>\n <td class=\"govuk-table__cell\">3</td>\n <td class=\"govuk-table__cell\">0</td>\n </tr>\n <tr class=\"govuk-table__row\">\n <td class=\"govuk-table__cell\">Paul Farmer</td>\n <td class=\"govuk-table__cell\">1</td>\n <td class=\"govuk-table__cell\">0</td>\n </tr>\n <tr class=\"govuk-table__row\">\n <td class=\"govuk-table__cell\">Rita Patel</td>\n <td class=\"govuk-table__cell\">2</td>\n <td class=\"govuk-table__cell\">0</td>\n </tr>\n </tbody>\n</table>\n"
189
- }
190
- },
191
- {
192
- "label": "Past week",
193
- "id": "past-week",
194
- "panel": {
195
- "html": "<h2 class=\"govuk-heading-l\">Past week</h2>\n<table class=\"govuk-table\">\n <thead class=\"govuk-table__head\">\n <tr class=\"govuk-table__row\">\n <th class=\"govuk-table__header\" scope=\"col\">Case manager</th>\n <th class=\"govuk-table__header\" scope=\"col\">Cases opened</th>\n <th class=\"govuk-table__header\" scope=\"col\">Cases closed</th>\n </tr>\n </thead>\n <tbody class=\"govuk-table__body\">\n <tr class=\"govuk-table__row\">\n <td class=\"govuk-table__cell\">David Francis</td>\n <td class=\"govuk-table__cell\">24</td>\n <td class=\"govuk-table__cell\">18</td>\n </tr>\n <tr class=\"govuk-table__row\">\n <td class=\"govuk-table__cell\">Paul Farmer</td>\n <td class=\"govuk-table__cell\">16</td>\n <td class=\"govuk-table__cell\">20</td>\n </tr>\n <tr class=\"govuk-table__row\">\n <td class=\"govuk-table__cell\">Rita Patel</td>\n <td class=\"govuk-table__cell\">24</td>\n <td class=\"govuk-table__cell\">27</td>\n </tr>\n </tbody>\n</table>\n"
196
- }
197
- },
198
- {
199
- "label": "Past month",
200
- "id": "past-month",
201
- "panel": {
202
- "html": "<h2 class=\"govuk-heading-l\">Past month</h2>\n<table class=\"govuk-table\">\n <thead class=\"govuk-table__head\">\n <tr class=\"govuk-table__row\">\n <th class=\"govuk-table__header\" scope=\"col\">Case manager</th>\n <th class=\"govuk-table__header\" scope=\"col\">Cases opened</th>\n <th class=\"govuk-table__header\" scope=\"col\">Cases closed</th>\n </tr>\n </thead>\n <tbody class=\"govuk-table__body\">\n <tr class=\"govuk-table__row\">\n <td class=\"govuk-table__cell\">David Francis</td>\n <td class=\"govuk-table__cell\">98</td>\n <td class=\"govuk-table__cell\">95</td>\n </tr>\n <tr class=\"govuk-table__row\">\n <td class=\"govuk-table__cell\">Paul Farmer</td>\n <td class=\"govuk-table__cell\">122</td>\n <td class=\"govuk-table__cell\">131</td>\n </tr>\n <tr class=\"govuk-table__row\">\n <td class=\"govuk-table__cell\">Rita Patel</td>\n <td class=\"govuk-table__cell\">126</td>\n <td class=\"govuk-table__cell\">142</td>\n </tr>\n </tbody>\n</table>\n"
203
- }
204
- },
205
- {
206
- "label": "Past year",
207
- "id": "past-year",
208
- "panel": {
209
- "html": "<h2 class=\"govuk-heading-l\">Past year</h2>\n<table class=\"govuk-table\">\n <thead class=\"govuk-table__head\">\n <tr class=\"govuk-table__row\">\n <th class=\"govuk-table__header\" scope=\"col\">Case manager</th>\n <th class=\"govuk-table__header\" scope=\"col\">Cases opened</th>\n <th class=\"govuk-table__header\" scope=\"col\">Cases closed</th>\n </tr>\n </thead>\n <tbody class=\"govuk-table__body\">\n <tr class=\"govuk-table__row\">\n <td class=\"govuk-table__cell\">David Francis</td>\n <td class=\"govuk-table__cell\">1380</td>\n <td class=\"govuk-table__cell\">1472</td>\n </tr>\n <tr class=\"govuk-table__row\">\n <td class=\"govuk-table__cell\">Paul Farmer</td>\n <td class=\"govuk-table__cell\">1129</td>\n <td class=\"govuk-table__cell\">1083</td>\n </tr>\n <tr class=\"govuk-table__row\">\n <td class=\"govuk-table__cell\">Rita Patel</td>\n <td class=\"govuk-table__cell\">1539</td>\n <td class=\"govuk-table__cell\">1265</td>\n </tr>\n </tbody>\n</table>\n"
210
- }
211
- }
212
- ]
213
- }) }}
214
-
215
- ## Requirements
216
-
217
- ### Build tool configuration
218
-
219
- When compiling the Sass files you'll need to define includePaths to reference the node_modules directory. Below is a sample configuration using gulp
220
-
221
- .pipe(sass({
222
- includePaths: 'node_modules/'
223
- }))
224
-
225
- ### Static asset path configuration
226
-
227
- In order to include the images used in the components, you need to configure your app to show these assets. Below is a sample configuration using Express js:
228
-
229
- app.use('/assets', express.static(path.join(__dirname, '/node_modules/govuk-frontend/assets')))
230
-
231
11
  ## Component options
232
12
 
233
13
  Use options to customise the appearance, content and behaviour of a component when using a macro, for example, changing the text.
234
14
 
235
- See [options table](https://design-system.service.gov.uk/components/tabs/#options-example-default) for details.
236
-
237
- ### Setting up Nunjucks views and paths
238
-
239
- Below is an example setup using express configure views:
240
-
241
- nunjucks.configure('node_modules/govuk-frontend/components', {
242
- autoescape: true,
243
- cache: false,
244
- express: app
245
- })
246
-
247
- ## Contribution
248
-
249
- Guidelines can be found at [on our Github repository.](https://github.com/alphagov/govuk-frontend/blob/master/CONTRIBUTING.md "link to contributing guidelines on our github repository")
250
-
251
- ## License
252
-
253
- MIT
15
+ See [options table](https://design-system.service.gov.uk/components/tabs/#options-example-default) for details.
@@ -1,88 +1,15 @@
1
1
  # Tag
2
2
 
3
- ## Introduction
3
+ ## Installation
4
4
 
5
- Phase tags are mostly used inside phase banners as an indication of the state of a project. It’s possible to use them outside phase banners, for example as part of a service header.
5
+ See the [main README quick start guide](https://github.com/alphagov/govuk-frontend#quick-start) for how to install this component.
6
6
 
7
- ## Guidance
7
+ ## Guidance and Examples
8
8
 
9
9
  Find out when to use the tag component in your service in the [GOV.UK Design System](https://design-system.service.gov.uk/components/tag).
10
10
 
11
- ## Quick start examples
12
-
13
- ### Tag
14
-
15
- [Preview this example in the Frontend review app](http://govuk-frontend-review.herokuapp.com/components/tag/preview)
16
-
17
- #### Markup
18
-
19
- <strong class="govuk-tag">
20
- alpha
21
- </strong>
22
-
23
- #### Macro
24
-
25
- {% from "tag/macro.njk" import govukTag %}
26
-
27
- {{ govukTag({
28
- "text": "alpha"
29
- }) }}
30
-
31
- ### Tag inactive
32
-
33
- [Preview this example in the Frontend review app](http://govuk-frontend-review.herokuapp.com/components/tag/inactive/preview)
34
-
35
- #### Markup
36
-
37
- <strong class="govuk-tag govuk-tag--inactive">
38
- alpha
39
- </strong>
40
-
41
- #### Macro
42
-
43
- {% from "tag/macro.njk" import govukTag %}
44
-
45
- {{ govukTag({
46
- "text": "alpha",
47
- "classes": "govuk-tag--inactive"
48
- }) }}
49
-
50
- ## Requirements
51
-
52
- ### Build tool configuration
53
-
54
- When compiling the Sass files you'll need to define includePaths to reference the node_modules directory. Below is a sample configuration using gulp
55
-
56
- .pipe(sass({
57
- includePaths: 'node_modules/'
58
- }))
59
-
60
- ### Static asset path configuration
61
-
62
- In order to include the images used in the components, you need to configure your app to show these assets. Below is a sample configuration using Express js:
63
-
64
- app.use('/assets', express.static(path.join(__dirname, '/node_modules/govuk-frontend/assets')))
65
-
66
11
  ## Component options
67
12
 
68
13
  Use options to customise the appearance, content and behaviour of a component when using a macro, for example, changing the text.
69
14
 
70
- See [options table](https://design-system.service.gov.uk/components/tag/#options-example-default) for details.
71
-
72
- ### Setting up Nunjucks views and paths
73
-
74
- Below is an example setup using express configure views:
75
-
76
- nunjucks.configure('node_modules/govuk-frontend/components', {
77
- autoescape: true,
78
- cache: false,
79
- express: app
80
- })
81
-
82
- ## Contribution
83
-
84
- Guidelines can be found at [on our Github repository.](https://github.com/alphagov/govuk-frontend/blob/master/CONTRIBUTING.md "link to contributing guidelines on our github repository")
85
-
86
- ## License
87
-
88
- MIT
15
+ See [options table](https://design-system.service.gov.uk/components/tag/#options-example-default) for details.
@@ -1,204 +1,15 @@
1
1
  # Textarea
2
2
 
3
- ## Introduction
3
+ ## Installation
4
4
 
5
- A multi-line text field.
5
+ See the [main README quick start guide](https://github.com/alphagov/govuk-frontend#quick-start) for how to install this component.
6
6
 
7
- ## Guidance
7
+ ## Guidance and Examples
8
8
 
9
9
  Find out when to use the textarea component in your service in the [GOV.UK Design System](https://design-system.service.gov.uk/components/textarea).
10
10
 
11
- ## Quick start examples
12
-
13
- ### Textarea
14
-
15
- [Preview this example in the Frontend review app](http://govuk-frontend-review.herokuapp.com/components/textarea/preview)
16
-
17
- #### Markup
18
-
19
- <div class="govuk-form-group">
20
- <label class="govuk-label" for="more-detail">
21
- Can you provide more detail?
22
- </label>
23
-
24
- <span id="more-detail-hint" class="govuk-hint">
25
- Don&#39;t include personal or financial information, eg your National Insurance number or credit card details.
26
- </span>
27
-
28
- <textarea class="govuk-textarea" id="more-detail" name="more-detail" rows="5" aria-describedby="more-detail-hint"></textarea>
29
- </div>
30
-
31
- #### Macro
32
-
33
- {% from "textarea/macro.njk" import govukTextarea %}
34
-
35
- {{ govukTextarea({
36
- "name": "more-detail",
37
- "id": "more-detail",
38
- "label": {
39
- "text": "Can you provide more detail?"
40
- },
41
- "hint": {
42
- "text": "Don't include personal or financial information, eg your National Insurance number or credit card details."
43
- }
44
- }) }}
45
-
46
- ### Textarea with error message
47
-
48
- [Preview this example in the Frontend review app](http://govuk-frontend-review.herokuapp.com/components/textarea/with-error-message/preview)
49
-
50
- #### Markup
51
-
52
- <div class="govuk-form-group govuk-form-group--error">
53
- <label class="govuk-label" for="no-ni-reason">
54
- Why can&#39;t you provide a National Insurance number?
55
- </label>
56
-
57
- <span id="no-ni-reason-error" class="govuk-error-message">
58
- You must provide an explanation
59
- </span>
60
-
61
- <textarea class="govuk-textarea govuk-textarea--error" id="no-ni-reason" name="no-ni-reason" rows="5" aria-describedby="no-ni-reason-error"></textarea>
62
- </div>
63
-
64
- #### Macro
65
-
66
- {% from "textarea/macro.njk" import govukTextarea %}
67
-
68
- {{ govukTextarea({
69
- "name": "no-ni-reason",
70
- "id": "no-ni-reason",
71
- "label": {
72
- "text": "Why can't you provide a National Insurance number?"
73
- },
74
- "errorMessage": {
75
- "text": "You must provide an explanation"
76
- }
77
- }) }}
78
-
79
- ### Textarea with default value
80
-
81
- [Preview this example in the Frontend review app](http://govuk-frontend-review.herokuapp.com/components/textarea/with-default-value/preview)
82
-
83
- #### Markup
84
-
85
- <div class="govuk-form-group">
86
- <label class="govuk-label" for="full-address">
87
- Full address
88
- </label>
89
-
90
- <textarea class="govuk-textarea" id="full-address" name="address" rows="5">221B Baker Street
91
- London
92
- NW1 6XE
93
- </textarea>
94
- </div>
95
-
96
- #### Macro
97
-
98
- {% from "textarea/macro.njk" import govukTextarea %}
99
-
100
- {{ govukTextarea({
101
- "id": "full-address",
102
- "name": "address",
103
- "value": "221B Baker Street\nLondon\nNW1 6XE\n",
104
- "label": {
105
- "text": "Full address"
106
- }
107
- }) }}
108
-
109
- ### Textarea with custom rows
110
-
111
- [Preview this example in the Frontend review app](http://govuk-frontend-review.herokuapp.com/components/textarea/with-custom-rows/preview)
112
-
113
- #### Markup
114
-
115
- <div class="govuk-form-group">
116
- <label class="govuk-label" for="full-address">
117
- Full address
118
- </label>
119
-
120
- <textarea class="govuk-textarea" id="full-address" name="address" rows="8"></textarea>
121
- </div>
122
-
123
- #### Macro
124
-
125
- {% from "textarea/macro.njk" import govukTextarea %}
126
-
127
- {{ govukTextarea({
128
- "id": "full-address",
129
- "name": "address",
130
- "label": {
131
- "text": "Full address"
132
- },
133
- "rows": 8
134
- }) }}
135
-
136
- ### Textarea with label as page heading
137
-
138
- [Preview this example in the Frontend review app](http://govuk-frontend-review.herokuapp.com/components/textarea/with-label-as-page-heading/preview)
139
-
140
- #### Markup
141
-
142
- <div class="govuk-form-group">
143
- <h1 class="govuk-label-wrapper">
144
- <label class="govuk-label" for="textarea-with-page-heading">
145
- Full address
146
- </label>
147
-
148
- </h1>
149
-
150
- <textarea class="govuk-textarea" id="textarea-with-page-heading" name="address" rows="5"></textarea>
151
- </div>
152
-
153
- #### Macro
154
-
155
- {% from "textarea/macro.njk" import govukTextarea %}
156
-
157
- {{ govukTextarea({
158
- "id": "textarea-with-page-heading",
159
- "name": "address",
160
- "label": {
161
- "text": "Full address",
162
- "isPageHeading": true
163
- }
164
- }) }}
165
-
166
- ## Requirements
167
-
168
- ### Build tool configuration
169
-
170
- When compiling the Sass files you'll need to define includePaths to reference the node_modules directory. Below is a sample configuration using gulp
171
-
172
- .pipe(sass({
173
- includePaths: 'node_modules/'
174
- }))
175
-
176
- ### Static asset path configuration
177
-
178
- In order to include the images used in the components, you need to configure your app to show these assets. Below is a sample configuration using Express js:
179
-
180
- app.use('/assets', express.static(path.join(__dirname, '/node_modules/govuk-frontend/assets')))
181
-
182
11
  ## Component options
183
12
 
184
13
  Use options to customise the appearance, content and behaviour of a component when using a macro, for example, changing the text.
185
14
 
186
- See [options table](https://design-system.service.gov.uk/components/textarea/#options-example-default) for details.
187
-
188
- ### Setting up Nunjucks views and paths
189
-
190
- Below is an example setup using express configure views:
191
-
192
- nunjucks.configure('node_modules/govuk-frontend/components', {
193
- autoescape: true,
194
- cache: false,
195
- express: app
196
- })
197
-
198
- ## Contribution
199
-
200
- Guidelines can be found at [on our Github repository.](https://github.com/alphagov/govuk-frontend/blob/master/CONTRIBUTING.md "link to contributing guidelines on our github repository")
201
-
202
- ## License
203
-
204
- MIT
15
+ See [options table](https://design-system.service.gov.uk/components/textarea/#options-example-default) for details.