ax5ui-picker
Version:
A picker plugin that works with Bootstrap & jQuery
106 lines (85 loc) • 4.21 kB
Markdown
[](https://travis-ci.org/ax5ui/ax5ui-picker)
[](https://badge.fury.io/js/ax5ui-picker)
[](https://www.npmjs.com/package/ax5ui-picker)
# ax5ui-picker
"picker" provides users a simple way to select a single value from a pre-determined set of values.
> *Dependencies*
> * _[jQuery 1.X+](http://jquery.com/)_
> * _[ax5core](http://ax5.io/ax5core)_
> * _[bootstrap](http://getbootstrap.com/)_
> * _[ax5calendar](http://ax5.io/ax5calendar)_
> * _[ax5formatter](http://ax5.io/ax5formatter)_
### Install with bower
```sh
bower install ax5ui-picker
```
[bower](http://bower.io/#install-bower) is web front-end package manager.
When you install `bower`, it will be installed under the `bower_components` folder to resolve the plug-in dependencies.
(You can change the folder location. [.bowerrc](http://bower.io/docs/config/#bowerrc-specification) )
It is recommended that you install by using `bower`.
If you've never used bower, please refer to [http://bower.io/#install-bower](http://bower.io/#install-bower).
### Install with npm
If you do not use bower, it also can be installed by using npm as an alternative.
In case of npm, which is the package manager for the front end, you need to solve the problem of plug-in dependencies.
```sh
npm install jquery
npm install ax5core
npm install ax5ui-calendar
npm install ax5ui-formatter
npm install ax5ui-picker
```
After downloading the install file of npm, you will need to copy it to the location where you want to use as a resource for the project.
If the copy process is inconvenient, it also can be done easily by using `gulp` or `grunt`.
### Download code
- [ax5core Github releases](https://github.com/ax5ui/ax5core/releases)
- [ax5ui-picker Github releases](https://github.com/ax5ui/ax5ui-picker/releases)
### Insert "ax5picker" in HTML HEAD.
Folder location can be any for your project. However, please be sure to assign the right path in the project.
```html
<link rel="stylesheet" type="text/css" href="https://cdn.rawgit.com/ax5ui/ax5ui-picker/master/dist/ax5picker.css" />
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/1.12.4/jquery.min.js"></script>
<script type="text/javascript" src="https://cdn.rawgit.com/ax5ui/ax5core/master/dist/ax5core.min.js"></script>
<script type="text/javascript" src="https://cdn.rawgit.com/ax5ui/ax5ui-calendar/master/dist/ax5calendar.min.js"></script>
<script type="text/javascript" src="https://cdn.rawgit.com/ax5ui/ax5ui-formatter/master/dist/ax5formatter.min.js"></script>
<script type="text/javascript" src="https://cdn.rawgit.com/ax5ui/ax5ui-picker/master/dist/ax5picker.min.js"></script>
```
**CDN urls**
This is a list of CDN urls for ax5ui-picker. ax5ui offers the CDN services through rawgit.
```
https://cdn.rawgit.com/ax5ui/ax5ui-picker/master/dist/ax5picker.css
https://cdn.rawgit.com/ax5ui/ax5ui-picker/master/dist/ax5picker.js
https://cdn.rawgit.com/ax5ui/ax5ui-picker/master/dist/ax5picker.min.js
```
### Basic Usage
```html
<div class="input-group" id="pickerTarget">
<input type="text" class="form-control" placeholder="" />
<span class="input-group-addon"><i class="fa fa-calendar-o"></i></span>
</div>
```
```js
var picker = new ax5.ui.picker();
picker.bind({
target: $("#pickerTarget"),
direction: "top",
contentWidth: 200,
content: function (callback) {
var html = ''
+ 'picker contents'
+ '<div style="padding: 10px;">'
+ '<button class="btn btn-default">FN 1</button>'
+ '</div>'
;
callback(html);
}
});
```
***
### Preview
- [See Demonstration](http://ax5.io/ax5ui-picker/demo/index.html)
If you have any questions, please refer to the following [gitHub](https://github.com/ax5ui/ax5ui-kernel)
## Question
- https://jsdev.kr/c/axisj/ax5ui
- https://github.com/ax5ui/ax5ui-kernel/issues
[](https://github.com/axisj)
