Specify search and suggestions link rel values

Peter Rushforth · prushforth · commit 8d7459c33ada · 2026-05-27T17:36:21.000-04:00
Specify controlslist search token value
Add default (GeoJSON) search to example
diff --git a/schema/mapml-viewer.rnc b/schema/mapml-viewer.rnc
@@ -7,7 +7,18 @@ mapml-viewer = element mapml-viewer { map-layer*,
     attribute zoom {text}, 
     attribute projection { "OSMTILE" | "CBMTILE" | "APSTILE" | "WGS84" },
     attribute controls {text}?,
-    attribute controlslist { text }?,
+    attribute controlslist {
+      list {
+        (
+          "nofullscreen" |
+          "nolayer" |
+          "nozoom" |
+          "nolocate" |
+          "geolocation" |
+          "search"
+        )*
+      }
+    }?,
     attribute height {text}?,
     attribute width {text}?,
     attribute static {text}?,
@@ -28,7 +39,19 @@ map-link = element map-link {
         # can have a tref (when in extent) or an href (but not both)
         attribute tref { text }?,
         # @rel=alternate + @projection=tcrs-name is proposed as a way of negotiating the tcrs of the service: https://github.com/Maps4HTML/MapML/issues/11
-        attribute rel {  text },
+  attribute rel {
+    "alternate" |
+    "self" |
+    "style" |
+    "tile" |
+    "image" |
+    "features" |
+    "query" |
+    "search" |
+    "suggestions" |
+    "self style" |
+    "style self"
+  },
         attribute projection { "OSMTILE" | "CBMTILE" | "APSTILE" | "WGS84" }?,
         attribute title { text }?,
         attribute type { text }?,
diff --git a/schema/mapml-viewer.xhtml b/schema/mapml-viewer.xhtml
@@ -1,6 +1,6 @@
 <!-- validate with mapml-viewer.rnc, then mapml-viewer.sch. <mapml-viewer> is a
 custom element that goes in the <body> element of an HTML document -->
-<mapml-viewer lat="45" lon="180" projection="CBMTILE" zoom="11" controls="controls" height="240" controlslist="nofullscreen geolocation noscale"  xmlns="http://www.w3.org/1999/xhtml">
+<mapml-viewer lat="45" lon="180" projection="CBMTILE" zoom="11" controls="controls" height="240" controlslist="search nofullscreen geolocation noscale"  xmlns="http://www.w3.org/1999/xhtml">
     <map-caption>A pleasing map of Canada</map-caption>
     <map-layer src=""></map-layer>
     <map-layer label="CBMT" src="https://geogratis.gc.ca/mapml/en/cbmtile/cbmt/" checked="foo"></map-layer>
diff --git a/schema/mapml.rnc b/schema/mapml.rnc
@@ -8,7 +8,19 @@ map-link = element map-link {
         # can have a tref (when in extent) or an href (but not both)
         attribute tref { text }?,
         # @rel=alternate + @projection=tcrs-name is proposed as a way of negotiating the tcrs of the service: https://github.com/Maps4HTML/MapML/issues/11
-        attribute rel {  text },
+  attribute rel {
+    "alternate" |
+    "self" |
+    "style" |
+    "tile" |
+    "image" |
+    "features" |
+    "query" |
+    "search" |
+    "suggestions" |
+    "self style" |
+    "style self"
+  },
         attribute projection { "OSMTILE" | "CBMTILE" | "APSTILE" | "WGS84" }?,
         attribute title { text }?,
         attribute type { text }?,
diff --git a/spec/examples/cbmt.mapml b/spec/examples/cbmt.mapml
@@ -4,6 +4,8 @@
     <map-meta charset="utf-8" ></map-meta>
     <map-meta content="text/mapml" http-equiv="Content-Type" ></map-meta>
     <map-link rel="license" href="https://www.nrcan.gc.ca/earth-sciences/geography/topographic-information/free-data-geogratis/licence/17285" title="Canada Base Map © Natural Resources Canada"></map-link>
+    <map-link rel="search" tref="https://photon.komoot.io/api/?q={searchTerms}"></map-link>
+    <map-link rel="suggestions" tref="https://photon.komoot.io/api/?q={searchTerms}"></map-link>
   </map-head>
   <map-body>
     <map-extent units="CBMTILE" checked="">
diff --git a/spec/examples/map-2.html b/spec/examples/map-2.html
@@ -43,7 +43,7 @@
     </noscript>
   </head>
   <body>
-    <mapml-viewer projection="CBMTILE" zoom="15" lat="45.4215" lon="-75.6972" controls controlslist="geolocation">
+    <mapml-viewer projection="CBMTILE" zoom="15" lat="45.4215" lon="-75.6972" controls controlslist="geolocation search">
       <map-layer label="Canada Base Map - Transportation (CBMT)" src="cbmt.mapml" checked></map-layer>
     </mapml-viewer>
   </body>
diff --git a/spec/index.html b/spec/index.html
