CODE 项目整体迁移至码云平台(https://gitee.com)公告
OS_Mirror / jquery-mobile JavaScript

jQuery Mobile(jQueryMobile) 是 jQuery 在手机上和平板设备上的版本。jQuery Mobile 不仅会给主流移动平台带来jQuery核心库,而且会发布一个完整统一的jQuery移动UI框架。支持全球主流的移动平台。

https://github.com/jquery/jquery-mobile

框架 jquery mobile 移动平台 手机 发布

项目最近一次提交:8 个月 前 591f10c0e

文件列表 提交日期 作者 提交信息 提交编号
build / 2016-07-31 22:39:35 No_avatar Alexander Schmitz Build: Add requirejs text plugin requ... a94c5d93
css / Ajax_loader_tree
demos / Ajax_loader_tree
external / Ajax_loader_tree
js / Ajax_loader_tree
tests / Ajax_loader_tree
tools / 2016-07-03 22:42:12 No_avatar Cory Gackenheimer Toolbar: Implement classes option 24c072bd
.csscomb.json 2016-07-03 22:40:35 No_avatar Alexander Schmitz Build: Add csslint and csscomb c651bdaa
.csslintrc 2016-07-03 22:40:35 No_avatar Alexander Schmitz Build: Add csslint and csscomb c651bdaa
.editorconfig 2016-07-03 22:42:12 No_avatar Jasper de Groot Config: Added editorconfig 18f65aea
.gitattributes 2014-04-14 12:09:39 No_avatar Scott González Build: Normalize line endings 1f95855f
.gitignore 2014-02-05 12:03:15 No_avatar Ghislain Seguin Tests: Output tests reports in _tests... 5f34b771
.jscsrc 2016-07-03 22:42:12 No_avatar Amanpreet Singh Build: Update grunt task, fix jscs:go... 554985b1
.jshintrc 2016-07-03 19:31:04 No_avatar Alexander Schmitz Build: Split up grunt file into indiv... 25c0b785
.mailmap 2013-12-15 15:09:45 No_avatar Ghislain Seguin Release: Added mapping for patrioticcow 7a868761
.travis.yml 2016-07-04 09:32:24 No_avatar Alexander Schmitz Tests: Add jQuery 3.0.0 to version dr... 0ce624dd
AUTHORS.txt Ajax_loader_tree
CONTRIBUTING.md 2014-10-09 20:55:23 No_avatar Lisa Seacat DeLuca Contributing: Replaced the reference ... c7cad3d7
Gruntfile.js 2016-07-03 19:43:55 No_avatar Alexander Schmitz Build: Add esformatter and format bui... 6b9b2abe
LICENSE-INFO.min.txt 2016-07-03 22:42:12 No_avatar Jasper de Groot All: Removed year from copyright notice 0c7af9af

README.md

jQuery Mobile Build Status Coverage Status

jQuery Mobile is a unified, HTML5-based user interface system for all popular mobile device platforms, built on the rock-solid jQuery and jQuery UI foundation. Its lightweight code is built with progressive enhancement, and has a flexible, easily themeable design.

jQuery Mobile 1.4.x works with versions of jQuery core from 1.8.3 to 1.11.1 / 2.1.1. You can find more information about how the library works, and what it is capable of, by reading the documentation and exploring the demos. Alternatively, more information can also be found on the jquerymobile site.

Contributing

You can contribute to the project by reporting issues, suggesting new features, or submitting pull requests. Please read our Contributing Guidelines before submitting.

Build/Customization

Currently the library is shipped on the jQuery CDN/download as a single monolithic JavaScript file that depends on jQuery Core (not included) and a similarly bundled CSS file. For users we support the following build targets:

  • js - resolve dependencies, build, concat, and minify the JavaScript used for jQuery Mobile
  • css - resolve dependencies, build, concat, and minify all the css, just the structure css, and just the theme css
  • demos - build the js and css, and make the docs ready for static consumption
  • lint - Validates JavaScript files using JSHint

Download Builder

The easiest way to obtain a custom build is to use the download builder. With it, you can select the parts of the library you need and both the CSS and JavaScript dependencies will be resolved for you as a packaged/minified whole.

Requirements

Commands

With node and grunt installed you can run the default target by simply issuing the following from the project root:

npm install
grunt

JavaScript

As of version 1.1 the library uses dependency management in the JavaScript build by providing AMD modules which can be added or removed from the core mobile meta module js/jquery.mobile.js.

For example, if a user wished to exclude the form widgets to reduce the wire weight of their jQuery Mobile include they would first remove them from the meta module:

diff --git a/js/jquery.mobile.js b/js/jquery.mobile.js
index 6200fe6..3a4625c 100644
--- a/js/jquery.mobile.js
+++ b/js/jquery.mobile.js
@@ -19,12 +19,6 @@ define([
        './jquery.mobile.listview.filter',
        './jquery.mobile.listview.autodividers',
        './jquery.mobile.nojs',
-       './jquery.mobile.forms.checkboxradio',
-       './jquery.mobile.forms.button',
-       './jquery.mobile.forms.slider',
-       './jquery.mobile.forms.textinput',
-       './jquery.mobile.forms.select.custom',
-       './jquery.mobile.forms.select',
        './jquery.mobile.buttonMarkup',
        './jquery.mobile.controlGroup',
        './jquery.mobile.links',

And then run the build:

grunt build:js

CSS

To create a new theme:

  1. Copy the default folder from CSS/Themes to a new folder named after your new theme (eg, my-theme).
  2. Add customizations to the jquery.mobile.theme.css file.
  3. From the project root run the following grunt command:

    THEME=my-theme grunt build:css
    
  4. The output will be available in the $PROJECT_ROOT/dist

Again this assumes the theme css files are available in the css/themes/$THEME/ directory relative to the project root, css/themes/my-theme/ in the example.

Development

The root of the repository is also the root of the documentation and, along with the test suite, acts as the test bed for bug fixes and features. You'll need to set up a server and get the test suite running before you can contribute patches.

Server

Most of the documentation and testing pages rely on PHP 5+, and as a result Apache and PHP are required for development. You can install them using one of the following methods:

  • one-click - MAMP for OSX, XAMP for OSX/Windows
  • existing web server - eg, ~/Sites directory on OSX.
  • virtual machine - If Vagrant is installed you can add this remote/branch and vagrant up

In addition to vanilla Apache the following modules are required:

  • Rewrite (mod_rewrite.so)
  • Expire (mod_expires.so)
  • Header (mod_headers.so)

Once you have your web server setup you can point it at the project directory.

Testing

Automated testing forms the backbone of the jQuery Mobile project's QA activities. As a contributor or patch submitter you will be expected to run the test suite for the code your patches affect. Our continuous integration server will address the remainder of the test suite.

You can run all the test suites by running the following command:

grunt test

You can choose to run only a subset of the tests by adding the --suites option like:

grunt test --suites=table,slider

will only run the tests under tests/unit/table/ and tests/unit/slider/.

You can also exclude some tests by using !. For instance:

grunt test --type=integration --suites=\!navigation

will run all the integration tests but the navigation suite.

You can also specify which versions of jQuery you want to test jQuery Mobile by using the --jqueries option:

grunt test --jqueries=1.11.1,git

Additionally, jQuery Mobile's test suite is split between integration and unit tests. Where the unit tests are meant to focus on a single piece of the library (eg, a widget) and the integration tests require multiple pieces of the library to function. You can target either type by including the --types option when testing:

grunt test --types=unit
grunt test --types=integration
grunt test --types=unit,integration # default, equivalent to 'grunt test'