ixmaps-gl 0.2.25 → 0.2.31

package/README.md

@@ -124,7 +124,7 @@ circle/square/diamond/triangle. See the top-of-file comment in
 A page's `.require(url)` scripts (page code, e.g. a user chart function) load in order before the
 layers are built. `ixmaps.map()` is the map handle as in flat — its calls wait until the map is ready —
 with `add(theme, flags)` / `replace` / `replaceTheme` / `remove`, `changeThemeStyle` for any style key,
-`getZoom()` (flat's zoom), `resize()`, `attribution(text)` (the page's attribution, bottom left on the map as in flat, in the style of the basemap credit and on its line — also
+`getZoom()` (flat's zoom), `resize()`, `attribution(text)` (the page's attribution, bottom left on the map as in flat, in the style of the basemap credit and on its line, dark on a dark map like the zoom buttons — also
 `.attribution()` on the builder, the `attribution` map option and `ixmaps.setAttribution(text)`; the basemap's credit stays bottom right), `setBasemapOpacity` and `setMapType(id)` (also `setMapTypeId`, `mapType`: a basemap name reading dark/black/night/matter loads CARTO Dark Matter, any other name CARTO Positron, a color a plain background — the same rule the `mapType` option follows at start); the page's `htmlgui_onNewTheme(id)` and
 `htmlgui_onZoomAndPan()` (also once on load) are called (as in flat, a theme swapped in with `replace` comes last
 in the legend, while FEATURE and CHOROPLETH shapes always draw under the charts), and `map`, `getZoom` and flat's
@@ -224,10 +224,23 @@ but unused. It never mutates the page's own objects. Unit tests: `cd test && npm
 
 ### World copies
 
-At an extreme zoom-out MapLibre repeats the world side by side, and the themes are repeated on
-every copy (flat repeats only its basemap tiles). `.options({worldcopies: false})` draws the
-world once, but MapLibre then also stops the zoom-out where the world gets narrower than the
-window.
+At an extreme zoom-out MapLibre repeats the world side by side. The themes are drawn once, as in
+flat (which repeats only its basemap tiles): the map pans freely past the world's edge, with empty
+space beside it. `.options({themecopies: true})` (also at runtime) repeats the themes on every world
+copy. `.options({worldcopies: false})` draws the world once for the map itself, but MapLibre then
+also stops the zoom-out where the world gets narrower than the window.
+
+### Click to action
+
+flat's click-to-action (`ui/js/tools/tooltip_to_action.js`, e.g. a click on a country filters every
+theme of the page to it) works as on flat: on a click on an item the engine calls the page's
+`ixmaps.onItemAction(szId, item, themeObj)`, `item.szSelectionId` being the value of the theme's
+selection field, and `ixmaps.onItemAction(null, null)` on a click on the map background. The
+selection field, `getThemeObj(id).szSelectionField`, is the `id` binding, else the position (or
+lookup) field; an aggregated item gives its first record's value. The flat script's own
+`htmlgui_onItemClick`, which reads flat's SVG, is not called — the page only needs
+`.require(".../tooltip_to_action.js")` (or its own `ixmaps.onItemAction`). The click still pins the
+tooltip. See [`ports/index_embed_migration - Zeit online data - 2015-2020 - click2filter.html`](./ports/index_embed_migration%20-%20Zeit%20online%20data%20-%202015-2020%20-%20click2filter.html).
 
 ### Data formats and data.js
 
@@ -289,7 +302,7 @@ of your own project files gl can render.
 Load the engine from jsDelivr, pinned to a release tag (or `@main` for the latest commit):
 
 ```html
-<script src="https://cdn.jsdelivr.net/gh/gjrichter/ixmaps-gl@v0.2.25/ixmaps-gl.js"></script>
+<script src="https://cdn.jsdelivr.net/gh/gjrichter/ixmaps-gl@v0.2.31/ixmaps-gl.js"></script>
 ```
 
 or from unpkg, the npm package [`ixmaps-gl`](https://www.npmjs.com/package/ixmaps-gl)
@@ -297,13 +310,13 @@ or from unpkg, the npm package [`ixmaps-gl`](https://www.npmjs.com/package/ixmap
 browser script, which defines the global `ixmaps`):
 
 ```html
-<script src="https://unpkg.com/ixmaps-gl@0.2.25/ixmaps-gl.js"></script>
+<script src="https://unpkg.com/ixmaps-gl@0.2.31/ixmaps-gl.js"></script>
 ```
 
 or use a local copy (`<script src="ixmaps-gl.js"></script>`). A minimal page:
 
 ```html
-<script src="https://cdn.jsdelivr.net/gh/gjrichter/ixmaps-gl@v0.2.25/ixmaps-gl.js"></script>
+<script src="https://cdn.jsdelivr.net/gh/gjrichter/ixmaps-gl@v0.2.31/ixmaps-gl.js"></script>
 <div id="map_div" style="position:absolute;inset:0;"></div>
 
 <script>