breadcrumb.html 6.9 KB

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