breadcrumb.html 6.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220
  1. ---
  2. title: Breadcrumb
  3. subtitle: "A simple <strong>breadcrumb</strong> component to improve your navigation experience"
  4. layout: documentation
  5. doc-tab: components
  6. doc-subtab: breadcrumb
  7. breadcrumb:
  8. - home
  9. - documentation
  10. - components
  11. - components-breadcrumb
  12. meta:
  13. variables: true
  14. colors: false
  15. sizes: true
  16. ---
  17. {% capture breadcrumb_example %}
  18. <nav class="breadcrumb" aria-label="breadcrumbs">
  19. <ul>
  20. <li><a href="#">Bulma</a></li>
  21. <li><a href="#">Documentation</a></li>
  22. <li><a href="#">Components</a></li>
  23. <li class="is-active"><a href="#" aria-current="page">Breadcrumb</a></li>
  24. </ul>
  25. </nav>
  26. {% endcapture %}
  27. {% capture breadcrumb_centered_example %}
  28. <nav class="breadcrumb is-centered" aria-label="breadcrumbs">
  29. <ul>
  30. <li><a href="#">Bulma</a></li>
  31. <li><a href="#">Documentation</a></li>
  32. <li><a href="#">Components</a></li>
  33. <li class="is-active"><a href="#" aria-current="page">Breadcrumb</a></li>
  34. </ul>
  35. </nav>
  36. {% endcapture %}
  37. {% capture breadcrumb_right_example %}
  38. <nav class="breadcrumb is-right" aria-label="breadcrumbs">
  39. <ul>
  40. <li><a href="#">Bulma</a></li>
  41. <li><a href="#">Documentation</a></li>
  42. <li><a href="#">Components</a></li>
  43. <li class="is-active"><a href="#" aria-current="page">Breadcrumb</a></li>
  44. </ul>
  45. </nav>
  46. {% endcapture %}
  47. {% capture breadcrumb_icons_example %}
  48. <nav class="breadcrumb" aria-label="breadcrumbs">
  49. <ul>
  50. <li>
  51. <a href="#">
  52. <span class="icon is-small">
  53. <i class="fas fa-home" aria-hidden="true"></i>
  54. </span>
  55. <span>Bulma</span>
  56. </a>
  57. </li>
  58. <li>
  59. <a href="#">
  60. <span class="icon is-small">
  61. <i class="fas fa-book" aria-hidden="true"></i>
  62. </span>
  63. <span>Documentation</span>
  64. </a>
  65. </li>
  66. <li>
  67. <a href="#">
  68. <span class="icon is-small">
  69. <i class="fas fa-puzzle-piece" aria-hidden="true"></i>
  70. </span>
  71. <span>Components</span>
  72. </a>
  73. </li>
  74. <li class="is-active">
  75. <a href="#">
  76. <span class="icon is-small">
  77. <i class="fas fa-thumbs-up" aria-hidden="true"></i>
  78. </span>
  79. <span>Breadcrumb</span>
  80. </a>
  81. </li>
  82. </ul>
  83. </nav>
  84. {% endcapture %}
  85. {% capture breadcrumb_small_example %}
  86. <nav class="breadcrumb is-small" aria-label="breadcrumbs">
  87. <ul>
  88. <li><a href="#">Bulma</a></li>
  89. <li><a href="#">Documentation</a></li>
  90. <li><a href="#">Components</a></li>
  91. <li class="is-active"><a href="#" aria-current="page">Breadcrumb</a></li>
  92. </ul>
  93. </nav>
  94. {% endcapture %}
  95. {% capture breadcrumb_medium_example %}
  96. <nav class="breadcrumb is-medium" aria-label="breadcrumbs">
  97. <ul>
  98. <li><a href="#">Bulma</a></li>
  99. <li><a href="#">Documentation</a></li>
  100. <li><a href="#">Components</a></li>
  101. <li class="is-active"><a href="#" aria-current="page">Breadcrumb</a></li>
  102. </ul>
  103. </nav>
  104. {% endcapture %}
  105. {% capture breadcrumb_large_example %}
  106. <nav class="breadcrumb is-large" aria-label="breadcrumbs">
  107. <ul>
  108. <li><a href="#">Bulma</a></li>
  109. <li><a href="#">Documentation</a></li>
  110. <li><a href="#">Components</a></li>
  111. <li class="is-active"><a href="#" aria-current="page">Breadcrumb</a></li>
  112. </ul>
  113. </nav>
  114. {% endcapture %}
  115. {% capture breadcrumb_arrow_example %}
  116. <nav class="breadcrumb has-arrow-separator" aria-label="breadcrumbs">
  117. <ul>
  118. <li><a href="#">Bulma</a></li>
  119. <li><a href="#">Documentation</a></li>
  120. <li><a href="#">Components</a></li>
  121. <li class="is-active"><a href="#" aria-current="page">Breadcrumb</a></li>
  122. </ul>
  123. </nav>
  124. {% endcapture %}
  125. {% capture breadcrumb_bullet_example %}
  126. <nav class="breadcrumb has-bullet-separator" aria-label="breadcrumbs">
  127. <ul>
  128. <li><a href="#">Bulma</a></li>
  129. <li><a href="#">Documentation</a></li>
  130. <li><a href="#">Components</a></li>
  131. <li class="is-active"><a href="#" aria-current="page">Breadcrumb</a></li>
  132. </ul>
  133. </nav>
  134. {% endcapture %}
  135. {% capture breadcrumb_dot_example %}
  136. <nav class="breadcrumb has-dot-separator" aria-label="breadcrumbs">
  137. <ul>
  138. <li><a href="#">Bulma</a></li>
  139. <li><a href="#">Documentation</a></li>
  140. <li><a href="#">Components</a></li>
  141. <li class="is-active"><a href="#" aria-current="page">Breadcrumb</a></li>
  142. </ul>
  143. </nav>
  144. {% endcapture %}
  145. {% capture breadcrumb_succeeds_example %}
  146. <nav class="breadcrumb has-succeeds-separator" aria-label="breadcrumbs">
  147. <ul>
  148. <li><a href="#">Bulma</a></li>
  149. <li><a href="#">Documentation</a></li>
  150. <li><a href="#">Components</a></li>
  151. <li class="is-active"><a href="#" aria-current="page">Breadcrumb</a></li>
  152. </ul>
  153. </nav>
  154. {% endcapture %}
  155. <div class="content">
  156. <p>The <strong>breadcrumb</strong> component only requires a <code>.breadcrumb</code> container and a <code>ul</code> list.</p>
  157. <p>The dividers are automatically created in the content of the <code>::before</code> pseudo-element of <code>li</code> tags.</p>
  158. <p>You can inform the current page using the <code>is-active</code> modifier in a <code>li</code> tag. It will disable the navigation of inner links.</p>
  159. </div>
  160. <hr>
  161. {% include snippet.html content=breadcrumb_example horizontal=true clipped=true %}
  162. {% include anchor.html name="Alignment" %}
  163. <div class="content">
  164. <p>For alternative alignments, use the <code>is-centered</code> and <code>is-right</code> modifiers on the <code>.breadcrumb</code> container.</p>
  165. </div>
  166. {% include snippet.html content=breadcrumb_centered_example horizontal=true clipped=true %}
  167. {% include snippet.html content=breadcrumb_right_example horizontal=true clipped=true %}
  168. {% include anchor.html name="Icons" %}
  169. <div class="content">
  170. <p>You can use any of the <a href="https://fontawesome.com/" target="_blank">Font Awesome</a> <strong>icons</strong>.</p>
  171. </div>
  172. {% include snippet.html content=breadcrumb_icons_example horizontal=true clipped=true %}
  173. {% include anchor.html name="Alternative separators" %}
  174. <div class="content">
  175. <p>You can choose between <strong>4 additional separators</strong>: <code>has-arrow-separator</code> <code>has-bullet-separator</code> <code>has-dot-separator</code> and <code>has-succeeds-separator</code>.</p>
  176. </div>
  177. {% include snippet.html content=breadcrumb_arrow_example horizontal=true clipped=true %}
  178. {% include snippet.html content=breadcrumb_bullet_example horizontal=true clipped=true %}
  179. {% include snippet.html content=breadcrumb_dot_example horizontal=true clipped=true %}
  180. {% include snippet.html content=breadcrumb_succeeds_example horizontal=true clipped=true %}
  181. {% include anchor.html name="Sizes" %}
  182. <div class="content">
  183. <p>You can choose between <strong>3 additional sizes</strong>: <code>is-small</code> <code>is-medium</code> and <code>is-large</code>.</p>
  184. </div>
  185. {% include snippet.html content=breadcrumb_small_example horizontal=true clipped=true %}
  186. {% include snippet.html content=breadcrumb_medium_example horizontal=true clipped=true %}
  187. {% include snippet.html content=breadcrumb_large_example horizontal=true clipped=true %}
  188. {% include variables.html type='component' %}