Skip to content

Commit d41edbd

Browse files
committed
Additional work on changing map state via scripting.
1 parent dd0fcf1 commit d41edbd

File tree

1 file changed

+27
-6
lines changed

1 file changed

+27
-6
lines changed

index.html

+27-6
Original file line numberDiff line numberDiff line change
@@ -5341,18 +5341,34 @@ <h5>Conclusion</h5>
53415341
</ul>
53425342
</section>
53435343

5344-
<section id="capability-pan-map-or-re-centre-map" data-ucr-role="capability">
5345-
<h4>Pan a map or re-centre a map</h4>
5344+
<section id="capability-pan-zoom-or-re-centre-map" data-ucr-role="capability">
5345+
<h4>Pan, zoom or re-centre a map</h4>
53465346
<p>
5347-
Description to follow
5347+
Developers expect to be able to control a map by changing its centre and/or zoom level,
5348+
and may also wish to support the capability of resetting a map to its view as originally presented.
5349+
If the map view cannot be dynamically modified by an application,
5350+
as opposed to changes by direct user interaction with the map,
5351+
then it offers fewer advantages over a static map view.
5352+
</p>
5353+
<p>
5354+
It is usually also desirable that such changes can be accomplished in a manner that gives sufficient
5355+
visual feedback to the user that a change is occurring,
5356+
for example by animating the transition rather than simply redrawing the map with the new view,
5357+
which may not be immediately noticeable to the user.
5358+
</p>
5359+
<p>
5360+
Accessibility is an important consideration when the state of a map is altered dynamically.
5361+
Thought should be given to how the change can be made known to assistive technologies so that the user
5362+
is fully informed and thus cognisant of the current state of the map at all times.
53485363
</p>
53495364
<p class="issue discussion" data-number="67">
53505365
Discuss this section on GitHub.
53515366
</p>
53525367

53535368
<h5>Existing implementations</h5>
53545369
<p>
5355-
Existing implementation support:
5370+
All the reviewed JavaScript API implementations support changing the bounds, centre, and zoom level of a map,
5371+
and allow such transitions to be animated.
53565372
</p>
53575373
<dl data-ucr-role="implementation-notes">
53585374
<!-- Use dt elements to name the implementation, using the id string to create an auto-link.
@@ -5368,8 +5384,12 @@ <h5>Existing implementations</h5>
53685384
<dt>leaflet-api</dt>
53695385
<dt>open-layers-api</dt>
53705386
<dt>d3-geographies-api</dt>
5371-
<dd><a>not applicable</a>:
5387+
<dd><a>full support</a>:
53725388
<!-- details about what is/isn't supported -->
5389+
<p>
5390+
Animated transitions are supported by calling specific methods with names such as <code>flyTo</code>
5391+
or via a Boolean parameter to a more general method such as <code>setView</code>.
5392+
</p>
53735393
</dd>
53745394
</dl>
53755395

@@ -5394,7 +5414,8 @@ <h5>Conclusion</h5>
53945414
See examples.
53955415
-->
53965416
<p>
5397-
Based on the limited data, we are <a data-ucr-role="conclusion">undecided</a> about whether this should be a requirement.
5417+
As this is capability is required for any dynamic update of a map view such as would be expected of a map-based application,
5418+
it is a <a data-ucr-role="conclusion">requirement</a> for embedded web maps.
53985419
</p>
53995420
<ul data-ucr-role="conclusion-notes">
54005421
<!-- bullet-point notes summarizing implementation details / blocking issues.

0 commit comments

Comments
 (0)