name: Form fieldset
description: The fieldset element is used to group several controls within a web form. The legend element represents a caption for the content of its parent fieldset.
body: |
  [Using the fieldset and legend elements](https://accessibility.blog.gov.uk/2016/07/22/using-the-fieldset-and-legend-elements/)

  You can use the `text` property or pass `text` as a block.
accessibility_criteria: |
  - must give inputs within the fieldset context with legend text
examples:
  default:
    data:
      legend_text: 'Do you have a passport?'
      block: |
        <!-- Use the radio component, this is hardcoded only for this example -->
          <input type="radio" id="default-yes" name="default">
          <label for="default-yes">Yes</label>

          <input type="radio" id="default-no" name="default">
          <label for="default-no">No</label>
  with_id_attribute:
    data:
      legend_text: 'Do you have a passport?'
      id: passports
      block: |
        <!-- Use the radio component, this is hardcoded only for this example -->
          <input type="radio" id="passport-yes" name="default">
          <label for="passport-yes">Yes</label>

          <input type="radio" id="passport-no" name="default">
          <label for="passport-no">No</label>
  with_heading:
    description: Make the legend different sizes. Valid options are `s`, `m`, `l` and `xl`.
    data:
      legend_text: 'Do you have a driving license?'
      heading_level: 2
      heading_size: 'm'
      block: |
        <!-- Use the radio component, this is hardcoded only for this example -->
          <input type="radio" id="level-yes" name="default">
          <label for="level-yes">Yes</label>

          <input type="radio" id="level-no" name="default">
          <label for="level-no">No</label>
  with_custom_legend_size:
    description: Make the legend different sizes. Valid options are `s`, `m`, `l` and `xl`.
    data:
      legend_text: 'Do you have a driving license?'
      heading_size: 'l'
      block: |
        <!-- Use the radio component, this is hardcoded only for this example -->
          <input type="radio" id="size-yes" name="default">
          <label for="size-yes">Yes</label>

          <input type="radio" id="size-no" name="default">
          <label for="size-no">No</label>
  with_error_message:
    description: The component also accepts an `error_id`, or generates one automatically.
    data:
      legend_text: 'Do you have a passport?'
      error_message: 'Please choose an option'
      block: |
        <!-- Use the radio component, this is hardcoded only for this example -->
          <input type="radio" id="default2-yes" name="default2">
          <label for="default2-yes">Yes</label>

          <input type="radio" id="default2-no" name="default2">
          <label for="default2-no">No</label>