jQuery TOOLS/Expose - Make your HTML elements stand out
16501 ワード
Keywords:expose html,expose html jquery,javascript expose,stand out html javascript,javascript expose plugin
Description:Make your HTML elements stand out
Start entering text on the input fields below and you'll see the masking effect: Username
Password
Expose is a JavaScript tool that exposes selected HTML elements on the page so that the surrounding elements will gradually fade out. The exposing effect was first introduced in the overlay tool. Usually the effect is an integral part of the program and cannot be used separately. This tool takes the idea of exposing a little further. It is a separate tool that can be used as a general purpose masking utility. You can use it for overlays, forms, images, videos or Flash objects. You can use CSS to tweak the look of the mask.
Here are some most common ways of using the mask:
There are two different calls: mask and expose. The mask method is only available for the document object and you cannot use any other selector. The expose() method can take any jQuery selector and all elements returned by the selector are placed on top of the mask.
The mask is loaded immediately after the expose or mask call. You can supply a different configuration on each call and the latest call is remembered. A subsequent expose call for example will use the previously used configuration if no arguments are given.
You can also use an existing element as a mask. By default the tool uses an element whose id is exposeMask and if it does not exist already exist then it will be created automatically.
We believe that the best way to learn is through demos. The following demos are fully documented and a standalone page is provided to get mask working on your site. It's really important to study the first demo "Minimal setup for mask"because it teaches you the basics of using the library.
Minimal setup for expose
Styling the mask with a background image
Exposing a form
Exposing videos with a custom mask
These demos show how to use a video player together with the mask tool:
Exposing video upon mouseover
Exposing videos
Custom fullscreen action with overlay and mask
Email and embed features with overlay and mask
You can use our graphics as the basis for your design. You can freely change the design as you see fit. Click the image on the right to download a zip file. Before using the graphics, you should consult the User's Guide on how graphics can be used when designing the look and feel of the tools.
Here are a few examples of what is included in the zip file:
Here is a full list of available configuration options:
property default description
closeOnClick
Specifies whether the masking disappears when the mask is clicked. By default, this is set to true.
closeOnEsc
Specifies whether masking disappears when the ESC key is pressed from the keyboard. By default, this is set to true.
closeSpeed
How quickly the mask disappears. Possible values are 'slow', 'normal' and 'fast or you can supply the number of milliseconds. For example, a value of 2000 will cause the mask to disappear in 2 seconds. By setting this to zero there is no animation and the mask disappears immediately.
color
The background color of the mask. This will dramatically affect how it appears. If you supply a value of null here, you can control the background color with CSS. See themaskId property below for more information.
loadSpeed
How quickly the mask will appear. Possible values are 'slow', 'normal' and 'fast or you can supply the number of milliseconds. For example, a value of 2000 will cause the mask to appear in 2 seconds. By setting this to zero there is no animation and the mask appears immediately.
maskId
The mask is a normal div element placed on top of your page and whose size is automatically adjusted to cover the user's screen completely. You can style it normally with CSS just like any other element on the page. By default, the mask's id is set to mask, but you can change that with tis configuration option. Since version 1.2.0 you can use an existing element as the mask if it's id matches the one given in this configuration option.
opacity
The transparency setting of the mask. A decimal value from 0 to 1. A bigger value means less transparency while a value of 0 is fully transparent (invisible).
startOpacity
since 1.2.0. The initial transparency level of the mask before it starts fading in to the desired opacity as specified by the opacity option. A decimal value from 0 to 1. A bigger value means less transparency while a value of 0 is fully transparent (invisible). For example, you can start with full opacity and gradually fade to a semi-transparent mask.
zIndex
This is the z-index CSS property for the mask. The zIndex specifies the placement of the element along the z-axis of the document. The default zIndex value is very high, so it is unlikely that you will need to alter it; however, this value must be greater than the z-index of any other element on the page so that the overlay will always be visible when called.
onBeforeLoad
This callback function is triggered before the masking effect. Returning false or callingevent.preventDefault() in the callback prevents masking from occurring.
onLoad
This callback function is triggered after masking takes place.
onBeforeClose
This callback function is triggered before mask is closed. Returning false or callingevent.preventDefault() in the callback prevents it from closing.
onClose
This callback function is triggered when mask is closed.
Here is an example of an onBeforeLoad callback function given in configuration. Inside any callback function the this variable is a pointer to the mask scripting API .
Note: unlike other jQuery Tools you can supply callbacks only from the configuration and you can assign only one callback for the same event.
Unlike other jQuery Tools in this library the mask is a singleton. Only one mask instance can exist at any given time. This singleton can be accessed directly with $.mask or via the this variable inside callback functions.
method return value description/example
close()
Closes the mask.
fit()
Forces the mask to fill the whole document. This is usually not needed since the tool itself does this. You'll need this on occasions when the mask is loaded and your document has grown in size in the meantime.
isLoaded(fully)
Returns true if mask is loaded. Since 1.2.4 you can supply a boolean argument that makes sure that the function returns true only if the mask is fully visible in it's final position and opacity.
getMask()
Returns the mask as a jQuery object. You can use jQuery methods such as css oranimate to modify it.
getExposed()
Returns exposed elements (if any) as a jQuery object.
getConf()
Returns the masking configuration.
原文住所:http://flowplayer.org/tools/toolbox/expose.html
Description:Make your HTML elements stand out
Demo
Start entering text on the input fields below and you'll see the masking effect: Username
Password
The story
Expose is a JavaScript tool that exposes selected HTML elements on the page so that the surrounding elements will gradually fade out. The exposing effect was first introduced in the overlay tool. Usually the effect is an integral part of the program and cannot be used separately. This tool takes the idea of exposing a little further. It is a separate tool that can be used as a general purpose masking utility. You can use it for overlays, forms, images, videos or Flash objects. You can use CSS to tweak the look of the mask.
Usage
Here are some most common ways of using the mask:
// place a white mask over the page
$(document).mask();
// place a custom colored mask over the page
$(document).mask("#789");
// place a non-closable mask
$(document).mask{ closeOnEsc: false, closeOnClick: false });
// place a mask but let selected elements show through (expose)
$("div.to_be_exposed").expose();
// close the mask
$.mask.close();
There are two different calls: mask and expose. The mask method is only available for the document object and you cannot use any other selector. The expose() method can take any jQuery selector and all elements returned by the selector are placed on top of the mask.
The mask is loaded immediately after the expose or mask call. You can supply a different configuration on each call and the latest call is remembered. A subsequent expose call for example will use the previously used configuration if no arguments are given.
You can also use an existing element as a mask. By default the tool uses an element whose id is exposeMask and if it does not exist already exist then it will be created automatically.
Demos
We believe that the best way to learn is through demos. The following demos are fully documented and a standalone page is provided to get mask working on your site. It's really important to study the first demo "Minimal setup for mask"because it teaches you the basics of using the library.
Minimal setup for expose
Styling the mask with a background image
Exposing a form
Exposing videos with a custom mask
Expose and Flowplayer demos
These demos show how to use a video player together with the mask tool:
Exposing video upon mouseover
Exposing videos
Custom fullscreen action with overlay and mask
Email and embed features with overlay and mask
Mask Graphics
You can use our graphics as the basis for your design. You can freely change the design as you see fit. Click the image on the right to download a zip file. Before using the graphics, you should consult the User's Guide on how graphics can be used when designing the look and feel of the tools.
Here are a few examples of what is included in the zip file:
Configuration
Here is a full list of available configuration options:
property default description
closeOnClick
true
Specifies whether the masking disappears when the mask is clicked. By default, this is set to true.
closeOnEsc
true
Specifies whether masking disappears when the ESC key is pressed from the keyboard. By default, this is set to true.
closeSpeed
'fast'
How quickly the mask disappears. Possible values are 'slow', 'normal' and 'fast or you can supply the number of milliseconds. For example, a value of 2000 will cause the mask to disappear in 2 seconds. By setting this to zero there is no animation and the mask disappears immediately.
color
'#fff'
The background color of the mask. This will dramatically affect how it appears. If you supply a value of null here, you can control the background color with CSS. See themaskId property below for more information.
loadSpeed
'slow'
How quickly the mask will appear. Possible values are 'slow', 'normal' and 'fast or you can supply the number of milliseconds. For example, a value of 2000 will cause the mask to appear in 2 seconds. By setting this to zero there is no animation and the mask appears immediately.
maskId
'exposeMask'
The mask is a normal div element placed on top of your page and whose size is automatically adjusted to cover the user's screen completely. You can style it normally with CSS just like any other element on the page. By default, the mask's id is set to mask, but you can change that with tis configuration option. Since version 1.2.0 you can use an existing element as the mask if it's id matches the one given in this configuration option.
opacity
0.8
The transparency setting of the mask. A decimal value from 0 to 1. A bigger value means less transparency while a value of 0 is fully transparent (invisible).
startOpacity
0
since 1.2.0. The initial transparency level of the mask before it starts fading in to the desired opacity as specified by the opacity option. A decimal value from 0 to 1. A bigger value means less transparency while a value of 0 is fully transparent (invisible). For example, you can start with full opacity and gradually fade to a semi-transparent mask.
zIndex
9998
This is the z-index CSS property for the mask. The zIndex specifies the placement of the element along the z-axis of the document. The default zIndex value is very high, so it is unlikely that you will need to alter it; however, this value must be greater than the z-index of any other element on the page so that the overlay will always be visible when called.
onBeforeLoad
This callback function is triggered before the masking effect. Returning false or callingevent.preventDefault() in the callback prevents masking from occurring.
onLoad
This callback function is triggered after masking takes place.
onBeforeClose
This callback function is triggered before mask is closed. Returning false or callingevent.preventDefault() in the callback prevents it from closing.
onClose
This callback function is triggered when mask is closed.
Here is an example of an onBeforeLoad callback function given in configuration. Inside any callback function the this variable is a pointer to the mask scripting API .
$("#mydiv").expose({
// before masking begins ...
onBeforeLoad: function(event) {
// grow the exposed elements smoothly by 100 pixels
this.getExposed().animate({width: '+=100'});
}
});
Note: unlike other jQuery Tools you can supply callbacks only from the configuration and you can assign only one callback for the same event.
Scripting API
Unlike other jQuery Tools in this library the mask is a singleton. Only one mask instance can exist at any given time. This singleton can be accessed directly with $.mask or via the this variable inside callback functions.
Method listing
method return value description/example
close()
API
Closes the mask.
fit()
API
Forces the mask to fill the whole document. This is usually not needed since the tool itself does this. You'll need this on occasions when the mask is loaded and your document has grown in size in the meantime.
isLoaded(fully)
boolean
Returns true if mask is loaded. Since 1.2.4 you can supply a boolean argument that makes sure that the function returns true only if the mask is fully visible in it's final position and opacity.
getMask()
jQuery
Returns the mask as a jQuery object. You can use jQuery methods such as css oranimate to modify it.
getExposed()
jQuery
Returns exposed elements (if any) as a jQuery object.
getConf()
Object
Returns the masking configuration.
原文住所:http://flowplayer.org/tools/toolbox/expose.html