Sha256: a3236c41ad8e00304042739c6f855b688a5083283aa0c2027592069092c43cd5

Contents?: true

Size: 1.34 KB

Versions: 83

Compression:

Stored size: 1.34 KB

Contents

name: Contextual guidance
description: Provides a container with additional information when focusing an input field (e.g. input, textarea)
body: |
  This component is build to be used with an input field passed in as a block and must reference its ID using the `html_for` attribute.

  On tablet and desktop, the guidance container is set to float on the page and prevent other elements from moving around (e.g. pushing next fields down the page).
part_of_admin_layout: true
accessibility_criteria: |
  The component must:

  * be hidden by default
  * be visible when the associated input field if focused
  * stay visible until another input field with guidance is being focused
shared_accessibility_criteria:
  - link
examples:
  default:
    description: Reveals a contextual guidance on the side overflowing the container
    data:
      html_for: news-title
      title: Writing a news title
      guidance_id: news-title-guidance
      content: |
        <p>The title must make clear what the content offers users. Use the words your users do to help them find this. Avoid wordplay or teases.</p>
      block: |
        <div class="govuk-form-group">
          <label class="gem-c-label govuk-label" for="news-title">News title</label>
          <input id="news-title" type="text" class="gem-c-input govuk-input" aria-describedby="news-title-guidance">
        </div>

Version data entries

83 entries across 83 versions & 1 rubygems

Version Path
govuk_publishing_components-35.5.0 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-35.4.0 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-35.3.5 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-35.3.4 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-35.3.3 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-35.3.2 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-35.3.1 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-35.3.0 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-35.2.0 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-35.1.1 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-35.1.0 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-35.0.0 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-34.14.0 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-34.13.0 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-34.12.0 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-34.11.0 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-34.10.1 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-34.10.0 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-34.9.1 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-34.9.0 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml