index.html 23 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  2. "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  3. <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-us">
  4. <head>
  5. <title>jCarousel - Riding carousels with jQuery</title>
  6. <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
  7. <link href="style.css" rel="stylesheet" type="text/css">
  8. </head>
  9. <body>
  10. <div id="wrap">
  11. <h1>jCarousel</h1>
  12. <h2>Riding carousels with jQuery</h2>
  13. <p><strong>Author:</strong> <a href="http://sorgalla.com">Jan Sorgalla</a><br />
  14. <strong>Version:</strong> 0.2.8 (<a href="changelog.html">Changelog</a>)<br />
  15. <strong>Download:</strong> <a href="http://sorgalla.com/projects/download.php?jcarousel">jcarousel.tar.gz</a> or <a href="http://sorgalla.com/projects/download-zip.php?jcarousel">jcarousel.zip</a><br />
  16. <strong>Source Code:</strong> <a href="http://github.com/jsor/jcarousel">http://github.com/jsor/jcarousel</a><br/>
  17. <strong>Bugtracker:</strong> <a href="http://github.com/jsor/jcarousel/issues">http://github.com/jsor/jcarousel/issues</a><br/>
  18. <strong>Licence:</strong> Dual licensed under the <a href="http://www.opensource.org/licenses/mit-license.php">MIT</a>
  19. and <a href="http://www.opensource.org/licenses/gpl-license.php">GPL</a> licenses.</p>
  20. <a name="Contents"></a>
  21. <h3>Contents</h3>
  22. <ol>
  23. <li><a href="#Introduction">Introduction</a></li>
  24. <li><a href="#Examples">Examples</a></li>
  25. <li><a href="#Getting-Started">Getting started</a></li>
  26. <li><a href="#Dynamic-Content-Loading">Dynamic content loading</a></li>
  27. <li><a href="#Accessing-The-Jcarousel-Instance">Accessing the jCarousel instance</a></li>
  28. <li><a href="#Defining-The-Number-Of-Visible-Items">Defining the number of visible items</a></li>
  29. <li><a href="#Configuration">Configuration</a></li>
  30. <li><a href="#Credits">Credits</a></li>
  31. </ol>
  32. <a name="Introduction"></a>
  33. <h3>Introduction</h3>
  34. <p>jCarousel is a <a href="http://jquery.com">jQuery</a> plugin for controlling
  35. a list of items in horizontal or vertical order. The items, which can be static
  36. HTML content or loaded with (or without) AJAX, can be scrolled back and forth
  37. (with or without animation).</p>
  38. <a name="Examples"></a>
  39. <h3>Examples</h3>
  40. <p>The following examples illustrate the possibilities of jCarousel:</p>
  41. <noscript>
  42. <p style="color:red">You need JavaScript enabled to see the carousel</p>
  43. </noscript>
  44. <ul>
  45. <li><strong>Static Examples</strong>
  46. <ul>
  47. <li><a href="examples/static_simple.html">Simple carousel</a></li>
  48. <li><a href="examples/static_vertical.html">Vertical carousel</a></li>
  49. <li><a href="examples/static_circular.html">Circular carousel</a></li>
  50. <li><a href="examples/static_auto.html">Carousel with autoscrolling</a></li>
  51. <li><a href="examples/static_callbacks.html">Carousel illustrating the
  52. callback functions</a></li>
  53. <li><a href="examples/static_controls.html">Carousel with external controls</a></li>
  54. <li><a href="examples/static_start.html">Carousel with custom start position</a></li>
  55. <li><a href="examples/static_multiple.html">Multiple carousels on one page</a></li>
  56. </ul>
  57. </li>
  58. <li><strong>Dynamic Examples</strong>
  59. <ul>
  60. <li><a href="examples/dynamic_javascript.html">Carousel with dynamic content
  61. loading via JavaScript</a></li>
  62. <li><a href="examples/dynamic_ajax.html">Carousel with dynamic content
  63. loading via Ajax</a></li>
  64. <li><a href="examples/dynamic_ajax_php.html">Carousel with dynamic content
  65. loading via Ajax from a PHP script</a></li>
  66. <li><a href="examples/dynamic_flickr_feed.html">Carousel with dynamic
  67. content loading via Ajax from the Flickr photo stream</a></li>
  68. <li><a href="examples/dynamic_flickr_api.html">Carousel with dynamic content
  69. loading via Ajax from the Flickr API</a></li>
  70. </ul>
  71. </li>
  72. <li><strong>Special Examples</strong>
  73. <ul>
  74. <li><a href="examples/special_textscroller.html">Using jCarousel as a
  75. Textscroller</a></li>
  76. <li><a href="examples/special_flexible.html">Flexible carousel</a></li>
  77. <li><a href="examples/special_thickbox.html">jCarousel and Thickbox 3</a></li>
  78. <li><a href="examples/special_easing.html">Carousel with custom animation
  79. effect</a></li>
  80. </ul>
  81. </li>
  82. </ul>
  83. <a name="Getting-Started"></a>
  84. <h3>Getting started</h3>
  85. <p>To use the jCarousel component, include the <a href="http://jquery.com">jQuery</a>
  86. library, the jCarousel source file and a jCarousel skin stylesheet file inside the <code>&lt;head&gt;</code> tag
  87. of your HTML document:</p>
  88. <pre>
  89. &lt;script type=&quot;text/javascript&quot; src=&quot;/path/to/jquery-1.4.2.min.js&quot;&gt;&lt;/script&gt;
  90. &lt;script type=&quot;text/javascript&quot; src=&quot;/path/to/lib/jquery.jcarousel.min.js&quot;&gt;&lt;/script&gt;
  91. &lt;link rel=&quot;stylesheet&quot; type=&quot;text/css&quot; href=&quot;/path/to/skin/skin.css&quot; /&gt;
  92. </pre>
  93. <p>The download package contains some example skin packages. Feel free to build your own skins based on it.</p>
  94. <p>jCarousel expects a very basic HTML markup structure inside your HTML document:</p>
  95. <pre>
  96. &lt;ul id=&quot;mycarousel&quot; class=&quot;jcarousel-skin-<em>name</em>&quot;&gt
  97. &lt;!-- The content goes in here --&gt;
  98. &lt;/ul&gt;
  99. </pre>
  100. <p>jCarousel automatically wraps the required HTML markup around the list. The
  101. class attribute applies the jCarousel skin <em>&quot;name&quot;</em> to the
  102. carousel.</p>
  103. <p> To setup jCarousel, add the following code inside the <code>&lt;head&gt;</code>
  104. tag of your HTML document:</p>
  105. <pre>
  106. &lt;script type=&quot;text/javascript&quot;&gt;
  107. jQuery(document).ready(function() {
  108. jQuery('#mycarousel').jcarousel({
  109. // Configuration goes here
  110. });
  111. });
  112. &lt;/script&gt;
  113. </pre>
  114. <p> jCarousel accepts a lot of configuration options, see chapter "<a href="#Configuration">Configuration</a>"
  115. for further informations.</p>
  116. <p>After jCarousel has been initialised, the fully created markup in
  117. the DOM is:</p>
  118. <pre>
  119. &lt;div class=&quot;jcarousel-skin-<em>name</em>&quot;&gt;
  120. &lt;div class=&quot;jcarousel-container&quot;&gt;
  121. &lt;div class=&quot;jcarousel-clip&quot;&gt;
  122. &lt;ul class=&quot;jcarousel-list&quot;&gt;
  123. &lt;li class=&quot;jcarousel-item-1&quot;&gt;First item&lt;/li&gt;
  124. &lt;li class=&quot;jcarousel-item-2&quot;&gt;Second item&lt;/li&gt;
  125. &lt;/ul&gt;
  126. &lt;/div&gt;
  127. &lt;div disabled=&quot;disabled&quot; class=&quot;jcarousel-prev jcarousel-prev-disabled&quot;&gt;&lt;/div&gt;
  128. &lt;div class=&quot;jcarousel-next&quot;&gt;&lt;/div&gt;
  129. &lt;/div&gt;
  130. &lt;/div&gt;
  131. </pre>
  132. <p>As you can see, there are some elements added which have assigned classes
  133. (in addition to the classes you may have already assigned manually). Feel
  134. free to design your carousel with the classes you can see above.</p>
  135. <h4>Note:</h4>
  136. <ul>
  137. <li>The skin class &quot;jcarousel-skin-<em>name&quot;</em> has been moved
  138. from the <code>&lt;ul&gt;</code> to the top <code>&lt;div&gt;</code> element.</li>
  139. <li>The last 2 nested <code>&lt;div&gt;</code>'s under <code>&lt;div class=&quot;jcarousel-container&quot;&gt;</code>
  140. are the next/prev buttons of the carousel. The first one illustrates a disabled button, the second an enabled one. The disabled
  141. button has the attribute
  142. <code>disabled</code> (which actually makes no sense for <code>&lt;div&gt;</code>
  143. elements, but you can also use <code>&lt;button&gt;</code> elements or
  144. whatever you want) as well as the additional class <code>jcarousel-prev-disabled</code>
  145. (or <code>jcarousel-next-disabled</code>).</li>
  146. <li>All <code>&lt;li&gt;</code> elements of the list have the class <code></code><code>jcarousel-item-<em>n</em></code>
  147. assigned where <code><em>n</em></code> represents the position in the list.</li>
  148. <li>Not shown here is, that all classes are followed by additional classes with a suffix
  149. dependent on the orientation of the carousel, ie. <code>&lt;ul class=&quot;jcarousel-list
  150. jcarousel-list-horizontal&quot;&gt;</code> for a horizontal carousel.</li>
  151. </ul>
  152. <a name="Dynamic-Content-Loading"></a>
  153. <h3>Dynamic content loading</h3>
  154. <p>By passing the callback function <code>itemLoadCallback</code> as configuration
  155. option, you are able to dynamically create <code>&lt;li&gt;</code> items for the content.</p>
  156. <pre>
  157. &lt;script type=&quot;text/javascript&quot;&gt;
  158. jQuery(document).ready(function() {
  159. jQuery('#mycarousel').jcarousel({
  160. itemLoadCallback: itemLoadCallbackFunction
  161. });
  162. });
  163. &lt;/script&gt;</pre>
  164. <p><code>itemLoadCallbackFunction</code> is a JavaScript function that is called
  165. when the carousel requests a set of items to be loaded. Two parameters are
  166. passed: The instance of the requesting carousel and a flag which indicates
  167. the current state of the carousel ('init', 'prev' or 'next').</p>
  168. <pre>
  169. &lt;script type=&quot;text/javascript&quot;&gt;
  170. function itemLoadCallbackFunction(carousel, state)
  171. {
  172. for (var i = carousel.first; i &lt;= carousel.last; i++) {
  173. // Check if the item already exists
  174. if (!carousel.has(i)) {
  175. // Add the item
  176. carousel.add(i, &quot;I'm item #&quot; + i);
  177. }
  178. }
  179. };
  180. &lt;/script&gt;</pre>
  181. <p>jCarousel contains a convenience method <code>add()</code> that can be
  182. passed the index of the item to create and the innerHTML string of the
  183. item to be
  184. created. If the item already exists, it just updates the innerHTML. You can
  185. access the index of the first and last visible element by the public variables <code>carousel.first</code> and <code>carousel.last</code>.
  186. </p>
  187. <a name="Accessing-The-Jcarousel-Instance"></a>
  188. <h3>Accessing the jCarousel instance</h3>
  189. <p>The instance of the carousel will be stored with the <code>data()</code> method of jQuery under the key <code>jcarousel</code> for a simple access.</p>
  190. <p>If you have created a carousel like:</p>
  191. <pre>
  192. jQuery(document).ready(function() {
  193. jQuery('#mycarousel').jcarousel();
  194. });</pre>
  195. <p>You can access the instance with:</p>
  196. <pre>
  197. var carousel = jQuery('#mycarousel').data('jcarousel');</pre>
  198. <p>You can also access methods of the instance directly, for example the <code>add()</code> method:
  199. <pre>
  200. var index = 1;
  201. var html = 'My content of item no. 1';
  202. jQuery('#mycarousel').jcarousel('add', index, html);</pre>
  203. <a name="Defining-The-Number-Of-Visible-Items"></a>
  204. <h3>Defining the number of visible items</h3>
  205. <p>Sometimes people are confused how to define the number of visible items because there is no option for this as they expect (Yes, there is an option <code>visible</code>, we discuss this later).</p>
  206. <p>You simply define the number of visible items by defining the width (or height) with the class <code>.jcarousel-clip</code> (or the more distinct <code>.jcarousel-clip-horizontal</code> and <code>.jcarousel-clip-vertical</code> classes) in your skin stylesheet.</p>
  207. <p>This offers a lot of flexibility, because you can define the width in pixel for a fixed carousel or in percent for a flexible carousel (<a href="examples/static_callbacks.html">This example</a> shows a carousel with a clip width in percent, resize the browser to see it in effect).</p>
  208. <p>So, why there is an option <code>visible</code>? If you set the option <code>visible</code>, jCarousel sets the width of the visible items to always make this number of items visible. Open <a href="examples/special_flexible.html">this example</a> and resize your browser window to see it in effect.</p>
  209. <a name="Configuration"></a>
  210. <h3>Configuration</h3>
  211. <p> jCarousel accepts a list of options to control the appearance and behaviour
  212. of the carousel. Here is the list of options you may set: </p>
  213. <table>
  214. <thead>
  215. <tr>
  216. <th>Property</th>
  217. <th>Type</th>
  218. <th>Default</th>
  219. <th>Description</th>
  220. </tr>
  221. <tr>
  222. <td>vertical</td>
  223. <td>bool</td>
  224. <td>false</td>
  225. <td>Specifies wether the carousel appears in horizontal or vertical orientation.
  226. Changes the carousel from a left/right style to a up/down style carousel.</td>
  227. </tr>
  228. <tr>
  229. <td>rtl</td>
  230. <td>bool</td>
  231. <td>false</td>
  232. <td>Specifies wether the carousel appears in RTL (Right-To-Left) mode.</td>
  233. </tr>
  234. <tr>
  235. <td>start</td>
  236. <td>integer</td>
  237. <td>1</td>
  238. <td>The index of the item to start with.</td>
  239. </tr>
  240. <tr>
  241. <td>offset</td>
  242. <td>integer</td>
  243. <td>1</td>
  244. <td>The index of the first available item at initialisation.</td>
  245. </tr>
  246. </thead>
  247. <tbody>
  248. <tr>
  249. <td>size</td>
  250. <td>integer</td>
  251. <td><em>Number of existing &lt;li&gt; elements if size is not passed explicitly</em></td>
  252. <td>The number of total items.</td>
  253. </tr>
  254. <tr>
  255. <td>scroll</td>
  256. <td>integer</td>
  257. <td>3</td>
  258. <td>The number of items to scroll by.</td>
  259. </tr>
  260. <tr>
  261. <td>visible</td>
  262. <td>integer</td>
  263. <td>null</td>
  264. <td>If passed, the width/height of the items will be calculated and set
  265. depending on the width/height of the clipping, so that exactly that
  266. number of items will be visible.</td>
  267. </tr>
  268. <tr>
  269. <td>animation</td>
  270. <td>mixed</td>
  271. <td>&quot;fast&quot;</td>
  272. <td>The speed of the scroll animation as string in jQuery terms (<code>&quot;slow&quot;</code>
  273. or <code>&quot;fast&quot;</code>) or milliseconds as integer
  274. (See <a href="http://docs.jquery.com/effects/animate">jQuery Documentation</a>).
  275. If set to 0, animation is turned off.</td>
  276. </tr>
  277. <tr>
  278. <td>easing</td>
  279. <td>string</td>
  280. <td>null</td>
  281. <td>The name of the easing effect that you want to use (See <a href="http://docs.jquery.com/effects/animate">jQuery
  282. Documentation</a>).</td>
  283. </tr>
  284. <tr>
  285. <td>auto</td>
  286. <td>integer</td>
  287. <td>0</td>
  288. <td>Specifies how many seconds to periodically autoscroll the content.
  289. If set to <code>0</code> (default) then autoscrolling is turned off.
  290. </td>
  291. </tr>
  292. <tr>
  293. <td>wrap</td>
  294. <td>string</td>
  295. <td>null</td>
  296. <td>Specifies whether to wrap at the first/last item (or both) and jump
  297. back to the start/end. Options are <code>&quot;first&quot;</code>, <code>&quot;last&quot;</code>,
  298. <code>&quot;both&quot;</code> or <code>&quot;circular&quot;</code> as string. If set to <code>null</code>,
  299. wrapping is turned off (default).</td>
  300. </tr>
  301. <tr>
  302. <td>initCallback</td>
  303. <td>function</td>
  304. <td>null</td>
  305. <td>JavaScript function that is called right after initialisation of the
  306. carousel. Two parameters are passed: The instance of the requesting
  307. carousel and the state of the carousel initialisation (init, reset or
  308. reload).</td>
  309. </tr>
  310. <tr>
  311. <td>setupCallback</td>
  312. <td>function</td>
  313. <td>null</td>
  314. <td>JavaScript function that is called right after the carousel is completely setup.
  315. One parameter is passed: The instance of the requesting carousel.</td>
  316. </tr>
  317. <tr>
  318. <td>itemLoadCallback</td>
  319. <td>function</td>
  320. <td>null</td>
  321. <td>JavaScript function that is called when the carousel requests a set
  322. of items to be loaded. Two parameters are passed: The instance of the
  323. requesting carousel and the state of the carousel action (prev, next
  324. or init). Alternatively, you can pass a hash of one or two functions
  325. which are triggered before and/or after animation:
  326. <pre>
  327. itemLoadCallback: {
  328. onBeforeAnimation: callback1,
  329. onAfterAnimation: callback2
  330. }</pre> </td>
  331. </tr>
  332. <tr>
  333. <td>itemFirstInCallback </td>
  334. <td>function</td>
  335. <td>null</td>
  336. <td>JavaScript function that is called (after the scroll animation) when
  337. an item becomes the first one in the visible range of the carousel.
  338. Four parameters are passed: The instance of the requesting carousel
  339. and the <code>&lt;li&gt;</code> object itself, the index which indicates
  340. the position of the item in the list and the state of the carousel action
  341. (prev, next or init). Alternatively, you can pass a hash of one or two
  342. functions which are triggered before and/or after animation:
  343. <pre>
  344. itemFirstInCallback: {
  345. onBeforeAnimation: callback1,
  346. onAfterAnimation: callback2
  347. }</pre> </td>
  348. </tr>
  349. <tr>
  350. <td>itemFirstOutCallback</td>
  351. <td>function</td>
  352. <td>null</td>
  353. <td>JavaScript function that is called (after the scroll animation) when
  354. an item isn't longer the first one in the visible range of the carousel.
  355. Four parameters are passed: The instance of the requesting carousel
  356. and the <code>&lt;li&gt;</code> object itself, the index which indicates
  357. the position of the item in the list and the state of the carousel action
  358. (prev, next or init). Alternatively, you can pass a hash of one or two
  359. functions which are triggered before and/or after animation:
  360. <pre>
  361. itemFirstOutCallback: {
  362. onBeforeAnimation: callback1,
  363. onAfterAnimation: callback2
  364. }</pre> </td>
  365. </tr>
  366. <tr>
  367. <td>itemLastInCallback</td>
  368. <td>function</td>
  369. <td>null</td>
  370. <td>JavaScript function that is called (after the scroll animation) when
  371. an item becomes the last one in the visible range of the carousel. Four
  372. parameters are passed: The instance of the requesting carousel and the
  373. <code>&lt;li&gt;</code> object itself, the index which indicates the
  374. position of the item in the list and the state of the carousel action
  375. (prev, next or init). Alternatively, you can pass a hash of one or two
  376. functions which are triggered before and/or after animation:
  377. <pre>
  378. itemLastInCallback: {
  379. onBeforeAnimation: callback1,
  380. onAfterAnimation: callback2
  381. }</pre> </td>
  382. </tr>
  383. <tr>
  384. <td>itemLastOutCallback</td>
  385. <td>function</td>
  386. <td>null</td>
  387. <td>JavaScript function that is called when an item isn't longer the last
  388. one in the visible range of the carousel. Four parameters are passed:
  389. The instance of the requesting carousel and the <code>&lt;li&gt;</code>
  390. object itself, the index which indicates the position of the item in
  391. the list and the state of the carousel action (prev, next or init).
  392. Alternatively, you can pass a hash of one or two functions which are
  393. triggered before and/or after animation:
  394. <pre>
  395. itemLastOutCallback: {
  396. onBeforeAnimation: callback1,
  397. onAfterAnimation: callback2
  398. }</pre> </td>
  399. </tr>
  400. <tr>
  401. <td>itemVisibleInCallback</td>
  402. <td>function</td>
  403. <td>null</td>
  404. <td>JavaScript function that is called (after the scroll animation) when
  405. an item is in the visible range of the carousel. Four parameters are
  406. passed: The instance of the requesting carousel and the <code>&lt;li&gt;</code>
  407. object itself, the index which indicates the position of the item in
  408. the list and the state of the carousel action (prev, next or init).
  409. Alternatively, you can pass a hash of one or two functions which are
  410. triggered before and/or after animation:
  411. <pre>
  412. itemVisibleInCallback: {
  413. onBeforeAnimation: callback1,
  414. onAfterAnimation: callback2
  415. }</pre> </td>
  416. </tr>
  417. <tr>
  418. <td>itemVisibleOutCallback</td>
  419. <td>function</td>
  420. <td>null</td>
  421. <td>JavaScript function that is called (after the scroll animation) when
  422. an item isn't longer in the visible range of the carousel. Four parameters
  423. are passed: The instance of the requesting carousel and the <code>&lt;li&gt;</code>
  424. object itself, the index which indicates the position of the item in
  425. the list and the state of the carousel action (prev, next or init).
  426. Alternatively, you can pass a hash of one or two functions which are
  427. triggered before and/or after animation:
  428. <pre>
  429. itemVisibleOutCallback: {
  430. onBeforeAnimation: callback1,
  431. onAfterAnimation: callback2
  432. }</pre> </td>
  433. </tr>
  434. <tr>
  435. <td>animationStepCallback</td>
  436. <td>function</td>
  437. <td>null</td>
  438. <td>JavaScript function that is called after each animation step. This
  439. function is directly passed to jQuery's <code>.animate()</code> method
  440. as the <code>step</code> parameter. See the jQuery documentation for the
  441. parameters it will receive.</td>
  442. </tr>
  443. <tr>
  444. <td>buttonNextCallback</td>
  445. <td>function</td>
  446. <td>null</td>
  447. <td>JavaScript function that is called when the state of the 'next' control
  448. is changing. The responsibility of this method is to enable or disable
  449. the 'next' control. Three parameters are passed: The instance of the
  450. requesting carousel, the control element and a flag indicating whether
  451. the button should be enabled or disabled.</td>
  452. </tr>
  453. <tr>
  454. <td>buttonPrevCallback</td>
  455. <td>function</td>
  456. <td>null</td>
  457. <td>JavaScript function that is called when the state of the 'previous'
  458. control is changing. The responsibility of this method is to enable
  459. or disable the 'previous' control. Three parameters are passed: The
  460. instance of the requesting carousel, the control element and a flag
  461. indicating whether the button should be enabled or disabled.</td>
  462. </tr>
  463. <tr>
  464. <td>buttonNextHTML</td>
  465. <td>string</td>
  466. <td><code>&lt;div&gt;&lt;/div&gt;</code></td>
  467. <td>The HTML markup for the auto-generated next button. If set to <code>null</code>,
  468. no next-button is created.</td>
  469. </tr>
  470. <tr>
  471. <td>buttonPrevHTML</td>
  472. <td>string</td>
  473. <td><code>&lt;div&gt;&lt;/div&gt;</code></td>
  474. <td>The HTML markup for the auto-generated prev button. If set to <code>null</code>,
  475. no prev-button is created.</td>
  476. </tr>
  477. <tr>
  478. <td>buttonNextEvent</td>
  479. <td>string</td>
  480. <td>&quot;click&quot;</td>
  481. <td>Specifies the event which triggers the next scroll.</td>
  482. </tr>
  483. <tr>
  484. <td>buttonPrevEvent</td>
  485. <td>string</td>
  486. <td>&quot;click&quot;</td>
  487. <td>Specifies the event which triggers the prev scroll.</td>
  488. </tr>
  489. <tr>
  490. <td>itemFallbackDimension</td>
  491. <td>integer</td>
  492. <td>null</td>
  493. <td>If, for some reason, jCarousel can not detect the width of an item, you can set a fallback dimension (width or height, depending on the orientation) here to ensure correct calculations.</td>
  494. </tr>
  495. </tbody>
  496. </table>
  497. <a name="Credits"></a>
  498. <h3>Credits</h3>
  499. <p>Thanks to <a href="http://ejohn.org">John Resig</a> for his fantastic <a href="http://jquery.com">jQuery</a>
  500. library. <br>
  501. jCarousel is inspired by the <a href="http://billwscott.com/carousel/">Carousel
  502. Component</a> written by <a href="http://looksgoodworkswell.com">Bill Scott</a>.</p>
  503. </div>
  504. </body>
  505. </html>