4 <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
5 <title>Tether – Marrying elements for life</title>
6 <meta name="description" content="Tether is a JavaScript and CSS library. It is free and open source and was developed by HubSpot developers Adam Schwartz (@adamfschwartz) and Zack Bloom (@zackbloom).">
7 <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
8 <link rel="icon" href="http://static.hubspot.com/favicon.ico">
10 <script type="text/javascript" src="//use.typekit.net/ghy0wve.js"></script>
11 <script type="text/javascript">try{Typekit.load();}catch(e){}</script>
13 <!-- Tether themes -->
14 <link rel="stylesheet" href="/tether/css/tether-theme-arrows-dark.css" />
16 <!-- Welcome docs styles -->
17 <link rel="stylesheet" href="/tether/docs/welcome/css/prism.css" />
18 <link rel="stylesheet" href="/tether/docs/welcome/css/welcome.css" />
21 <link rel="stylesheet" href="http://github.hubspot.com/os-icons/os-icons.css" />
24 <div class="hero-wrap">
25 <table class="showcase hero"><tr><td>
26 <div class="showcase-inner">
27 <div class="tether-target-demo">
29 <div class="mobile-copy">
30 <h2>Marrying elements for life</h2>
32 <a class="button" href="http://github.com/HubSpot/tether">★ On Github</a>
40 <div class="browser-demo-start-point"></div>
42 <table class="showcase browser-demo"><tr><td>
43 <div class="showcase-inner">
44 <div class="section-copy" data-section="what">
45 <h2>What is Tether?</h2>
47 <div class="section-copy" data-section="how">
48 <h2>How Tether works.</h2>
50 <div class="section-copy" data-section="why">
51 <h2>Tether is powerful.</h2>
53 <div class="section-copy" data-section="outro">
54 <h2>Play with Tether</h2>
56 <div class="browser-demo-inner">
57 <div class="browser-window">
58 <div class="browser-titlebar">
59 <div class="browser-dots"><b></b><b></b><b></b></div>
61 <div class="browser-frame">
62 <iframe src="browser-demo.html"></iframe>
69 <table class="showcase browser-demo-section no-next-arrow" data-section="what"><tr><td>
70 <div class="section-scroll-copy">
71 <div class="section-scroll-copy-inner">
72 <p>Tether is a low-level UI library that can be used to position any element on a page <i>next to any other element</i>.</p>
73 <p>It can be used for dropdown menus, tooltips, popovers, tours, help information, scroll guides, autocompletes, etc. The possibilities are endless.</p>
74 <p class="example-paragraph">In this example we're showing an action menu <em>tethered</em> to a list item.</p>
79 <table class="showcase browser-demo-section no-next-arrow" data-section="how"><tr><td>
80 <div class="section-scroll-copy">
81 <div class="section-scroll-copy-inner">
82 <p>Tether works by creating an absolutely positioned element and meticulously tracking the movements of a <i>target</i> which you specify.</p>
83 <p>The <i>target</i> and <i>element</i> can be tethered together in a variety of different ways.</p>
84 <p class="example-paragraph">Notice how the <i>tethered element</i> stays tethered to its <i>target</i> list item even as the left pane is scrolled up and down.</p>
89 <table class="showcase browser-demo-section no-next-arrow" data-section="why"><tr><td>
90 <div class="section-scroll-copy">
91 <div class="section-scroll-copy-inner">
92 <p>Tether can keep your element positioned properly even in some tough situations.</p>
93 <p>Tether handles all of the common pain points:</p>
95 <li>Automatically detect collisions with the edge of the page or edge of the scrollParent</li>
96 <li>Automatically reposition on browser resize, scroll, and other events,</li>
97 <li>Constrain the position to any bounding box,</li>
99 <p>...and a lot more.</p>
104 <table class="showcase browser-demo-section no-next-arrow" data-section="outro"><tr><td>
105 <div class="section-scroll-copy">
106 <div class="section-scroll-copy-inner">
107 <p class="example-paragraph">Interact with this demo.</p>
109 <p>To learn more, check out our <a href="/tether">documentation</a>.</p>
114 <table class="showcase browser-demo-section no-next-arrow" data-section="__empty"><tr><td></td></tr></table>
116 <div class="browser-demo-stop-point"></div>
118 <table class="showcase projects-showcase no-next-arrow"><tr><td>
119 <div class="showcase-inner">
120 <h1>Tether Family</h1>
121 <h2>These projects are all powered by Tether's positioning engine.</h2>
122 <div class="projects-list">
123 <a href="/drop/docs/welcome" class="project">
125 <span class="os-icon drop-icon"></span>
126 <p>Create dropdowns, popovers, and more.</p>
128 <a href="/tooltip/docs/welcome" class="project">
130 <span class="os-icon tooltip-icon"></span>
131 <p>Stylable tooltips built on Tether.</p>
133 <a href="/select/docs/welcome" class="project">
135 <span class="os-icon select-icon"></span>
136 <p>Stylable select elements built on Tether.</p>
138 <a href="/shepherd/docs/welcome" class="project">
140 <span class="os-icon shepherd-icon"></span>
141 <p>Guide your users through a tour of your app.</p>
147 <table class="showcase last-showcase no-next-arrow share"><tr><td>
148 <div class="showcase-inner">
150 <h2>Help us spread the word.</h2>
158 display: inline-block;
168 <div class="share-buttons">
169 <div class="share-button retweet-button">
170 <a href="http://twitter.com/share" class="twitter-share-button" data-url="http://github.hubspot.com/tether/docs/welcome" data-text="Tether.js - A positioning engine for JavaScript" data-count="horizontal" data-via="HubSpotDev">Tweet</a>
173 var recommends, button;
175 if (Math.random() >= 0.5) {
176 recommends = ['hubspotdev', 'zackbloom', 'adamfschwartz'];
178 recommends = ['hubspotdev', 'adamfschwartz', 'zackbloom'];
181 button = document.querySelector('.twitter-share-button');
184 button.setAttribute('data-related', recommends.join(','));
188 <script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script>
190 <div class="share-button github-stars-button">
191 <iframe src="http://ghbtns.com/github-btn.html?user=HubSpot&repo=tether&type=watch&count=true&size=small" allowtransparency="true" frameborder="0" scrolling="0" width="100" height="20"></iframe>
197 <!-- Tether javascript -->
198 <script src="/tether/tether.min.js"></script>
200 <!-- Welcome docs javascript -->
201 <script src="/tether/docs/welcome/js/log.js"></script>
202 <script src="/tether/docs/welcome/js/jquery.js"></script>
203 <script src="/tether/docs/welcome/js/drop.js"></script>
204 <script src="/tether/docs/welcome/js/welcome.js"></script>
206 <!-- HubSpot analytics -->
207 <script type="text/javascript">
209 if (d.getElementById(i)){return;}
210 var n=d.createElement(s),e=d.getElementsByTagName(s)[0];
211 n.id=i;n.src='//js.hubspot.com/analytics/'+(Math.ceil(new Date()/r)*r)+'/51294.js';
212 e.parentNode.insertBefore(n, e);
213 })(document,"script","hs-analytics",300000);
216 <!-- Google analytics -->
218 (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
219 (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
220 m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
221 })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
223 ga('create', 'UA-45159009-1', 'auto');
224 ga('send', 'pageview');