Sha256: edcefb09d7f69d1320d4e8775fba222fd67bdfb6d9f4a539a635799f2fc2f2be

Contents?: true

Size: 1.45 KB

Versions: 89

Compression:

Stored size: 1.45 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: |
        <!-- example content -->
          <%= render "govuk_publishing_components/components/input", { 
              label: {
                text: "News title"
              },
              name: "news-title",
              id: "news-title",
              describedby: "news-title-guidance"
            } 
          %>
          <!-- end of example content -->

Version data entries

89 entries across 89 versions & 1 rubygems

Version Path
govuk_publishing_components-43.5.0 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-43.4.1 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-43.4.0 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-43.3.0 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-43.2.0 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-43.1.1 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-43.1.0 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-43.0.2 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-43.0.1 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-43.0.0 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-42.1.0 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-42.0.0 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-41.1.2 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-41.1.1 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-41.1.0 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-41.0.0 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-40.1.0 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-40.0.0 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-39.2.5 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml
govuk_publishing_components-39.2.4 app/views/govuk_publishing_components/components/docs/contextual_guidance.yml