-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathindex.html
More file actions
284 lines (259 loc) · 12.8 KB
/
index.html
File metadata and controls
284 lines (259 loc) · 12.8 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
<!DOCTYPE html>
<html lang="zh-cn">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>文档 | 高德地图位置选择插件</title>
<!-- Bootstrap -->
<link href="http://cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet">
<link href="./dist/bootstrap.min.css" rel="stylesheet">
<style rel="stylesheet">
body{ font-family: Microsoft YaHei; padding-top:70px;}
ul.nav-tabs{
width: 140px;
margin-top: 20px;
border-radius: 4px;
border: 1px solid #ddd;
box-shadow: 0 1px 4px rgba(0, 0, 0, 0.067);
}
ul.nav-tabs li{
margin: 0;
border-top: 1px solid #ddd;
}
ul.nav-tabs li:first-child{
border-top: none;
}
ul.nav-tabs li a{
margin: 0;
padding: 8px 16px;
border-radius: 0;
}
ul.nav-tabs li.active a, ul.nav-tabs li.active a:hover{
color: #fff;
background: #0088cc;
border: 1px solid #0088cc;
}
ul.nav-tabs li:first-child a{
border-radius: 4px 4px 0 0;
}
ul.nav-tabs li:last-child a{
border-radius: 0 0 4px 4px;
}
ul.nav-tabs.affix{
top: 70px;
}
</style>
<!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries -->
<!-- WARNING: Respond.js doesn't work if you view the page via file:// -->
<!--[if lt IE 9]>
<script src="http://cdn.bootcss.com/html5shiv/3.7.2/html5shiv.min.js"></script>
<script src="./dist/html5shiv.min.js"></script>
<script src="http://cdn.bootcss.com/respond.js/1.4.2/respond.min.js"></script>
<script src="./dist/respond.min.js"></script>
<![endif]-->
</head>
<body data-spy="scroll" data-target="#mScrollspyCatalog">
<nav class="navbar navbar-default navbar-fixed-top" role="navigation">
<!-- Brand and toggle get grouped for better mobile display -->
<div class="container">
<div class="navbar-header">
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse"
data-target="#id-navbar-collapse-1" aria-expanded="false">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<a class="navbar-brand" href="javascript:">AMapPositionPicker</a>
</div>
<!-- Collect the nav links, forms, and other content for toggling -->
<div id="id-navbar-collapse-1" class="collapse navbar-collapse">
<ul class="nav navbar-nav">
<li class="active"><a href="javascript:"><span class="glyphicon glyphicon-home"></span> 首页</a></li>
<li><a href="./demo.html"><span class="glyphicon glyphicon-align-justify"></span> 示例</a></li>
</ul>
<ul class="nav navbar-nav navbar-right">
<li><a href="https://gitee.com/kinegratii/Bootstrap-AMapPositionPicker" target="_blank"><span
class="glyphicon glyphicon-list-alt"></span> 源码</a></li>
<li><a target="_blank" href="https://kinegratii.github.io/"><span class="glyphicon glyphicon-th"></span> 博客</a>
</li>
</ul>
</div><!-- /.navbar-collapse -->
</div>
</nav>
<div class="container">
<div class="row">
<div class="col-md-3" id="mScrollspyCatalog">
<ul class="nav nav-tabs nav-stacked" data-spy="affix" data-offset-top="0">
<li class="active"><a href="#n_useage">使用</a></li>
<li><a href="#n_options">选项</a></li>
<li><a href="#n_method">方法</a></li>
<li><a href="#n_event">事件</a></li>
<li><a href="#n_tool">工具</a></li>
<li><a href="#n_licence">协议</a></li>
</ul>
</div>
<div class="col-md-9">
<div class="jumbotron">
<h2>高德地图位置选择器</h2>
<p>高德地图位置选择表单组件</p>
<p><a class="btn btn-primary" target="_blank"
href="https://gitee.com/kinegratii/Bootstrap-AMapPositionPicker" role="button">下载</a> <small
id="id_latest_version"></small></p>
</div>
<div class="page-header" id="n_useage">
<h1>使用</h1>
</div>
<p>AMapPositionPicker是一款基于高德地图的位置选择插件，使用jQuery开发，提供了以下特性：</p>
<ul>
<li>data-*属性配置</li>
<li>初始位置数据</li>
<li>浏览器定位</li>
<li>字段显示格式、验证</li>
<li>数据控件绑定</li>
<li>支持地理逆编码</li>
<li>自定义Modal外观样式</li>
</ul>
<h3>使用步骤</h3>
<p>1. 依次引入高德地图JS、jQuery、Bootstrap和bootstrap.AMapPositionPicker.min.js文件。</p>
<pre>
<script type="text/javascript" src="http://webapi.amap.com/maps?v=1.3&key=您申请的key值"></script>
<script type="text/javascript" src="http://cdn.bootcss.com/jquery/1.11.1/jquery.min.js"></script>
<script type="text/javascript" src="http://cdn.bootcss.com/bootstrap/3.3.6/js/bootstrap.min.js"></script>
<script type="text/javascript" src="./dist/bootstrap.AMapPositionPicker.min.js"></script></pre>
<p>2. 在目标输入框初始化选项。</p>
<p>html代码</p>
<pre>
<input type="text" id="id_address_input" name="address"/></pre>
<p>JS代码</p>
<pre>
$("#id_address_input").AMapPositionPicker();</pre>
<p>3 运行效果</p>
<div class="panel panel-default">
<div class="panel-body">
<form role="form">
<div class="form-group">
<label for="id_address_input">地址</label>
<input type="text" class="form-control" id="id_address_input" name="address"/>
</div>
<button id="id_get_data" type="button" class="btn btn-default">获取当前数据</button>
<p id="id_data_dispaly"></p>
</form>
</div>
</div>
<div class="page-header" id="n_options">
<h1>选项</h1>
</div>
<p>使用 <code>$(element).AMapPositionPicker(options)</code> 初始化一个位置选择器。</p>
<h3>required</h3>
<p>boolean. 默认值：true. data属性：<code>data-required</code></p>
<p>是否为必填项。</p>
<h3>formatter</h3>
<p>String. 默认值：'{address}'. data属性：<code>data-formatter</code></p>
<p>目标输入框的位置格式字符串，可用的变量包括longitude、latitude、address。使用时用<code>{}</code>将变量包裹起来，并且二者之间不能含有空格。</p>
<h3>value</h3>
<p>Position,object. 默认值： null. data属性：<code>data-value-*</code></p>
<p>初始位置数据。例如可设置为<code>{longitude:119.300939, latitude:26.075302, address:'测试地址', label:'测试地点'}</code>。</p>
<h3>center</h3>
object.默认值：null.data属性：<code>data-center-*</code>
<p>地图中心位置经纬度，用于未选择位置时地图中心位置，默认为当前城市的中心位置。</p>
<h3>title</h3>
<p>String. 默认值：'请选择地址'. data属性：<code>data-title</code></p>
<p>Modal标题名称。</p>
<h3>errorTip</h3>
<p>String. 默认值：'请选择地址'. data属性：<code>data-error-tip</code></p>
<p>未选择位置的错误提示文字。</p>
<h3>height</h3>
<p>String. 默认值：'500px'. data属性：<code>data-height</code></p>
<p>地图控件的高度。宽度按照Modal自适应设置。</p>
<h3>fields</h3>
<p>Array. 默认值：[]</p>
<p>数据绑定选项，用于提交表单中多字段的情况。列表中每一项映射到一个<code><input/></code>控件（若不存在就自动创建）。</p>
<pre>
{
selector:'#id_lnglat', //选择器
name:'lnglat', //name属性值
formatter:'{longitude},{latitude}' //value的格式字符串
}</pre>
<h3>onPicked <small><span class="label label-danger">废弃</span></small></h3>
<p class="text-muted"><span class="glyphicon glyphicon-info-sign" aria-hidden="true"></span>
此项已废弃，将在v1.0时移除。</p>
<p>函数签名:<code>function(position, hasPicked);</code>。选择完成事件处理函数。参数参见事件 <code>AMPP.PickCompleted</code>。</p>
<div class="page-header" id="n_method">
<h1>方法</h1>
</div>
<p><code>$(element).AMapPositionPicker(methodString, ...args)</code></p>
<p>所有方法按照上述方式调用。</p>
<h3>position</h3>
<p>返回类型：Position。返回当前选择的位置。</p>
<h3>getInitialPosition</h3>
<p>返回类型：Position。返回初始位置。</p>
<div class="page-header" id="n_event">
<h1>事件</h1>
</div>
<p>所有的事件均使用 <code>AMPP</code> 命名空间。</p>
<h3>AMPP.PickCompleted</h3>
<p>函数签名：<code>function(e, position, hasPicked){}</code>。选择完成事件处理函数。</p>
<p>参数</p>
<ul>
<li>e:事件对象。</li>
<li>position:位置对象。</li>
<li>hasPicked：表明是否已经选择了一个位置。通常用于非必填项(<code>required=false</code>)的情况。</li>
</ul>
<div class="page-header" id="n_tool">
<h1>工具</h1>
</div>
<p>位置选择插件提供了若干个工具函数和变量。调用形式为 <code>$.AMapPositionPicker.FOO( ...args)</code> 或者 <code>$.AMapPositionPicker.FOO</code>
。</p>
<h3>showPositionInMap</h3>
<p>函数签名：<code>showPositionInMap(position)</code>；在地图上显示点标记。</p>
<p>参数</p>
<ul>
<li>position:位置对象。</li>
</ul>
<h3>pluginVersion</h3>
<p>插件版本字符串常量，如 <code>1.0.0</code>。</p>
<div class="page-header" id="n_licence">
<h1>协议</h1>
</div>
<p>本项目采用<a href="https://opensource.org/licenses/mit-license.php" target="_blank">MIT协议</a>开源。</p>
</div>
</div>
</div>
<footer class="footer">
<div class="container">
<hr/>
<div class="row">
<div class="col-md-4 col-md-offset-1">
<p>© kinegratii 2016-2017<br/>
<a href="https://gitee.com/kinegratii/Bootstrap-AMapPositionPicker" target="_blank">源码</a>
| <a target="_blank" href="https://kinegratii.github.io/">博客</a>
| <a target="_blank" href="mailto:kinegratii@yeah.net">邮箱</a></p>
</div>
<div class="col-md-4 col-md-offset-2">
<p>本页面由<a href="https://gitee.com/" target="_blank">码云Pages</a>强力驱动。<br/>
CDN服务由<a href="http://www.bootcdn.cn/" target="_blank">BootCDN</a>提供。</p>
</div>
</div>
</div>
</footer>
<!-- jQuery (necessary for Bootstrap's JavaScript plugins) -->
<script src="http://cdn.bootcss.com/jquery/1.11.1/jquery.min.js"></script>
<script src="./dist/jquery.min.js"></script>
<!-- Include all compiled plugins (below), or include individual files as needed -->
<script src="http://cdn.bootcss.com/bootstrap/3.3.7/js/bootstrap.min.js"></script>
<script src="./dist/bootstrap.min.js"></script>
<script src="http://webapi.amap.com/maps?v=1.3&key=ed1fafa0307bb4991da41f54d8a88b46&plugin=AMap.CitySearch,AMap.Autocomplete"></script>
<script src="./dist/bootstrap.AMapPositionPicker.js"></script>
<script type="text/javascript">
$(document).ready(function(){
$("#id_latest_version").html('最新版本 v' + $.AMapPositionPicker.pluginVersion);
var p1 = $("#id_address_input").AMapPositionPicker();
$("#id_get_data").on('click', function(){
$("#id_data_dispaly").html(JSON.stringify(p1.AMapPositionPicker('position')));
});
});
</script>
</body>
</html>