watusi/jquery-mobile-iscrollview, Version 1.3.6
===============================================
JQuery Mobile widget plug-in for easy use of the [iScroll](https://github.com/cubiq/iscroll)
scroller in [JQuery Mobile](https://github.com/jquery/jquery-mobile)
projects.
iScroll is a javascript that can scroll content in a window within a web browser with very
similar behaviour to native scrolling on mobile devices such as iPhone and Android. This means you
can scroll a *window* within the browser using native-like scrollbars and physics.
jquery.mobile.iscrollview adapts the iScroll javascript to the jQuery Mobile environment.
It is an implementation of a JQuery [Widget Factory](https://github.com/scottgonzalez/jquery-ui-1.8-widget-factory)
widget. It follows the *widget-factory-mobile*
[Widget Factory Pattern](https://github.com/addyosmani/jquery-plugin-patterns).
---
Release Notes
-------------
Please see releaseNotes.txt for information on changes in this and prior releases.
iScroll Version 4.2.5
---------------------
This widget is not yet compatible with iScroll version 4.2.1 through 4.2.5. Please stick with iScroll 4.2 for
now. Some investigation and testing is needed due to changes in iScroll event code.
Also, iScroll 4.2.1 introduced and change that may not be desirable. Scrolling continues
when your finger leaves the wrapper. While this is a nice feature for small scrollers,
this is not always desirable. It is very odd on desktop browsers, as scroll continues
when you drag with the mouse, even outside of the browser! It should be optional. (It will be in iScroll5).
Roadmap
-------
1.4 - Fully implement usejQueryEvents
? - Option to un-enhance widget temporarily (and optionally hide headers/footers) during
virtual-keyboard input on select devices (iOS first), to eliminate all form input problems
when using a virtual keyboard.
? iOS keyboard handing for inputs. Guess keyboard height based on device/orientation/fullscreen.
Resize wrapper to fit page in space above keyboard, center focused element.
? - Better support for collapsible content (scroll on expand if expanded content below window)
Plug for jquery.mobile.simultaneous-transitions
-----------------------------------------------
This plugin works best when used with
[jquery.mobile.simultaneous-transitions](https://github.com/watusi/jquery.mobile.simultaneous-transitions)
It puts back the old, simultaneous, non-scrolling transitions that everybody knew and loved
from jQuery Mobile 1.0. It's an ideal companion for jquery.mobile.iscrollview! Stop fighting the
goofy transitions in jQuery Mobile 1.1. If you're using iScroll, you probably don't need them.
What This is For
----------------
This widget is intended for use in any jQuery Mobile project, but it was designed to be especially
useful for some specific uses.
First and foremost are native mobile applications that use HTML/CSS/Javascript in a
webview for their user interface. It is especially desirable that such applications reproduce a
"native" look and feel. A native look and feel is impossible to achieve without an embeddable
scroller with native-like physics and scrollbar action.
While iScroll4 is useful to help achieve this goal, it is difficult to use along with
jQuery Mobile. It is not an easy task to integrate iScroll4 with jQuery Mobile - at least not
correctly and efficiently.
My intention is that this widget will handle 80% of use cases with very minimal effort.
The most common need for iScroll in jQuery Mobile projects is to have a fixed header and footer
with a single vertically-scrollable area in-between.
This can be accomplished by simply including the required files in the `<head>` and adding a
single `data-iscroll` attribute to your content `<div>`.
If you need to do something different than this, this widget will probably work for you, but
you will probably have to set some options and dig into the documentation a bit.
Because the primary target for this widget is native mobile applications, it has a large number of
configurable options, which may be usable only in certain target environments. I want you to be able
to tailor the widget to your specific needs when you are using it in specific, known environments.
Secondarily, it is intended to support websites that will be viewed on mobile browsers, and
"full-screen" websites and "web apps" for mobile devices (i.e. "Add to Home Screen" in
Mobile Safari).
Finally, it supports desktop browsers, and is regularly tested using current versions of
FireFox, Safari, Chrome, and Opera. It generally works well in these browsers, and fortunately
hasn't needed a lot of work to acheive compatability.
This widget is *not* well-tested on Android devices, and I very much appreciate assistance in
ferreting-out Android issues. It is tested regularly in all three modes (Mobile Safari, full-screen,
and UIWebView) on iPad 1(5.1), iPad 3(5.1), iPhone 4 (4.3.5) and iPhone 4S(5.1).
Usage
-----
The most basic usage of this widget is simple: just add a `data-iscroll`
attribute to a container. All content inside this container will be scrolled.
Note that `iscroll.js` itself scrolls only the first child of it's wrapper. However, by
default, this plugin automatically creates a protective `<div>` around all
children of the wrapper, and so unlike iscroll.js it will scroll *all* of the children of the
wrapper element - not just the first.
As well, you may have *no* content in the wrapper initially. You might do this, for example, if
you will be inserting dynamic content later. In this case, the plugin will create an empty
`<div>` for you.
If, for some reason, you do not want the widget to create
this protective container, set the `createScroller` option to `false`.
The widget does not use the typical JQuery Mobile `data-role="something"` attribute,
because a common use case would be to use a `data-role="content"` `<div>` as the
container, and, of course, you can't have two `data-role` attributes on the
same element.
The widget will (normally) re-size the container to take up all available height
within the viewport after fixed headers/footers are taken into account. This behaviour can be
disabled using the `resizeWrapper` option, which should be se `true` for no more than one widget
on a given page.
The widget has been designed to support multiple scrollers on a page - for example, you
might want a second, gallery-like horizontal scroller. So, all
data related to a scroller is stored in the scroller's container, not the page.
Feel free to experiment with multiple scrollers - I just haven't had the
need so haven't put the effort into testing and supporting that scenario.
Support for `data-position="fixed"` headers/footers is limited, but improved over previous
versions. Since this widget resizes the scroller to fit the page, there is no need for fixed
positioning of header/footer. Resizing is fast enough that the footer stays "glued" to the
bottom of the page fairly well.
Additional fixed-height elements (which are not headers or footers)
outside of the scrolling region should be given the `data-iscroll-fixed` attribute, if they
would add to the height of the page. (Do not add the `data-iscroll-fixed` attribute
to sidebars.)
---
Example
-------
```html
<!DOCTYPE html>
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1,maximum-scale=1,user-scalable=no"/>
<meta name="apple-mobile-web-app-capable" content="yes">
<meta name="apple-mobile-web-app-status-bar-style" content="black">
<title>Demo</title>
<link rel="stylesheet" href="jquery.mobile-1.3.1.min.css"/>
<link rel="stylesheet" href="jquery.mobile.iscrollview.css"/>
<link rel="stylesheet" href="jquery.mobile.iscrollview-pull.c
ssh开源框架快速开发平台 Spring MVC版本的S2JH4Net 界面不错 （2713个子文件） 
.travis.yml 51B pom.xml 28KB .springBeans 551B assembly-standalone.xml 2KB org.eclipse.m2e.core.prefs 90B org.eclipse.wst.jsdt.ui.superType.name 6B org.eclipse.wst.common.project.facet.core.xml 252B org.eclipse.core.resources.prefs 283B org.eclipse.wst.common.component 557B org.eclipse.wst.jsdt.ui.superType.container 49B org.eclipse.wst.validation.prefs 50B .jsdtscope 508B org.eclipse.jdt.core.prefs 243B application-test.properties 113B spring-mvc.xml 4KB BaseQuartzJobTestCase.java 1KB SpringTransactionalTestCase.java 2KB SpringContextTestCase.java 558B SpringControllerTestCase.java 1KB UserLogonLogServiceTest.java 965B TableSeqGeneratorTest.java 845B QueryCacheTest.java 2KB UserDaoTest.java 1KB UserControllerTest.java 2KB UserServiceTest.java 1KB ConfigPropertyDaoTest.java 693B MenuControllerTest.java 1KB NotifyMessageServiceTest.java 708B MenuServiceTest.java 720B UserMessageServiceTest.java 687B
placeholder.txt 0B logback.xml 548B disabled.ehcache-config.xml 2KB application.prd.properties 2KB
AdminPage.html 5KB index.html 4KB Grid.html 5KB Global_.html 5KB SitePage.html 5KB global.html 96KB jsdoc-default.css 4KB prettify-jsdoc.css 1KB prettify-tomorrow.css 2KB linenumber.js 493B prettify.js 13KB lang-css.js 861B Apache-License-2.0.txt 11KB 表格组件.md 16KB
mobile_menu.gif 32KB grid-filter-pagesort.gif 22KB
img-0062.jpg 134KB grid-filter-advsearch.gif 19KB grid-filter-export.gif 40KB grid-filter-zoomin2.gif 12KB ui-example.jpg 1.24MB img-0005.jpg 61KB grid-filter-buttons3.gif 9KB img-0006.jpg 47KB img-0065.jpg 121KB audit-data-log.jpg 137KB img-0009.jpg 90KB img-0013.jpg 119KB mobile_scan.gif 30KB
query-sum.png 84KB grid-master-detail.png 160KB img-0010.jpg 114KB grid-filter-dnd2.gif 23KB grid-filter-columns.gif 22KB img-0020.jpg 172KB grid-filter-buttons1.gif 3KB mobile_stock2.gif 31KB mobile_stock3.gif 29KB link.gif 81B audit-compare.jpg 116KB img-0058.jpg 201KB img-0011.jpg 162KB mobile_stock.gif 29KB grid-filter-buttons2.gif 13KB img-0063.jpg 734KB img-0004.jpg 145KB img-0066.jpg 128KB audit-op-log.jpg 161KB img-0053.jpg 28KB img-0001.jpg 133KB img-0061.jpg 81KB ui-layout.jpg 204KB grid-filter-buttons5.gif 14KB grid-filter-zoomin.gif 14KB img-0012.jpg 69KB img-0057.jpg 160KB grid-filter-inlineedit.gif 13KB img-0055.jpg 140KB img-0015.jpg 226KB grid-filter-toolbar.gif 23KB grid-filter-oper.gif 8KB ui-validation.png 26KB img-0059.jpg 466KB grid-filter-buttons4.gif 9KB img-0064.jpg 144KB img-0056.jpg 168KB共 2713 条
- 1
- 2
- 3
- 4
- 5
- 6
- 28
资源评论
