|
|
---layout : 'default'css : 'dropdown'
title : 'Dropdown'description : 'A dropdown is a hidden list of selections that a user can choose to have appear'type : 'UI Module'---
<script src="/javascript/dropdown.js"></script>
<%- @partial('header') %>
<div class="main container">
<div class="peek"> <div class="ui vertical pointing secondary menu"> <a class="active item">Usage</a> <a class="item">Types</a> <a class="item">Examples</a> <a class="item">Variations</a> <a class="item">States</a> <a class="item">Behavior</a> <a class="item">Settings</a> </div> </div>
<h2 class="ui dividing header">Usage</h2>
<h3 class="ui header">Initializing a dropdown</h3> <div class="code" data-type="javascript"> $('.ui.dropdown') .dropdown() ; </div> <div class="code" data-type="html"> <div class="ui dropdown"> <div class="text">Select</div> <i class="dropdown icon"></i> <div class="menu"> <div class="item" data-value="option1">Option 1</div> <div class="item" data-value="option2">Option 2</div> </div> </div> </div>
<h2 class="ui dividing header">Types</h2>
<div class="visible dropdown example"> <h4 class="ui header">Dropdown</h4> <p>A basic dropdown has no special formatting of its own</p> <div class="ui dropdown"> <div class="text">Select</div> <i class="dropdown icon"></i> <div class="menu"> <div class="item">Edit</div> <div class="item">Remove</div> <div class="item">Hide</div> </div> </div> </div>
<div class="dropdown example"> <h4 class="ui header">Inline</h4> <p>A dropdown can be formatted to appear inline in other content</p> <div>Show me posts trending <div class="ui inline dropdown"> <div class="text">today</div> <i class="dropdown icon"></i> <div class="menu"> <div class="item" data-text="today">Today</div> <div class="item" data-text="this week">This Week</div> <div class="item" data-text="this month">This Month</div> </div> </div> </div> </div>
<div class="dropdown example"> <h4 class="ui header">Selection</h4> <p>A dropdown can be formatted to allow selection of a menu choice.</p> <div class="ui selection dropdown"> <input type="hidden" name="gender"> <i class="dropdown icon"></i> <div class="default text">Gender</div> <div class="menu"> <div class="item" data-value="male">Male</div> <div class="item" data-value="female">Female</div> </div> </div> </div>
<div class="button example"> <h4 class="ui header">Floating</h4> <p>A dropdown menu can appear to be floating below an element.</p> <div class="ui teal buttons"> <div class="ui button">Save</div> <div class="ui teal floating dropdown icon button"> <i class="dropdown icon"></i> <div class="menu"> <div class="item"><i class="edit icon"></i>Edit Post</div> <div class="item"><i class="delete icon"></i>Remove Post</div> <div class="item"><i class="hide icon"></i>Hide Post</div> </div> </div> </div> </div>
<div class="hover example"> <h4 class="ui header">Pointing</h4> <p>A dropdown menu can be formatted to point to its content</p> <div class="ui compact menu"> <div class="menu"> <a class="active item"> <i class="home icon"></i> Home </a> <div class="ui pointing dropdown link item"> <i class="icon mail"></i> Messages <i class="dropdown icon"></i> <div class="menu"> <a class="item"><i class="mail icon"></i>Inbox</a> <a class="item"><i class="book icon"></i>Archive</a> </div> </div> <a class="item"> <i class="user icon"></i> Browse </a> <a class="item"> <i class="question icon"></i> Help </a> </div> </div> </div> <div class="another button example"> <div class="ui blue labeled icon top left pointing dropdown button"> <i class="settings icon"></i> <span class="text">Settings</span> <div class="menu"> <div class="item"><i class="edit icon"></i>Edit</div> <div class="item"><i class="delete icon"></i>Remove</div> <div class="item"><i class="hide icon"></i>Hide</div> </div> </div> <div class="ui red labeled icon top right pointing dropdown button"> <i class="settings icon"></i> <span class="text">Settings</span> <div class="menu"> <div class="item"><i class="edit icon"></i>Edit</div> <div class="item"><i class="delete icon"></i>Remove</div> <div class="item"><i class="hide icon"></i>Hide</div> </div> </div> </div> <div class="another button example"> <div class="ui teal right pointing dropdown icon button"> <i class="settings icon"></i> <div class="menu"> <div class="item"><i class="edit icon"></i>Edit</div> <div class="item"><i class="delete icon"></i>Remove</div> <div class="item"><i class="hide icon"></i>Hide</div> </div> </div> <div class="ui green left pointing dropdown icon button"> <i class="settings icon"></i> <div class="menu"> <div class="item"><i class="edit icon"></i>Edit</div> <div class="item"><i class="delete icon"></i>Remove</div> <div class="item"><i class="hide icon"></i>Hide</div> </div> </div> </div>
<div class="example"> <h4 class="ui header">Simple</h4> <p>A simple dropdown can open without javascript</p> <div class="ui compact menu"> <div class="ui simple dropdown item"> Dropdown <i class="dropdown icon"></i> <div class="menu"> <div class="item">Choice 1</div> <div class="item">Choice 2</div> <div class="item">Choice 3</div> </div> </div> </div> </div>
<h2 class="ui dividing header">Examples</h2>
<div class="dropdown example"> <h4 class="ui header">Re-selecting values</h4> <p>A dropdown will automatically select on page load any menu item that includes the currently value of <code>text</code> or your dropdown's hidden input value. This is used to preserve a user's selection on page navigation and will automatically remove and default text placeholder formatting.</p>
Current action: <div class="ui inline dropdown"> <div class="text">Hide</div> <i class="dropdown icon"></i> <div class="menu"> <div class="item">Edit</div> <div class="item">Remove</div> <div class="item">Hide</div> </div> </div>
</div>
<div class="dropdown example"> <h4 class="ui header">Button Group</h4> <p>A <a href="/element/button.html">button group</a> can be formatted to show additional content as a dropdown</p> <div class="ui red icon buttons"> <div class="ui top left pointing dropdown button"> <i class="user icon"></i> <div class="menu"> <div class="item"><i class="edit icon"></i>Edit User</div> <div class="item"><i class="delete icon"></i>Remove User</div> <div class="item"><i class="hide icon"></i>Make Invisible</div> </div> </div> <div class="ui top left pointing dropdown button"> <i class="users icon"></i> <div class="menu"> <div class="item"><i class="edit icon"></i>Edit Group</div> <div class="item"><i class="delete icon"></i>Remove Group</div> <div class="item"><i class="hide icon"></i>Hide from Group</div> </div> </div> <div class="ui top right pointing dropdown button"> <i class="settings icon"></i> <div class="menu"> <div class="item"><i class="edit icon"></i>Edit</div> <div class="item"><i class="delete icon"></i>Remove</div> <div class="item"><i class="hide icon"></i>Hide</div> </div> </div> </div> </div>
<div class="button example"> <h4 class="ui header">Combo Button</h4> <p>A <a href="/element/button.html">button</a> can be formatted with a dropdown</p> <div class="ui teal buttons"> <div class="ui button">Update Post</div> <div class="ui teal dropdown icon button"> <i class="dropdown icon"></i> <div class="menu"> <div class="item"><i class="edit icon"></i>Edit Post</div> <div class="item"><i class="delete icon"></i>Remove Post</div> <div class="item"><i class="hide icon"></i>Hide Post</div> </div> </div> </div> </div>
<div class="dropdown example"> <h4 class="ui header">Multiple Levels</h4> <p>A dropdown menu can also contain sub menus inside of it</p> My favorite animal breed is <div class="ui inline dropdown"> <input type="hidden" name="gender"> <div class="text">Shiba Inu</div> <i class="dropdown icon"></i> <div class="menu"> <div class="item"> <i class="dropdown icon"></i> Dogs <div class="menu"> <div class="item">Shiba Inu</div> <div class="item">Poodle</div> <div class="item">Labrador</div> </div> </div> <div class="item"> <i class="dropdown icon"></i> Cats <div class="menu"> <div class="item">Aegean</div> <div class="item">Balinese</div> <div class="item">Persian</div> </div> </div> </div> </div> </div>
<div class="hover example"> <h4 class="ui header">Menu</h4> <p>A <a href="/collection/menu.html">menu</a> element can contain a dropdown</p> <div class="ui compact tiered purple inverted menu"> <div class="menu"> <a class="active item"> <i class="icon home"></i> Home </a> <a class="ui dropdown item"> <i class="icon mail"></i> Messages <i class="dropdown icon"></i> <div class="menu"> <div class="item"> <i class="mail icon"></i>Categories <div class="menu"> <div class="item">Unread</div> <div class="item">Promotions</div> <div class="item">Updates</div> </div> </div> <div class="item"><i class="book icon"></i>Archive</div> </div> </a> <a class="item"> <i class="user icon"></i> Browse </a> </div> <div class="sub menu"> <a class="item">Activity Feed</a> <a class="item">Profile</a> <a class="item">Events</a> </div> </div> </div>
<div class="dropdown example"> <h4 class="ui header">Form</h4> <p>A dropdown can be formatted to allow selection inside a <a href="/collection/form.html">form</a></p> <div class="ui form segment"> <p>Let's go ahead and get you signed up.</p> <div class="two fields"> <div class="field"> <label>First Name</label> <input placeholder="First Name" type="text"> </div> <div class="field"> <label>Last Name</label> <input placeholder="Last Name" type="text"> </div> </div> <div class="field"> <label>Gender</label> <div class="ui dropdown selection"> <input type="hidden" name="gender"> <i class="dropdown icon"></i> <div class="default text">...</div> <div class="menu"> <div class="item" data-value="male">Male</div> <div class="item" data-value="female">Female</div> </div> </div> </div> </div> </div>
<div class="transition example"> <h4 class="ui header">Transitions</h4> <p>A dropdown can have different <a href="/modules/transition.html">transitions</a>.</p> <div class="ui teal buttons"> <div class="ui button">Toggle</div> <div class="ui teal floating dropdown icon button"> <i class="dropdown icon"></i> <div class="menu"> <div class="item" data-value="horizontal flip">Horizontal Flip</div> <div class="item" data-value="fade up">Fade Up</div> <div class="item" data-value="scale">Scale</div> </div> </div> </div> </div>
<h2 class="ui dividing header">Variations</h2>
<div class="dropdown example"> <h4 class="ui header">Fluid</h4> <p>A dropdown can take the full width of its parent</p> <div class="ui vertical menu"> <a class="item">Link 1</a> <a class="item">Link 2</a> <div class="header item">All Sections</div> <div class="ui item"> <div class="ui fluid selection dropdown"> <div class="text">More</div> <i class="dropdown icon"></i> <div class="menu"> <div class="item">Choice 1</div> <div class="item">Choice 2</div> <div class="item">Choice 3</div> </div> </div> </div> </div> </div> <h2 class="ui dividing header">States</h2>
<div class="example"> <h4 class="ui header">Active</h4> <p>An active dropdown menu has its menu open</p> <div class="ui compact menu"> <div class="ui simple active dropdown item"> Dropdown <i class="dropdown icon"></i> <div class="menu"> <div class="item">Choice 1</div> <div class="item">Choice 2</div> </div> </div> </div> </div>
<div class="example"> <h4 class="ui header">Disabled</h4> <p>A disabled dropdown menu will not open or close</p> <div class="ui menu"> <div class="ui simple disabled dropdown item"> Dropdown <i class="dropdown icon"></i> <div class="menu"> <div class="item">Choice 1</div> <div class="item">Choice 2</div> <div class="item">Choice 3</div> </div> </div> </div> </div>
<h2 class="ui dividing header">Behavior</h2>
<div class="no example"> <h4 class="ui header">Show</h4> <p>A dropdown can show its menu</p> <div class="ignore code"> $('.ui.dropdown') .dropdown('show') ; </div> </div> <div class="no example"> <h4 class="ui header">Hide</h4> <p>A dropdown can hide its menu</p> <div class="ignore code"> $('.ui.dropdown') .dropdown('hide') ; </div> </div> <div class="no example"> <h4 class="ui header">Toggle</h4> <p>A dropdown can toggle between menu visibility</p> <div class="ignore code"> $('.ui.dropdown') .dropdown('toggle') ; </div> </div>
<h2 class="ui dividing header">Settings</h2>
<div class="no example">
<h4 class="ui header">Dropdown Settings</h4> <p>Dropdown settings modify the dropdown's behavior</p> <table class="ui celled definition table segment"> <thead> <th>Setting</th> <th class="four wide">Default</th> <th>Description</th> </thead> <tbody> <tr> <td>on</td> <td>click</td> <td>Event used to trigger dropdown (Hover, Click)</td> </tr> <tr> <td>delay</td> <td> <div class="code"> delay: { show: 50, hide: 300 } </div> </td> <td>Time in milliseconds to debounce show or hide behavior when <code>on: hover</code> is used.</td> </tr> <tr> <td>transition</td> <td> slide down </td> <td>Named transition to use when animating menu in and out. Fade and slide down are available without including <a href="/modules/transition.html">ui transitions</a></td> </tr> <tr> <td>action</td> <td>auto</td> <td>Sets a default action to occur. <div class="ui vertical divided list"> <div class="item"> <div class="header">activate</div> <div class="description">Most likely action will be determined by type of dropdown, for example a selection dropdown will automatically use updateForm</div> </div> <div class="item"> <div class="header">nothing</div> <div class="description">no action occurs</div> </div> <div class="item"> <div class="header">hide</div> <div class="description">Dropdown menu is hidden</div> </div> <div class="item"> <div class="header">activate</div> <div class="description">Dropdown menu is hidden, item activated and text is changed</div> </div> <div class="item"> <div class="header">function(){}</div> <div class="description">custom function is executed</div> </div> </div> </tr> </tbody> </table>
<div class="ui horizontal section divider"><i class="icon setting"></i></div> <h4 class="ui header">Callbacks</h4> <p>Callback settings specify a function to occur after a specific behavior.</p>
<table class="ui celled definition table segment"> <thead> <th class="four wide">Setting</th> <th>Context</th> <th>Description</th> </thead> <tbody> <tr> <td>onChange(value, text)</td> <td>Dropdown</td> <td>Is called after a dropdown item is selected. Receieves the name and value of selection.</td> </tr> <tr> <td>onShow</td> <td>Dropdown</td> <td>Is called after a dropdown is shown.</td> </tr> <tr> <td>onHide</td> <td>Dropdown</td> <td>Is called after a dropdown is hidden.</td> </tr> </tbody> </table>
</div>
<div class="no example">
<h4 class="ui header">DOM Settings</h4> <p>DOM settings specify how this module should interface with the DOM</p> <table class="ui celled definition table segment"> <thead> <th>Setting</th> <th class="four wide">Default</th> <th>Description</th> </thead> <tbody> <tr> <td>namespace</td> <td>dropdown</td> <td>Event namespace. Makes sure module teardown does not effect other events attached to an element.</td> </tr> <tr> <td>selector</td> <td colspan="2"> <div class="code"> selector : { menu : '.menu', item : '.menu > .item', text : '> .text', input : '> input[type="hidden"]' }, </div> </td> </tr> <tr> <td>metadata</td> <td colspan="2"> <div class="code"> metadata: { text : 'text', value : 'value' }, </div> </td> </tr> <tr> <td>className</td> <td colspan="2"> <div class="code"> className : { active : 'active', placeholder : 'default', disabled : 'disabled', visible : 'visible' } </div> </td> </tr> </tbody> </table>
</div>
<div class="no example">
<h4 class="ui header">Debug Settings</h4> <p>Debug settings controls debug output to the console</p> <table class="ui celled definition table segment"> <thead> <th>Setting</th> <th class="four wide">Default</th> <th>Description</th> </thead> <tbody> <tr> <td>name</td> <td>Dropdown</td> <td>Name used in debug logs</td> </tr> <tr> <td>debug</td> <td>True</td> <td>Provides standard debug output to console</td> </tr> <tr> <td>performance</td> <td>True</td> <td>Provides standard debug output to console</td> </tr> <tr> <td>verbose</td> <td>True</td> <td>Provides ancillary debug output to console</td> </tr> <tr> <td>error</td> <td colspan="2"> <div class="code"> error : { action : 'You called a dropdown action that was not defined', method : 'The method you called is not defined.', transition : 'The requested transition was not found' } </div> </td> </tr> </tbody> </table>
</div>
</div></body>
</html>
|
