2011-09-28 19:19:32 +00:00
<!DOCTYPE html>
2012-01-04 21:59:17 +00:00
< html class = "ui-mobile-rendering" >
2011-09-28 19:19:32 +00:00
< head >
< meta charset = "utf-8" >
< meta name = "viewport" content = "width=device-width, initial-scale=1" >
< title > jQuery Mobile Docs - Search input< / title >
2012-01-10 21:35:08 +00:00
< link rel = "stylesheet" href = "../../../css/themes/default/jquery.mobile.css" / >
2011-09-28 19:19:32 +00:00
< link rel = "stylesheet" href = "../../_assets/css/jqm-docs.css" / >
< script src = "../../../experiments/themeswitcher/jquery.mobile.themeswitcher.js" > < / script >
2011-12-24 08:48:08 +00:00
< script data-main = "../../../js/jquery.mobile.docs" src = "../../../external/requirejs/require.js" > < / script >
2012-01-13 05:25:59 +00:00
< script src = "../../../js/jquery.js" > < / script >
2011-09-28 19:19:32 +00:00
< / head >
< body >
< div data-role = "page" class = "type-interior" >
< div data-role = "header" data-theme = "f" >
< h1 > Search input< / h1 >
< a href = "../../../" data-icon = "home" data-iconpos = "notext" data-direction = "reverse" class = "ui-btn-right jqm-home" > Home< / a >
< / div > <!-- /header -->
< div data-role = "content" >
< div class = "content-primary" >
< form action = "#" method = "get" >
< h2 > Search input< / h2 >
< ul data-role = "controlgroup" data-type = "horizontal" class = "localnav" >
< li > < a href = "index.html" data-role = "button" data-transition = "fade" class = "ui-btn-active" > Basics< / a > < / li >
< li > < a href = "options.html" data-role = "button" data-transition = "fade" > Options< / a > < / li >
< li > < a href = "methods.html" data-role = "button" data-transition = "fade" > Methods< / a > < / li >
< li > < a href = "events.html" data-role = "button" data-transition = "fade" > Events< / a > < / li >
< / ul >
2011-11-14 02:13:53 +00:00
< p > Search inputs are a new HTML type that is styled with pill-shaped corners and adds a "x" icon to clear the field once you start typing. Start with an < code > input< / code > with a < code > type="search"< / code > attribute in your markup. View the < a href = "../../api/data-attributes.html" > data- attribute reference< / a > to see all the possible attributes you can add to search inputs.< / p >
2011-10-14 19:59:55 +00:00
< p > Set the < code > for< / code > attribute of the < code > label< / code > to match the ID of the < code > input< / code > so they are semantically associated. It's possible to < a href = "../docs-forms.html" > accessibly hide the label< / a > if it's not desired in the page layout, but we require that it is present in the markup for semantic and accessibility reasons.< / p >
< pre > < code >
< label for=" search-basic" > Search Input:< /label>
< input type=" search" name=" search" id=" searc-basic" value=" " />
< / code > < / pre >
< p > This will produce a basic search input. The default styles set the width of the input to 100% of the parent container and stacks the label on a separate line.< / p >
< label for = "search-basic" > Search Input:< / label >
< input type = "search" name = "search" id = "search-basic" value = "" / >
< p > Optionally wrap the search input in a container with the < code > data-role="fieldcontain"< / code > attribute to help visually group it in a longer form.< / p >
2011-09-28 19:19:32 +00:00
< pre > < code >
2011-10-14 19:59:55 +00:00
< strong > < div data-role=" fieldcontain" >
< / strong > < label for=" search" > Search Input:< /label>
2011-09-28 19:19:32 +00:00
< input type=" search" name=" password" id=" search" value=" " />
2011-10-14 19:59:55 +00:00
< strong > < /div>
< / strong > < / code > < / pre >
2011-09-28 19:19:32 +00:00
2011-10-14 19:59:55 +00:00
< p > The search input is now displayed like this:< / p >
2011-09-28 19:19:32 +00:00
< div data-role = "fieldcontain" >
< label for = "search" > Search Input:< / label >
2011-10-14 19:59:55 +00:00
< input type = "search" name = "search2" id = "search" value = "" / >
2011-09-28 19:19:32 +00:00
< / div >
< p > Themed variation:< / p >
< div data-role = "fieldcontain" >
< label for = "searchA" > Search Input:< / label >
2011-10-14 19:59:55 +00:00
< input type = "search" name = "search3" id = "searchA" value = "" data-theme = "a" / >
2011-09-28 19:19:32 +00:00
< / div >
< h2 > Calling the textinput plugin< / h2 >
< p > This plugin will auto initialize on any page that contains a text input with the < code > type="search"< / code > attribute, no need for a < code > data-role< / code > attribute in the markup. However, if needed you can directly call the < code > textinput< / code > plugin on a selector, just like any jQuery plugin:< / p >
< pre > < code >
$('.mySearchInput').textinput();
< / code > < / pre >
< / form >
< / div > <!-- /content - primary -->
< div class = "content-secondary" >
2011-09-29 20:35:31 +00:00
< div data-role = "collapsible" data-collapsed = "true" data-theme = "b" data-content-theme = "d" >
2011-09-28 19:19:32 +00:00
< h3 > More in this section< / h3 >
< ul data-role = "listview" data-theme = "c" data-dividertheme = "d" >
< li data-role = "list-divider" > Form elements< / li >
< li > < a href = "../docs-forms.html" > Form basics< / a > < / li >
< li > < a href = "../forms-all.html" > Form element gallery< / a > < / li >
< li > < a href = "../textinputs/index.html" > Text inputs< / a > < / li >
2011-09-28 20:02:56 +00:00
< li data-theme = "a" > < a href = "index.html" > Search input< / a > < / li >
2011-09-29 14:52:58 +00:00
< li > < a href = "../slider/" > Slider< / a > < / li >
< li > < a href = "../switch/" > Flip toggle switch< / a > < / li >
< li > < a href = "../radiobuttons/" > Radio buttons< / a > < / li >
< li > < a href = "../checkboxes/" > Checkboxes< / a > < / li >
< li > < a href = "../selects/" > Select menus< / a > < / li >
2011-09-28 19:19:32 +00:00
< li > < a href = "../forms-themes.html" > Theming forms< / a > < / li >
< li > < a href = "../forms-all-native.html" > Native form elements< / a > < / li >
< li > < a href = "../forms-sample.html" > Submitting forms< / a > < / li >
2011-09-29 15:33:32 +00:00
2011-09-28 19:19:32 +00:00
< / ul >
< / div >
< / div >
< / div > <!-- /content -->
< div data-role = "footer" class = "footer-docs" data-theme = "c" >
< p > © 2011 The jQuery Project< / p >
< / div >
< / div > <!-- /page -->
< / body >
< / html >
