Skip to content

Commit d058dfb

Browse files
committed
Updating for 1.0b2
1 parent 34e4f03 commit d058dfb

File tree

2 files changed

+54
-28
lines changed

2 files changed

+54
-28
lines changed

_includes/builder.html

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,11 @@ <h4><a href="#dom_helpers">DOM HELPERS</a> - faster and easier DOM manipulation
2121
<a href="#dimensions">jQuery.dimensions</a> - set and animate innerWidth and outerWidth
2222
</label>
2323

24+
<label>
25+
<input type="checkbox" value="jquery/dom/fills" name="plugins"/>
26+
<a href="#fills">jQuery.fills</a> - Makes an element fill out its parent
27+
</label>
28+
2429
<label>
2530
<input type="checkbox" value="jquery/dom/form_params" name="plugins"/>
2631
<a href="#formparams">jQuery.formParams</a> - serializes a form into an object

index.md

Lines changed: 49 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
layout: default
3-
version: 1.0b
3+
version: 1.0b2
44
---
55

66
# Hi, I'm jQuery++.
@@ -43,21 +43,21 @@ after jQuery 1.7 like:
4343

4444
### Using individual files
4545

46-
The [full download](https://github.com/downloads/jupiterjs/jquerypp/jquerypp-{{page.version}}.zip) contains
47-
each plugin as a separate file. At the top of each file you will find a list of dependencies that need to be included first.
48-
For example, `jquery.animate.js` depends on `jquery.styles.js` so it needs to be loaded like this:
46+
The `jquerypp.js` file from the [full download](https://github.com/downloads/jupiterjs/jquerypp/jquerypp-{{page.version}}.zip)
47+
contains all jQuery++ plugins in a single file:
4948

5049
{% highlight html %}
5150
<script src="lib/jquery.1.7.2.js"></script>
52-
<script src="lib/jquery.styles.js"></script>
53-
<script src="lib/jquery.animate.js"></script>
51+
<script src="lib/jquerypp.js"></script>
5452
{% endhighlight %}
5553

56-
You can also use `jquerypp.js` which contains all jQuery++ plugins in a single file:
54+
The `lib` folder contains each plugin as a separate file. There is a list of dependencies that need to be included first
55+
at the top of each file. For example, `jquery.animate.js` depends on `jquery.styles.js` so it needs to be loaded like this:
5756

5857
{% highlight html %}
5958
<script src="lib/jquery.1.7.2.js"></script>
60-
<script src="lib/jquerypp.js"></script>
59+
<script src="lib/jquery.styles.js"></script>
60+
<script src="lib/jquery.animate.js"></script>
6161
{% endhighlight %}
6262

6363
### Using Steal
@@ -209,6 +209,24 @@ The following example lets you change the different width properties used by `$(
209209

210210
<iframe style="width: 100%; height: 500px" src="http://jsfiddle.net/5ZbSH/embedded/result,html,js,css" allowfullscreen="allowfullscreen" frameborder="0">JSFiddle</iframe>
211211

212+
## fills `$(element).fills([parent]) -> jQuery`
213+
214+
[Annotated source](http://donejs.com/jquery/docs/jquery.fills.html)
215+
216+
[jQuery.fills](http://donejs.com/docs.html#!jQuery.fills) adds `$.fn.fills` to make an element fill out a parent element.
217+
It takes care of any padding, margins and dimensions of other sibling elements and will update the dimensions when the parent
218+
[resizes](#resize). You can either pass a parent selector or jQuery element or an object with the following options:
219+
220+
- __parent__ - The parent element selector or jQuery element
221+
- __className__ - The class name to add to the element. Not set by default
222+
- __all__ - Restore the parent element to its original size first
223+
224+
`jQuery.fills` is extremely useful for complex layouts especially since it also takes care of elements that wrap automatically.
225+
Resize the container in the following example using the blue square to see how the `#fill` element adjusts its size correctly
226+
to fill out the remaining space:
227+
228+
<iframe style="width: 100%; height: 350px" src="http://jsfiddle.net/HSWTA/embedded/result,html,js,css" allowfullscreen="allowfullscreen" frameborder="0">JSFiddle</iframe>
229+
212230
## formParams `$(form).formParams([convert]) -> Object|jQuery`
213231

214232
[Annotated source](http://donejs.com/jquery/docs/jquery.form_params.html)
@@ -777,26 +795,25 @@ Steal as submodules that are used to generate the documentation and build the jQ
777795

778796
### Installing
779797

780-
1. `fork` [jquerypp on github](https://github.com/jupiterjs/jquerypp).
781-
2. Clone DoneJS with:
782-
783-
git clone [email protected]:jupiterjs/donejs
784-
785-
3. Open the donejs folder's .gitmodule file and change the URL of the `"jquery"` submodule:
786-
787-
url = git://github.com/jupiterjs/jquerypp.git
798+
1. Clone DoneJS with:
788799

789-
to your `fork`ed URL like
800+
git clone git://github.com/jupiterjs/donejs
790801

791-
url = git://github.com/justinbmeyer/jquerypp.git
792-
793-
4. Install all submodules by running
802+
2. Install all submodules by running
794803

795804
cd donejs
796805
git submodule update --init --recursive
797806

798807
Depending on your version of git, you might need to cd into each submodule and run `git checkout`.
799808

809+
3. Fork [jquerypp](https://github.com/jupiterjs/jquerypp) on Github
810+
811+
4. Add your own fork as a remote in the `jquery` submodule:
812+
813+
cd jquery
814+
git checkout master
815+
git remote add fork [email protected]:<username>/jquerypp.git
816+
800817
### Developing
801818

802819
After [installing](#developing_jquery__-installing) jQuery++ and DoneJS, you'll find
@@ -816,6 +833,7 @@ To develop jQuery++:
816833
2. Add tests to the _plugin\_test.js_ test file.
817834
3. Open the plugin test page `qunit.html` or `funcunit.html` and make sure everything passes
818835
4. Open the big test page in `jquery/qunit.html` and make sure all tests pass
836+
5. Commit your changes and push to your fork (`git push fork <branch>`)
819837
5. Submit a pull request!
820838

821839
### Documentation
@@ -828,9 +846,9 @@ To edit the documentation at [DoneJS.com](http://doneJS.com/docs.html):
828846

829847
1. [install](#developing_jquery__-installing) jQuery++ and DoneJS.
830848
2. Edit the markdown and js files in the `jquery` folder.
831-
3. Generate the docs with:
849+
3. In the `donejs` root folder generate the docs with:
832850

833-
js site/scripts/doc.js
851+
./js site/scripts/doc.js
834852

835853
View them at `site/docs.html`
836854

@@ -845,7 +863,6 @@ To make a jQuery++ build, run:
845863
It puts the downloads in `jquery/dist`. To build a specific version check out the [git tag](https://github.com/jupiterjs/jquerypp/tags)
846864
you want to build and run the above command.
847865

848-
<!--
849866
### List of heroes
850867

851868
The following lists everyone who's contributed something to CanJS. If we've forgotten you, please add yourself.
@@ -856,16 +873,20 @@ and [jQueryMX](https://github.com/jupiterjs/jquerymx/contributors), and the peop
856873

857874
[callumacrae](https://github.com/callumacrae) - [Width property for jQuery.selection](https://github.com/jupiterjs/jquerypp/pull/11) and documentation fixes.
858875
[fabianonunes](https://github.com/fabianonunes) - Fixed several errors in the build process.
859-
-->
860876

861877
### Change Log
862878

863-
<!--
864879
__1.0 Beta 2__
865880

866-
- change: [Added width property to jQuery.selection](https://github.com/jupiterjs/jquerypp/commit/38a3d76bed35684e5b9551f179d0772a908544db)
867-
- fix: [Security error in jQuery.animate](https://github.com/jupiterjs/jquerypp/commit/5896c02e16dbe3c331939c81d4fe942d38470c93)
868-
-->
881+
- feature: [Key mapping tool for jQuery.event.key for international characters](https://github.com/jupiterjs/jquerypp/issues/16)
882+
- fix: [jQuery.formParams converts disabled fields](https://github.com/jupiterjs/jquerypp/issues/24)
883+
- fix: [jQuery.animate supports all parameters](https://github.com/jupiterjs/jquerypp/issues/22)
884+
- change: [jQuery.event.drag supports touch events](https://github.com/jupiterjs/jquerypp/issues/23)
885+
- feature: [Added jQuery.fills](http://jquerypp.com/#fills)
886+
- fix: [jQuery.animate .stop() doesn't work](https://github.com/jupiterjs/jquerypp/issues/19)
887+
- fix: [Bug with duplicate sub keys](https://github.com/jupiterjs/jquerypp/issues/17)
888+
- change: [Added width property to jQuery.selection](https://github.com/jupiterjs/jquerypp/pull/11)
889+
- fix: [Security error in jQuery.animate](https://github.com/jupiterjs/jquerypp/issues/5)
869890

870891
__1.0 Beta__ (June 1st 2012)
871892

0 commit comments

Comments
 (0)