USWDS - File input: Evaluate sample label copy

[amyleadem]

Summary

In the file input component examples, the demo label text should be a helpful example that can be used in the real world. However, the sample label text in our component demos do not provide particularly helpful information about the related input. For example, the default file input example has a label of "Input accepts a single file". We should evaluate if there is an opportunity to improve this text and provide more helpful real-world examples.

Expected behavior

Input label elements should describe the purpose of the related input. Additionally, the label can also provide instructions to the user about how to enter information into the input (example: date format type)

[bonnieAcameron]

After taking a closer look at this, the texts that say "Input accepts a single file," "Input accepts only specific file types," (and other similar directives on the page) are not actually functioning as labels for the related input. They function as sub-headings within the Component Preview section.

Proposed solutions:

1. Add "about file input" section similar to what we just drafted in In page navigation where we delve a little deeper into the functionality, limitations, and customization possibilities regarding file types.
   2a. Consider changing the styling of what are now inaccurately coded as "label" to something like an h2 so that the user better understands that these labels are not part of the component itself.
   --OR--
   2b. Break out the component previews into separate pieces instead of all in one preview box

I realize this is a bit of a rogue insight @amyleadem , so let's discuss!

[bonnieAcameron]

I'll schedule time with you @amyleadem so we can chat about this.

[bonnieAcameron]

we decided to go with the H2 solution

[bonnieAcameron]

Approach has been decided. The work is being completed here:

• USWDS - Remove H3 text from component metadata #5519 (uswds)
• USWDS-site - [File input] - Updating page to make clear what is a variant of component vs. part of component uswds-site#2213 (uswds-site)
  Safe to close this as a spike