feat(FormGroup): add slots

docs/components/content/examples/FormGroupErrorSlotExample.vue

@@ -0,0 +1,14 @@
+<template>
+  <UFormGroup label="Email" :error="!email && 'You must enter an email'" help="This is a nice email!">
+    <template #default="{ error }">
+      <UInput v-model="email" type="email" placeholder="Enter email" :trailing-icon="error ? 'i-heroicons-exclamation-triangle-20-solid' : undefined" />
+    </template>
+    <template #error="{ error }">
+      <UAlert icon="i-heroicons-exclamation-triangle-20-solid" :description="error" color="red" />
+    </template>
+  </UFormGroup>
+</template>
+
+<script setup lang="ts">
+const email = ref('')
+</script>

docs/content/3.forms/9.form-group.md

@@ -160,6 +160,116 @@ code: >-
   Learn more about form validation in the `Form` component.
 ::
 
+
+## Slots
+
+### `label`
+Use the `#label` slot to set the custom content for label.
+
+::component-card
+---
+slots:
+  label: <UAvatar src="https://avatars.githubusercontent.com/u/739984?v=4" size="3xs"  />  username
+  default: <UInput model-value="benjamincanac" placeholder="you@example.com" />
+---
+
+#label
+  :u-avatar{src="https://avatars.githubusercontent.com/u/739984?v=4" size="3xs" class="mr-2" }
+  username
+
+#default
+  :u-input{model-value="benjamincanac" placeholder="you@example.com"}
+::
+
+
+### `hint`
+Use the `#hint` slot to set the custom content for hint.
+
+::component-card
+---
+slots:
+  hint: <UIcon name="i-heroicons-arrow-right-20-solid" /> 
+  default: <UInput model-value="benjamincanac" placeholder="you@example.com" />
+props:
+  label: 'Step 1'
+---
+
+#hint
+  :u-icon{name="i-heroicons-arrow-right-20-solid"}
+
+#default
+  :u-input{model-value="benjamincanac" placeholder="you@example.com"}
+::
+
+
+Use the `#description` slot to set the custom content for description.
+
+::component-card
+---
+slots:
+  description: Write only valid email address <UIcon name="i-heroicons-arrow-right-20-solid" /> 
+  default: <UInput model-value="benjamincanac" placeholder="you@example.com" />
+props:
+  label: 'E-mail'
+---
+
+#description
+  Write only valid email address
+  :u-icon{name="i-heroicons-information-circle"}
+
+#default
+  :u-input{model-value="benjamincanac" placeholder="you@example.com"}
+::
+
+
+### `help`
+Use the `#help` slot to set the custom content for help.
+
+::component-card
+---
+slots:
+  help: Here are some examples <UIcon name="i-heroicons-arrow-right-20-solid" /> 
+  default: <UInput model-value="benjamincanac" placeholder="you@example.com" />
+props:
+  label: 'E-mail'
+---
+
+#help
+  Here are some examples
+  :u-icon{name="i-heroicons-information-circle"}
+
+#default
+  :u-input{model-value="benjamincanac" placeholder="you@example.com"}
+::
+
+
+### `error`
+Use the `#error` slot to set the custom content for error.
+
+::component-example
+#default
+:form-group-error-slot-example
+
+#code
+```vue
+<template>
+  <UFormGroup label="Email" :error="You must enter an email">
+    <template #default="{ error }">
+      <UInput v-model="email" type="email" placeholder="Enter email" />
+    </template>
+    <template #error="{ error }">
+      <UAlert icon="i-heroicons-exclamation-triangle-20-solid" :description="error" color="red" />
+    </template>
+  </UFormGroup>
+</template>
+
+<script setup lang="ts">
+const email = ref('')
+</script>
+
+```
+::
+
 ### Size
 
 Use the `size` prop to change the size of the label and the form element.

src/runtime/components/forms/FormGroup.vue

@@ -1,19 +1,37 @@
 <template>
   <div :class="ui.wrapper" v-bind="attrs">
-    <div v-if="label" :class="[ui.label.wrapper, size]">
-      <label :for="inputId" :class="[ui.label.base, required ? ui.label.required : '']">{{ label }}</label>
-      <span v-if="hint" :class="[ui.hint]">{{ hint }}</span>
+    <div v-if="label || $slots.label" :class="[ui.label.wrapper, size]">
+      <label :for="inputId" :class="[ui.label.base, required ? ui.label.required : '']">
+        <slot v-if="$slots.label" name="label" v-bind="{ error, label, name, hint, description, help }" />
+        <template v-else>{{ label }}</template>
+      </label>
+      <span v-if="hint || $slots.hint" :class="[ui.hint]">
+        <slot v-if="$slots.hint" name="hint" v-bind="{ error, label, name, hint, description, help }" />
+        <template v-else>{{ hint }}</template>
+      </span>
     </div>
-    <p v-if="description" :class="[ui.description, size]">
-      {{ description }}
+
+    <p v-if="description || $slots.description" :class="[ui.description, size]">
+      <slot v-if="$slots.description" name="description" v-bind="{ error, label, name, hint, description, help }" />
+      <template v-else>
+        {{ description }}
+      </template>
     </p>
+
     <div :class="[label ? ui.container : '']">
       <slot v-bind="{ error }" />
-      <p v-if="typeof error === 'string' && error" :class="[ui.error, size]">
-        {{ error }}
+
+      <p v-if="(typeof error === 'string' && error`) || $slots.error`" :class="[ui.error, size]">
+        <slot v-if="$slots.error" name="error" v-bind="{ error, label, name, hint, description, help }" />
+        <template v-else>
+          {{ error }}
+        </template>
       </p>
-      <p v-else-if="help" :class="[ui.help, size]">
-        {{ help }}
+      <p v-else-if="help || $slots.help" :class="[ui.help, size]">
+        <slot v-if="$slots.help" name="help" v-bind="{ error, label, name, hint, description, help }" />
+        <template v-else>
+          {{ help }}
+        </template>
       </p>
     </div>
   </div>