Update tabs on examples component #111

alex-ju · 2018-01-08T14:13:02Z

This PR

makes use of the app-c-example-wrapper container for isolating the examples
allows an example to be used with/without the tabs opened on the same page
handles padding if the code block does/doesn't have a close button (single/multiple tab case)

hannalaakso

Left some comments. Some of them are more code style specific. Tested on /components/date-input/

hannalaakso · 2018-01-09T16:11:08Z

src/javascripts/components/tabs.js

-      // Let the main tabs deal with the states
-      $('.app-c-tabs__item a[href="' + id + '"]').click()
+      // Activate current tab
+      GOVUK.tabs.activateCurrentTab(id)


Could you check if id exists before doing this

might be more bulletproof for each function that needs id to check that it has it before proceeding?

hannalaakso · 2018-01-09T16:20:12Z

src/javascripts/components/tabs.js

+      var id = $(this).parent().attr('id')
+
+      // Reset tabs
+      GOVUK.tabs.resetTabs(id)


Same here re: id

hannalaakso · 2018-01-09T16:27:24Z

src/javascripts/components/tabs.js

-      $('.app-c-tabs__container').hide().attr('aria-selected', 'true')
+
+      // Get tab container ID and save example object
+      var id = $(this).parent().attr('id')


The close button doesn't close the container. I think this bit might be getting the wrong id.

it's missing the '#' from the id when it calls resetTabs

hannalaakso · 2018-01-09T16:38:49Z

src/javascripts/components/tabs.js


      // Bind close container link
      $('.app-c-link--close').click(GOVUK.tabs.clickCloseContainer)

      // Show open containers
-      $('.app-c-tabs a[open]').click()
+      $('.app-c-tabs__heading a[open]').click()


Could this be handled by just adding a class to the container?

hannalaakso · 2018-01-09T16:40:19Z

src/javascripts/components/tabs.js

+      $.each($examples, function (key, obj) {
+        if ($(obj).find('.app-c-tabs__container').length > 1) {
+          // Hide all containers
+          $(obj).find('.app-c-tabs__container').hide()


Same re: hide()

hannalaakso · 2018-01-09T16:40:53Z

src/javascripts/components/tabs.js

+      $example.find('.app-c-tabs__item').removeClass('app-c-tabs__item--current')
+      $example.find('.app-c-tabs__heading').removeClass('app-c-tabs__heading--current')
+      $example.find('.app-c-tabs__item a').removeAttr('aria-selected')
+      $example.find('.app-c-tabs__container').hide().attr('aria-hidden', 'true')


I would prefer to use a class that hides or shows the container to separate the presentation from this but this works too.

Makes use of the app-c-example-wrapper and allows an example to be used with/without the tabs opened on the same page

alex-ju · 2018-01-10T13:17:47Z

Updated addressing @hannalaakso's and @joelanman's comments.

joelanman · 2018-01-10T13:22:40Z

src/javascripts/components/tabs.js

+        $example.find('.app-c-tabs__item a').removeAttr('aria-selected')
+        $example.find('.app-c-tabs__container').hide().attr('aria-hidden', 'true')
+      } else {
+        console.log('resetTabs function needs a valid id')


maybe console.error ?

also - subjective thing, but I'd put the check for empty id first, then error and return from the function. That means the rest of the function doesn't have to be indented inside an if/else

just to check if I'm getting it right, you're proposing having something like:

function (id) { if (!id) { [error-block] } return { [function-body-block] } }

yep - except you don't need { } braces for the body block, which is the advantage over the if else approach, and 'return' should be inside the { } of the first if.

yeah, I just added those to state is a code block :)
to be honest, I'm used with single entry, single exit approach because it doesn't leak memory. but I might carry this on from C, and the javascript garbage collection might do a better job at it.

asked the team if they have preferences: it was 50%, so I added the return statement as suggested.

NickColley · 2018-01-10T16:21:16Z

src/javascripts/components/tabs.js

@@ -82,7 +92,7 @@
      $('.app-c-link--close').click(GOVUK.tabs.clickCloseContainer)

      // Show open containers
-      $('.app-c-tabs__heading a[open]').click()
+      $('.js-open').click()


Is this scoped to the current instance of the component? Is this class too generic?

nope, not scoped. may be too generic indeed. I'll need to have a chat about it.

thanks everyone. I'll refactor the code to use js- prefixes as the styleguide recommends and we'll review this afterwards.

alex-ju · 2018-01-10T17:20:38Z

Updated

NickColley · 2018-01-10T17:54:20Z

src/javascripts/components/tabs.js

+          $(obj).find('.js-tabs__container').hide()
+
+          // Add close button to each container
+          $(obj).find('.js-tabs__container').append('<a class="app-c-link--close js-link--close app-o-chevron--top" href="#close">Close</a>')


This might make more sense to be a button, raised an issue since there's other things like this. #124

NickColley · 2018-01-10T17:55:26Z

This needs tests really but approved based on the assumption that we'll be adding tests later since nothing else has tests.

alex-ju · 2018-01-10T18:24:55Z

Thanks, @NickColley! Indeed <button>s are semantically correct for the copy and close buttons.

This PR should have tests too, but I'll have to postpone that until after setting up the test framework for frontend js.

The documentation for the `pedantic` option [1] says: > If true, conform to the original markdown.pl as much as possible. Don't fix original markdown bugs or behavior. Turns off and overrides gfm. Verified that this option is doing nothing by comparing the build output with and without this setting, and there is no difference (other than the obfuscated email address on the community page, which is non-deterministic and so changes with every build): ``` $ diff -r deploy/public-marked-main deploy/public diff -r deploy/public-marked-main/community/design-system-working-group/index.html deploy/public/community/design-system-working-group/index.html 1045c1045 < In the meantime, if you are interested in joining the working group email the Design System team at <a href="mailto:govuk-design-system-support@digital.cabinet-office.gov.uk">govuk-design-system-support@digital.cabinet-office.gov.uk</a>. --- > In the meantime, if you are interested in joining the working group email the Design System team at <a href="mailto:govuk-design-system-support@digital.cabinet-office.gov.uk">govuk-design-system-support@digital.cabinet-office.gov.uk</a>. ``` [1]: https://marked.js.org/using_advanced#options

* Remove ƒ typo in fieldset example * Fix autocomplete values in multiple address example * Add latest blog posts April 2022 * Fix dashes and punctuation * update image to make it neater on the check a service is suitable pattern page * update image to make it neater on the check a service is suitable pattern page and compress it to save space * Update Node to Active LTS version v16 (Gallium) Node.js v14 has been in maintenance mode from 19 October 2021. v16 is the active LTS version. This in turns updates NPM to v8, meaning our lockfile has change to [`lockfileVersion` 2](https://docs.npmjs.com/cli/v8/configuring-npm/package-lock-json#lockfileversion) This is an internal change that affects development, testing and deployment. * Add troubleshooting documentation for Node 16, node-sass and M1 machines If a user has previously installed locally using Node 14 and lower on their M1 machine, they will encounter `node-sass` errors when running `npm install` after pulling this commit. This adds documentation to deal with those errors. This should only affect developers. * Update metalsmith to latest version (2.4.2) * Install @metalsmith/sass * Uninstall metalsmith-sass and node-sass We've installed @metalsmith/sass which uses sass (Dart Sass) under the hood instead. * Set `quietDeps` to true and move config to @metalsmith/sass syntax Move the existing sass config to @metalsmith/sass syntax (uses loadPaths instead of includePaths) Set the `quietDeps` flag to true to suppress sass deprecation warnings for division (/) and any future deprecations coming from GOV.UK Frontend. * Add 'src/stylesheets' to sass loadPaths Dart Sass wasn't able to resolve the import for 'example-init', which we use within our component example sass. Telling it to look in 'src/stylesheets' to resolve imports, so it can find this file. * Remove node-sass on node v16 troubleshooting docs We've updated Metalsmith and moved to Dart Sass, so this issue no longer applies (see alphagov#2150) * Update link text in examples This aims to make the difference between the `class` and the link text clearer, particularly for people relatively new to HTML. * Add new team member * Make help text advice clearer in fieldset guidance * Add placeholder text info to text input guidance * Revert town or city field to use address-level2 * Explain issues with client side validation * Add implementation advice to skip link guidance * Add subheadings to text input guidance * Replace double quotes with singles in example * Updating error example for National Insurance number to use correct format * adding format guidance for National Insurance number * Update design-system-team.md.njk Added myself to the team member list * Update src/design-system-team.md.njk Co-authored-by: Kimberly Grey <kimberly.grey@digital.cabinet-office.gov.uk> * Update src/patterns/national-insurance-numbers/index.md.njk Co-authored-by: Calvin Lau <77630796+calvin-lau-sig7@users.noreply.github.com> * Move #top anchor to before the skip link The ‘back to top’ link takes users to the #top anchor point, which is currently before the navigation but after the ‘skip to main content’ link. This means you can no longer skip past the navs etc (as per WCAG 2.1 2.4.1 Bypass Blocks [1]) unless you know to press shift + tab to go backwards in the tab order. Insetead, we want the 'back to top' link to take the user to the very top of the page, so that the next tab will take them to ‘Skip to main content’ (or the cookie banner, if it’s not been dismissed). We also considered taking the user to the start of `#main` [2], bypassing all of the navigation, but opted instead to move the `#top` anchor to be the very first thing because: 1. The back to top link was introduced in alphagov#687, when we moved from the side navigation and the main content being fixed, independently scrollable panes. This change meant that the side navigation no longer remained within the viewport. It seems that the intent at the time was that the back to top link would bring the side navigation back into view, rather than providing a convenient way for the user to get back to the top of the main content. 2. Linking to #main makes it harder for users who have to get back to the navigation: > If you're using a screen reader you could jump between landmarks using hot keys, but if you're just using a keyboard you're kinda just left with the tab key. Maybe I'm missing something, but the only options I could see to get back to the nav would be: > > - use TAB to go all the way through the content and footer content until you eventually get back to the top of the page > - use back to top to get to the top of the main, and then use SHIFT+TAB to reverse through the nav menu > - refresh the page and use TAB 3. We think users would expect to see the header when using the ‘Back to top’ link, especially if they were aiming for the navigation. [1]: https://www.w3.org/TR/WCAG21/#bypass-blocks [2]: alphagov#1561 (comment) Closes alphagov#1561 * Make layout name consistent throughout guidance * Update guidance on footer component This proposed update: - adds links to relevant information on privacy notices, cookie pages and accessibility statements - clarifies copyright and licensing information Related issues: alphagov#1225 alphagov#1306 * Update character count guidance to match new implementation * Minor edits for consistency * Clarify and add accessibility information * Update What's New section for v4.1.0 * Update roadmap * Add context to JAWS issue * Bump govuk-frontend to 4.1.0 * Add nodeListForEach helper directly into design system The GOV.UK Frontend ES modules don't make the common (e.g: `nodeListForEach`) function available to import. We've made this decision intentionally as we never really intended for `nodeListForEach` to be something we provided. This introduces a helper.js file which contains `nodeListForEach`. Switch our JS files to use that helper, rather than the one from GOV.UK Frontend. * Replace individual JS imports with ES modules initAll * Explain that red border depends on exceeding limit * Add accurate content for email field char limit * Replace in guidance and examples - error message - textarea - text input - character count (including error example) * Bump actions/setup-node from v2 to v3 * Use node-version-file input to specify node version actions/setup-node v2.5.0 and above support reading a .nvmrc file itself [[1]]. This lets us simplify our code. [1]: https://github.com/actions/setup-node/releases/tag/v2.5.0 * Make validation guidance language more consistent * Add info on default components in page template * Change contact panel headings to reflect the kind of page they're on * Make link text in example reflect guidance * Reorder link text * Update team page on Design System site * Update cookie hide button to be more descriptive Change cookie button text from 'Hide this message' to 'Hide cookie message' to provide context to any users using assistive tech navigating out of context. * Add Claire to team page * Fix em-dash * Remove last line about performance platform Remove last line on the Payment Card details page, which refers to the performance platform. This platform no longer exists. * add a hint to the select to help users understand the options * Bump govuk-frontend to v4.2.0 * Add guidance for pagination component Iterate content and add headings for examples Fix typo for heading level Fix headings Add guidance for pagination component Iterate content and add headings for examples Fix typo for heading level Fix headings Apply suggestions from tech writer review Co-authored-by: EoinShaughnessy <72507742+EoinShaughnessy@users.noreply.github.com> Update pagination guidance Updated guidance to: - cover issues raised by working group - clarify use case for different types of pagination - and when to use 'continue' button and back link instead Minor edits for dashes and contractions Tweaking paragraph breaks Remove section about saying "page" in labels By default, "Previous" and "next" do not include "page" so this section is no longer needed * Remove pagination component from community backlog * Update what's new and roadmap for 4.2.0 * Update roadmap Tidying up and reorganising some of our roadmap items in mid-2022. * Fixed typo on pagination documentation * Add paragraph tag to link example This link example does not include a wrapping element, meaning that some of the text is appearing as default serif text instead of in Transport. As the text above this example states that it is regarding links at the end of sentences or paragraphs, the example shouldn't be negatively affected by the inclusion of a paragraph. * Indent Nunjucks code Attempt to make this file easier to read by indenting Nunjucks code similarly to HTML. * Refactor design system tabs JS * Fix tab not being opened when macro options are linked to * Update test ID and result checks * Check for existence of tabs * Update team member Add Ben to the team * Remove govuk-react-jsx which is no longer supported * Bump terser from 5.7.0 to 5.14.2 Bumps [terser](https://github.com/terser/terser) from 5.7.0 to 5.14.2. - [Release notes](https://github.com/terser/terser/releases) - [Changelog](https://github.com/terser/terser/blob/master/CHANGELOG.md) - [Commits](https://github.com/terser/terser/commits) --- updated-dependencies: - dependency-name: terser dependency-type: indirect ... Signed-off-by: dependabot[bot] <support@github.com> * Bump moment from 2.29.2 to 2.29.4 Bumps [moment](https://github.com/moment/moment) from 2.29.2 to 2.29.4. - [Release notes](https://github.com/moment/moment/releases) - [Changelog](https://github.com/moment/moment/blob/develop/CHANGELOG.md) - [Commits](moment/moment@2.29.2...2.29.4) --- updated-dependencies: - dependency-name: moment dependency-type: indirect ... Signed-off-by: dependabot[bot] <support@github.com> * Apply `this` binding changes from code review Co-authored-by: Oliver Byford <oliver.byford@digital.cabinet-office.gov.uk> * Refactor getDesktopTab to not use a loop * Bump metalsmith to 2.5.0 * Remove ‘mainstream’ from images guidance Instead, define non-service content by content type and publishing method. As flagged in alphagov/govuk-design-system-backlog#70 (comment): > Mainstream is 2500 pages managed by GDS, but this guidance also applies to all content on www.gov.uk produced by depts, the half a million 'whitehall' pages. Co-authored-by: Calvin Lau <77630796+calvin-lau-sig7@users.noreply.github.com> * Use the official core metalsmith postcss plugin Metalsmith is being updated fairly regularly now, and have an [official PostCSS plugin](https://github.com/metalsmith/postcss). We've been blocked on bumping some dependencies because of this (alphagov#2016). I've run `npm build` and there is one small prefixing change in the resulting CSS, but otherwise it's exactly the same. * Only toggle details aria attributes if already set I believe this dates from when the polyfill for the `<details>` element used to be applied in all browsers, and added extra ARIA attributes which always needed to be kept in sync when this script toggled the open state. However, since GOV.UK Frontend v3.1.0 the polyfill now does nothing in browsers that natively support the <details> elements [1]. This means that once these attributes are set on page load, unless the polyfill is running there is nothing to keep them in sync if the user toggles the details element: - `aria-expanded` will always be `true`, potentially causing AT to announce the expanded state incorrectly - `aria-hidden` will always be `false` – although this is likely not an issue as aria-hidden can't make things hidden using display:none 're-appear' in the accessibility tree Instead, only toggle `aria-expanded` if it is already set on the element (which should only happen if the polyfill has run, in which case the browser does not natively support the `<details>` element). We also need to re-introduce the `aria-hidden` attribute removed in 8b53583 as when the polyfill runs it currently adds an `aria-hidden` attribute which means the content inside the `<details>` element will be inaccessible even when opened unless we remove it. Add a comment to try and explain why this code needs to exist. [1]: alphagov/govuk-frontend#1523 * Bump metalsmith-env to 2.2.0 - Allow storing the environment variables under a metadata[metadatakey] instead of metadata. See opts.metadatakey for more details. - Dependency updates * Use @metalsmith/in-place in favour of metalsmith-in-place Core metalsmith plugin is effectively an updated version of the previous package. v4.5.0 - feat: org migration, core plugin alignment - feat: use metalsmith.match instead of multimatch, drop Node < 10 support - feat: better jsdoc typehints & defaults mgmt - fix: don't mistake dots in folder paths for extensions * Use @metalsmith/layouts in favour of metalsmith-layouts The core plugin replaces the old one. v2.5.1 - pass the transformed list of files to metalsmith.match… - Merge pull request alphagov#184 from doteco/master - pass the transformed list of files to metalsmith.match so that renamed files can be matched v2.5.0 - use metalsmith.match instead of multimatch - Remove semicolons, run formatting. Remove devDependencies - feat: add JSdocs, named plugin function - Dependencies: updates debug to 4.3.4 - Drop Node < 12 support 2.4.0 - Return when done - Improve readme - Align dotfiles, repo with core plugin setup @metalsmith - deps: update dependencies and fix prefer-object-spread * Use @metalsmith/permalinks in favour of metalsmith-permalinks Core plugin replaces old package. Changelog: https://github.com/metalsmith/permalinks/blob/master/CHANGELOG.md * Bump metalsmith-uglify to v2.4.1 Patch bump to update some dependencies. * Bump @metalsmith/sass from 1.0.0 to 1.0.1 Changes: metalsmith/sass@1.0.0...1.0.1 * Adjust link text to GOV.UK image guidance * Allow start buttons to be forms Although unusual, there are a few valid circumstances where you might want to submit a form when pressing the start button. A situation that came up recently was we wanted to record analytics on when a user started a service by recording the time that a user presses the start button, without client-side JavaScript. The implementation for this involved using the Rails `button_to` helper which generates a form which POSTs to a route and includes a single `submit` button. I think this is a valid use case of the start button, so I suggest changing the wording on this to be slightly more open to the idea of the start button not being a link. * Update link to task list Sass file This file has changed location in recent changes to the Prototype Kit, this updates the URL to no longer 404. * Override auto-linking with period character * Move width override classes from spacing to layout Overriding the width of an element really has nothing to do with spacing, so this guidance make more sense as part of the layout guidance, alongside the documentation about the grid system which uses the same ‘one third’, ‘one half’ concepts. * Tweak width override guidance for new context Remove the link to the grid system which is now on the same page and is introduced before the override classes Remove a reference to the spacing override classes which doesn’t make sense now that they’re on a separate page and the user might not have read about them already. * Update links to width override classes * Remove link to archived ethnic groups pattern The ethnic groups pattern was archived in alphagov#1582. * Remove broken link in page template guidance The ‘variables’ and ‘blocks’ tables were merged in alphagov#1311 but this link was missed. * Remove redundant classes As noted in alphagov/govuk-frontend#2733, these classes don’t actually do anything. * Remove extra closing `</tr>` tag * Swap small and large screen sizes in spacing table Putting the smaller sizes on the left-hand size seems more logical and fits better with a mobile-first approach. * Flip order of spacing scale in table Going from the smallest size to the largest size just makes more sense. * Fix mismatched heading tags in navigation * Document the static spacing scale Fixes alphagov#1210. * Improve headings for override classes and helpers * Move section on overrides last Try to encourage users who are writing their own CSS to use the helpers that we provide rather than the override classes, by making it more likely they’ll read about them first. * Update link to my talk for more accessible blog Allows more options to access it as I've made it into a blog post too. * Tweaks to guidance on helpers * Tweaks to guidance on override classes * Bump autoprefixer to 10.4.7 One major version bump. Version 10: - Uses PostCSS 8 - Removes support for Node.js 6, 8 and 11 - PostCSS is now a peerDependency None of which affects our installation. * Replace sass-lint with stylelint * Add basic stylelint config The resulting CSS appears to be the same after running `npm run build`. * Fix SCSS linting errors * Update documentation * Replace metalsmith-tagcleaner with a custom marked renderer * Bump marked and jstransformer packages Makes sense to bump these as part of this work, since they're being used under the hood to transform our files. jstransformer-nunjucks Changelog: https://github.com/jstransformers/jstransformer-nunjucks/blob/master/CHANGELOG.md - The major version bump simply adds the option to use custom Nunjucks loaders jstransformer-marked Changelog: https://github.com/jstransformers/jstransformer-marked/blob/master/HISTORY.md * Apply suggestions from code review Co-authored-by: Calvin Lau <77630796+calvin-lau-sig7@users.noreply.github.com> * Update logo in header to match GOV.UK Frontend Mirror the changes that have been made to the Header component in GOV.UK Frontend [1] including: - using conditional comments for header fallback PNG rather than an `<image` element [2] - camel-casing the SVG attributes [3] Fixes alphagov#2280. [1]: https://github.com/alphagov/govuk-frontend/blob/aceb8d9798d8d2fc28357f1dda62d1a5e4a2eb98/src/govuk/components/header/template.njk [2]: alphagov/govuk-frontend#2229 [3]: alphagov/govuk-frontend#1838 * Document static spacing override classes Static spacing override classes are being introduced to GOV.UK Frontend (alphagov/govuk-frontend#2672). Document the new classes so that users know how they work, and how they compare to the existing responsive spacing override classes. * Change to more up to date link GSS appear to have moved to a new site - the link was pointing at the old (and out of date) archived standard. * Remove examples for archived ethnic groups pattern The ‘Ask users for ethnic groups’ pattern was archived in alphagov#1582 [1] (dd77104) when the guidance was moved into the ‘Ask users for equality information’ pattern. New examples were created for the equality information pattern, but the existing examples and the SVG included in the guidance were not removed from the repo. Remove the examples and the SVG previously included in the archived ethnic groups pattern. [1]: alphagov#1582 * Use subclass for marked renderer This better matches how things are done in Marked, and allows us to user `super` for cases other than images. Co-authored-by: Oliver Byford <oliver.byford@digital.cabinet-office.gov.uk> * Fix markdown lists on pagination component page When there's no empty line before the list the Markdown renderer is treating it like it's part of the preceding paragraph. * Revert "Replace metalsmith-tagcleaner with a custom marked renderer" * Update src/patterns/equality-information/index.md.njk Co-authored-by: Calvin Lau <77630796+calvin-lau-sig7@users.noreply.github.com> * Fix matchMedia event listener in IE / Safari < 14 IE 10/11 and Safari >= 5.1 < 14 support `window.matchMedia` but do not support `MediaQueryList.addEventListener`. Instead we have to use the non-standard (and deprecated) `MediaQueryList.addListener`, which only takes one argument which is the callback function to run when the media query status changes [1]. Test for the presence of the `MediaQueryList.addEventListener` method and then use whichever method is appropriate for the browser. [1]: https://developer.mozilla.org/en-US/docs/Web/API/MediaQueryList/addListener Co-authored-by: Owen Jones <64783893+owenatgov@users.noreply.github.com> * Enable aliases for section headings * Alias section break as hr * Update What's New for v4.3.0 * Update govuk-frontend to 4.3.0 * Document `opengraphImageUrl` page template option Document the new `opengraphImageUrl` page template option, added in alphagov/govuk-frontend#2673. Update the documentation for the `assetUrl` option to make it slightly more generic and remove the recommendation to override by adding another meta tag to the `head` block as users should use the new `opengraphImageUrl` instead. * Retry failed tests The "see no evil, hear no evil" approach. This does not address the flaky tests themselves, but sets `jest.retryTimes` to 3, rerunning failed tests and greatly increasing the likelihood of a CI test task passing. This is speedier (and more automatic) than rerunning a full CI task again, so might be enough if the flakiness isn't easily addressable. * Fix linting issues * Update team members list * Reference cookie banner in updating guidance We now have a cookie banner component, so we should link to it from this guide. * Add ‘measuring the value’ talk to community page * Update what's new with DSDay blog post Tweak line breaks to look better Add full stop * Update date Co-authored-by: NoraGDS <57447099+NoraGDS@users.noreply.github.com> * Shorten call-to-action * Update what's new for v4.3.1 * Update to GOV.UK Frontend v4.3.1 * Add in link and download to Mural file Interaction Designer, Clare Brown (clare.brown@digital.hmrc.gov.uk) has created an editable Mural template of GOV.UK Design System Flow Diagram for all designers to use. This will help designers map out their service and/or user journeys at a high-level. The template is based off designs that were created in Miro and hosted on GitHub which can be found here: https://github.com/paulmsmith/govuk-designsystem-flow-diagram-miro. File needs to be hosted for download, uploaded and have instructions on how people can use the file. * Remove unused tables option The `tables` option was removed in Marked v0.7.0 [1] so this doesn’t do anything any more. [1]: https://github.com/markedjs/marked/releases/tag/v0.7.0 * Remove unused gfm: true from marked config The documentation for the `pedantic` option [1] says: > If true, conform to the original markdown.pl as much as possible. Don't fix original markdown bugs or behavior. Turns off and overrides gfm. Verified that this option is doing nothing by comparing the build output with and without this setting, and there is no difference (other than the obfuscated email address on the community page, which is non-deterministic and so changes with every build): ``` $ diff -r deploy/public-marked-main deploy/public diff -r deploy/public-marked-main/community/design-system-working-group/index.html deploy/public/community/design-system-working-group/index.html 1045c1045 < In the meantime, if you are interested in joining the working group email the Design System team at <a href="mailto:g&alphagov#111;v&alphagov#117;k-de&alphagov#115;&alphagov#105;g&alphagov#110;-&alphagov#115;y&alphagov#115;&alphagov#116;em-&alphagov#115;uppo&alphagov#114;t@dig&alphagov#105;&alphagov#116;al.cab&alphagov#105;&alphagov#110;et-off&alphagov#105;ce.gov.&alphagov#117;k">g&alphagov#111;v&alphagov#117;k-de&alphagov#115;&alphagov#105;g&alphagov#110;-&alphagov#115;y&alphagov#115;&alphagov#116;em-&alphagov#115;uppo&alphagov#114;t@dig&alphagov#105;&alphagov#116;al.cab&alphagov#105;&alphagov#110;et-off&alphagov#105;ce.gov.&alphagov#117;k</a>. --- > In the meantime, if you are interested in joining the working group email the Design System team at <a href="mailto:g&alphagov#111;&alphagov#118;&alphagov#117;k-des&alphagov#105;gn-&alphagov#115;ys&alphagov#116;e&alphagov#109;-&alphagov#115;u&alphagov#112;&alphagov#112;o&alphagov#114;&alphagov#116;@d&alphagov#105;g&alphagov#105;&alphagov#116;al.cabi&alphagov#110;e&alphagov#116;-office.g&alphagov#111;&alphagov#118;.&alphagov#117;&alphagov#107;">g&alphagov#111;&alphagov#118;&alphagov#117;k-des&alphagov#105;gn-&alphagov#115;ys&alphagov#116;e&alphagov#109;-&alphagov#115;u&alphagov#112;&alphagov#112;o&alphagov#114;&alphagov#116;@d&alphagov#105;g&alphagov#105;&alphagov#116;al.cabi&alphagov#110;e&alphagov#116;-office.g&alphagov#111;&alphagov#118;.&alphagov#117;&alphagov#107;</a>. ``` [1]: https://marked.js.org/using_advanced#options * Add border to 'preview' / 'archive' banner We moved the banner when refactoring the nav in 2b6a27b. Now that the banner is not between the header and the navigation, it makes sense to add the bottom border back to separate the banner from the page content. Keep the `--no-border` modifier which we use on the homepage when the banner is followed immediately by the masthead. * Remove redundant app-pane wrapper When the Design System had an independently scrollable nav and body regions, we used a 'app-pane' flexbox wrapper around the whole site so that the header could be fixed in place above both scrollable regions. When we simplified the layout and lost the indepedantly scrollable regions we didn't tidy up the wrapper, which isn't really doing anything any more (other than the flex layout causing weird issues like the banner width issue seen in 6c83fde). Remove the unneccesary wrapper and its classes. * Remove custom phase banner styles The `width: 100%` is no longer needed that we're not in a flex context and can be removed. As it turns out, the margins are being overridden by the `app-width-container` class anyway – and if they weren't being overriden, they'd mean that the phase banner would be flush up against the viewport edges on mobile, which isn't what we want. * Remove redundant app-pane__content wrappers The `app-pane__content` class isn't doing anything useful in these layouts and can be removed. * Split 'category nav' out from app pane CSS This doesn't really have anything to do with the rest of the 'split pane' CSS, so split it out into its own 'component'. Whilst we're at it, give it a better name and some context to help explain what it's for and why we need it. * Rename app-pane classes * Fix implementation for non-flexbox browsers * Rename 'pane' to 'split-pane' * Remove unused CSS * Stop recommending pattern=[0-9]* on number inputs We previously recommended using `pattern="[0-9]*"` on number inputs to prompt iOS to display the numeric keypad. This has been unnecessary since Safari 12.2, when support for the standardised `inputmode` attribute was added to Safari. We stopped using the `pattern` attribute on the date input component [1] in v4.1.0 (released in May 2022) as the proportion of GOV.UK visitors using versions of iOS 12.x and below had fallen to 0.08% of total traffic. [1]: alphagov/govuk-frontend#2599 Co-authored-by: Calvin Lau <77630796+calvin-lau-sig7@users.noreply.github.com> * Remove pattern attribute from examples See previous commit for details. * Remove use of govuk-exports We need to use govuk-exports in GOV.UK Frontend as files can be imported multiple files but we only ever want the CSS to be outputted once. As we're in control of how and where Sass in the Design System is imported, we don't need to worry about this and don't need to use the exports function. * Remove Sass and class that don't do anything * Fix more Sass that doesn't do anything The govuk-visually-hidden has `position: absolute` marked as `!important` and therefore it overrides this, so it can't be doing anything. * Remove unused app-phase-banner class * Update package-lock.json * Remove new GOV.UK pages Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: christopherthomasdesign <chris.ballantinethomas@digital.cabinet-office.gov.uk> Co-authored-by: Calvin Lau <77630796+calvin-lau-sig7@users.noreply.github.com> Co-authored-by: Ciandelle Scollan <ciandelle.scollan@digital.cabinet-office.gov.uk> Co-authored-by: Ciandelle Scollan <100923629+Ciandelle@users.noreply.github.com> Co-authored-by: domoscargin <brett.kyle@digital.cabinet-office.gov.uk> Co-authored-by: Vanita Barrett <vanita.barrett@digital.cabinet-office.gov.uk> Co-authored-by: Frankie Roberto <frankie@frankieroberto.com> Co-authored-by: ameliaphil <104211564+ameliaphil@users.noreply.github.com> Co-authored-by: EoinShaughnessy <eoin.shaughnessy@digital.cabinet-office.gov.uk> Co-authored-by: EoinShaughnessy <72507742+EoinShaughnessy@users.noreply.github.com> Co-authored-by: Colin Oakley <colin.oakley@engineering.digital.dwp.gov.uk> Co-authored-by: Ruth Hammond <91464546+ruthhammond@users.noreply.github.com> Co-authored-by: Kimberly Grey <kimberly.grey@digital.cabinet-office.gov.uk> Co-authored-by: Colin <colin@htmlandbacon.com> Co-authored-by: Oliver Byford <oliver.byford@digital.cabinet-office.gov.uk> Co-authored-by: StephenGill <stephen.gill@digital.cabinet-office.gov.uk> Co-authored-by: Laurence de Bruxelles <laurence.debruxelles@digital.cabinet-office.gov.uk> Co-authored-by: CAAshworth <claire.ashworth@digital.cabinet-office.gov.uk> Co-authored-by: owenatgov <owen.jones@digital.cabinet-office.gov.uk> Co-authored-by: Robert Deniszczyc <72561986+robertdeniszczyc2@users.noreply.github.com> Co-authored-by: NoraGDS <57447099+NoraGDS@users.noreply.github.com> Co-authored-by: Andy Mantell <134642+andymantell@users.noreply.github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Thomas Leese <thomas@leese.io> Co-authored-by: Nick Colley <2445413+nickcolley@users.noreply.github.com> Co-authored-by: Ed Horsford <mail@edwardhorsford.com> Co-authored-by: Peter Yates <peter.yates@graphia.co.uk> Co-authored-by: Owen Jones <64783893+owenatgov@users.noreply.github.com> Co-authored-by: Nick Colley <nick.colley@hippodigital.co.uk> Co-authored-by: Clare Brown <107033520+clare-brown@users.noreply.github.com>

alex-ju requested a review from dashouse January 8, 2018 14:15

alex-ju force-pushed the update-examples-component branch from e10ebcf to e8ac953 Compare January 9, 2018 11:25

hannalaakso reviewed Jan 9, 2018

View reviewed changes

alex-ju force-pushed the update-examples-component branch from e8ac953 to 864ec37 Compare January 10, 2018 09:26

Update tabs on examples

864ec37

Makes use of the app-c-example-wrapper and allows an example to be used with/without the tabs opened on the same page

joelanman reviewed Jan 10, 2018

View reviewed changes

alex-ju force-pushed the update-examples-component branch from 00d9bf1 to b6baa48 Compare January 10, 2018 15:27

NickColley reviewed Jan 10, 2018

View reviewed changes

alex-ju force-pushed the update-examples-component branch 3 times, most recently from 40b8883 to f017592 Compare January 10, 2018 17:18

Refactor tabs.js to use 'js-' prefixes for DOM manipulation

f017592

NickColley approved these changes Jan 10, 2018

View reviewed changes

NickColley reviewed Jan 10, 2018

View reviewed changes

alex-ju merged commit e5c1d24 into master Jan 10, 2018

alex-ju deleted the update-examples-component branch January 10, 2018 18:25

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Update tabs on examples component #111

Update tabs on examples component #111

alex-ju commented Jan 8, 2018 •

edited by NickColley

Loading

hannalaakso left a comment

hannalaakso Jan 9, 2018

joelanman Jan 9, 2018

hannalaakso Jan 9, 2018

hannalaakso Jan 9, 2018

joelanman Jan 9, 2018

hannalaakso Jan 9, 2018 •

edited

Loading

hannalaakso Jan 9, 2018

hannalaakso Jan 9, 2018

alex-ju commented Jan 10, 2018

joelanman Jan 10, 2018 •

edited

Loading

alex-ju Jan 10, 2018 •

edited

Loading

joelanman Jan 10, 2018 •

edited

Loading

alex-ju Jan 10, 2018

alex-ju Jan 10, 2018

NickColley Jan 10, 2018

alex-ju Jan 10, 2018

alex-ju Jan 10, 2018

alex-ju commented Jan 10, 2018

NickColley Jan 10, 2018

NickColley commented Jan 10, 2018

alex-ju commented Jan 10, 2018

Update tabs on examples component #111

Update tabs on examples component #111

Conversation

alex-ju commented Jan 8, 2018 • edited by NickColley Loading

hannalaakso left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

hannalaakso Jan 9, 2018 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

alex-ju commented Jan 10, 2018

joelanman Jan 10, 2018 • edited Loading

Choose a reason for hiding this comment

alex-ju Jan 10, 2018 • edited Loading

Choose a reason for hiding this comment

joelanman Jan 10, 2018 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

alex-ju commented Jan 10, 2018

Choose a reason for hiding this comment

NickColley commented Jan 10, 2018

alex-ju commented Jan 10, 2018

alex-ju commented Jan 8, 2018 •

edited by NickColley

Loading

hannalaakso Jan 9, 2018 •

edited

Loading

joelanman Jan 10, 2018 •

edited

Loading

alex-ju Jan 10, 2018 •

edited

Loading

joelanman Jan 10, 2018 •

edited

Loading