form-image-check.mdx 7.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213
  1. ---
  2. title: Image check
  3. summary: The image check is a great way to make your form more user-friendly and engaging. You can use the image check to create a visually appealing form that will help users make decisions quickly and easily.
  4. description: Add visual appeal to forms with images.
  5. ---
  6. ## Default markup
  7. To build an image check, you need to use the `.form-imagecheck` class and the `.form-imagecheck-input` class for the input element. You can also use the `.form-imagecheck-figure` class to display the custom checkbox and the `.form-imagecheck-image` class to style the image itself.
  8. ```html
  9. <label class="form-imagecheck">
  10. <input name="..." type="checkbox" value="" class="form-imagecheck-input" checked />
  11. <span class="form-imagecheck-figure">
  12. <img src="..." alt="" class="form-imagecheck-image" />
  13. </span>
  14. </label>
  15. ```
  16. Look at the examples below to see how the image check works:
  17. ```html example centered columns="2" height="15rem"
  18. <div class="mb-3">
  19. <label class="form-label">Image Check</label>
  20. <div class="row g-2">
  21. <div class="col-3">
  22. <label class="form-imagecheck">
  23. <input name="image" type="checkbox" value="1" class="form-imagecheck-input" />
  24. <span class="form-imagecheck-figure">
  25. <img
  26. src="/samples/photos/everything-you-need-to-work-from-your-bed-2.jpg"
  27. alt=""
  28. class="form-imagecheck-image"
  29. />
  30. </span>
  31. </label>
  32. </div>
  33. <div class="col-3">
  34. <label class="form-imagecheck">
  35. <input name="image" type="checkbox" value="2" class="form-imagecheck-input" checked />
  36. <span class="form-imagecheck-figure">
  37. <img
  38. src="/samples/photos/color-palette-guide-sample-colors-catalog-.jpg"
  39. alt=""
  40. class="form-imagecheck-image"
  41. />
  42. </span>
  43. </label>
  44. </div>
  45. <div class="col-3">
  46. <label class="form-imagecheck">
  47. <input name="image" type="checkbox" value="3" class="form-imagecheck-input" />
  48. <span class="form-imagecheck-figure">
  49. <img
  50. src="/samples/photos/woman-read-book-and-drink-coffee-2.jpg"
  51. alt=""
  52. class="form-imagecheck-image"
  53. />
  54. </span>
  55. </label>
  56. </div>
  57. <div class="col-3">
  58. <label class="form-imagecheck">
  59. <input name="image" type="checkbox" value="4" class="form-imagecheck-input" checked />
  60. <span class="form-imagecheck-figure">
  61. <img
  62. src="/samples/photos/stylish-workspace-with-macbook-pro-2.jpg"
  63. alt=""
  64. class="form-imagecheck-image"
  65. />
  66. </span>
  67. </label>
  68. </div>
  69. </div>
  70. </div>
  71. ```
  72. ## Radio buttons
  73. If you want to use the image check as a radio button, you can change the input type to `radio`.
  74. ```html example centered columns="2" height="15rem"
  75. <div class="mb-3">
  76. <label class="form-label">Image Check Radio</label>
  77. <div class="row g-2">
  78. <div class="col-3">
  79. <label class="form-imagecheck mb-2">
  80. <input name="image" type="radio" value="1" class="form-imagecheck-input" />
  81. <span class="form-imagecheck-figure">
  82. <img
  83. src="/samples/photos/woman-drinking-hot-tea-in-her-home-office.jpg"
  84. alt=""
  85. class="form-imagecheck-image"
  86. />
  87. </span>
  88. </label>
  89. </div>
  90. <div class="col-3">
  91. <label class="form-imagecheck mb-2">
  92. <input name="image" type="radio" value="2" class="form-imagecheck-input" checked />
  93. <span class="form-imagecheck-figure">
  94. <img
  95. src="/samples/photos/young-woman-sitting-on-the-sofa-and-working-on-her-laptop-3.jpg"
  96. alt=""
  97. class="form-imagecheck-image"
  98. />
  99. </span>
  100. </label>
  101. </div>
  102. <div class="col-3">
  103. <label class="form-imagecheck mb-2">
  104. <input name="image" type="radio" value="3" class="form-imagecheck-input" />
  105. <span class="form-imagecheck-figure">
  106. <img
  107. src="/samples/photos/beautiful-blonde-woman-relaxing-with-a-can-of-coke-on-a-tree-stump-by-the-beach.jpg"
  108. alt=""
  109. class="form-imagecheck-image"
  110. />
  111. </span>
  112. </label>
  113. </div>
  114. <div class="col-3">
  115. <label class="form-imagecheck mb-2">
  116. <input name="image" type="radio" value="4" class="form-imagecheck-input" checked />
  117. <span class="form-imagecheck-figure">
  118. <img src="/samples/photos/book-on-the-grass.jpg" alt="" class="form-imagecheck-image" />
  119. </span>
  120. </label>
  121. </div>
  122. </div>
  123. </div>
  124. ```
  125. ```html
  126. <label class="form-imagecheck">
  127. <input name="..." type="radio" value="1" class="form-imagecheck-input" />
  128. <span class="form-imagecheck-figure">
  129. <img src="..." alt="" class="form-imagecheck-image" />
  130. </span>
  131. </label>
  132. ```
  133. ## Avatars
  134. If you want to use the image check with avatars, you can use an [avatar component](/docs/ui/components/avatars) instead of an image.
  135. ```html example centered columns={2} height="15rem"
  136. <div class="mb-3">
  137. <label class="form-label">Person Check</label>
  138. <div class="row g-2">
  139. <div class="col-auto">
  140. <label class="form-imagecheck mb-2">
  141. <input name="image" type="checkbox" value="1" class="form-imagecheck-input" />
  142. <span class="form-imagecheck-figure">
  143. <span class="form-imagecheck-image">
  144. <span
  145. class="avatar avatar-xl"
  146. style="background-image: url(/samples/avatars/057f.jpg)"
  147. ></span>
  148. </span>
  149. </span>
  150. </label>
  151. </div>
  152. <div class="col-auto">
  153. <label class="form-imagecheck mb-2">
  154. <input name="image" type="checkbox" value="2" class="form-imagecheck-input" checked />
  155. <span class="form-imagecheck-figure">
  156. <span class="form-imagecheck-image">
  157. <span class="avatar avatar-xl">HS</span>
  158. </span>
  159. </span>
  160. </label>
  161. </div>
  162. <div class="col-auto">
  163. <label class="form-imagecheck mb-2">
  164. <input name="image" type="checkbox" value="3" class="form-imagecheck-input" />
  165. <span class="form-imagecheck-figure">
  166. <span class="form-imagecheck-image">
  167. <span
  168. class="avatar avatar-xl"
  169. style="background-image: url(/samples/avatars/062m.jpg)"
  170. ></span>
  171. </span>
  172. </span>
  173. </label>
  174. </div>
  175. <div class="col-auto">
  176. <label class="form-imagecheck mb-2">
  177. <input name="image" type="checkbox" value="4" class="form-imagecheck-input" checked />
  178. <span class="form-imagecheck-figure">
  179. <span class="form-imagecheck-image">
  180. <span
  181. class="avatar avatar-xl"
  182. style="background-image: url(/samples/avatars/070m.jpg)"
  183. ></span>
  184. </span>
  185. </span>
  186. </label>
  187. </div>
  188. </div>
  189. </div>
  190. ```
  191. ```html
  192. <label class="form-imagecheck">
  193. <input name="..." type="checkbox" value="..." class="form-imagecheck-input" />
  194. <span class="form-imagecheck-figure">
  195. <span class="form-imagecheck-image">
  196. <span class="avatar avatar-md" style="background-image: url(...)"></span>
  197. </span>
  198. </span>
  199. </label>
  200. ```