listings - support for table, grid, default, tests

Author: cscheid

src/project/types/website/listing/website-listing-read.ts

@@ -62,6 +62,7 @@ import {
   kImageAlign,
   kImageAlt,
   kImageHeight,
+  kImageLazyLoading,
   kImagePlaceholder,
   kInclude,
   kListing,
@@ -117,6 +118,7 @@ import {
   isProjectDraft,
   projectDraftMode,
 } from "../website-utils.ts";
+import { kFieldImageLazyLoading } from "./website-listing-shared.ts";
 
 // Defaults (a card listing that contains everything
 // in the source document's directory)
@@ -1117,6 +1119,9 @@ async function listItemFromFile(
       : undefined;
 
     const imageAlt = documentMeta?.[kImageAlt] as string | undefined;
+    const imageLazyLoading = documentMeta?.[kImageLazyLoading] as
+      | boolean
+      | undefined;
 
     const date = documentMeta?.date
       ? parsePandocDate(resolveDate(input, documentMeta?.date) as string)
@@ -1170,6 +1175,7 @@ async function listItemFromFile(
       [kFieldCategories]: categories,
       [kFieldImage]: image,
       [kFieldImageAlt]: imageAlt,
+      [kFieldImageLazyLoading]: imageLazyLoading,
       [kFieldDescription]: description,
       [kFieldFileName]: filename,
       [kFieldFileModified]: filemodified,

src/project/types/website/listing/website-listing-shared.ts

@@ -104,6 +104,7 @@ export const kFieldFileModified = "file-modified";
 export const kFieldDate = "date";
 export const kFieldImage = "image";
 export const kFieldImageAlt = "image-alt";
+export const kFieldImageLazyLoading = "image-lazy-loading";
 export const kFieldDescription = "description";
 export const kFieldReadingTime = "reading-time";
 export const kFieldWordCount = "word-count";

src/resources/editor/tools/vs-code.mjs

@@ -10597,6 +10597,12 @@ var require_yaml_intelligence_resources = __commonJS({
                   description: "The default image to use if an item in the listing doesn't have an image."
                 }
               },
+              "image-lazy-loading": {
+                boolean: {
+                  description: "If false, images in the listing will be loaded immediately. If true, images will be loaded as they come into view.",
+                  default: true
+                }
+              },
               "image-align": {
                 enum: [
                   "left",
@@ -18472,6 +18478,20 @@ var require_yaml_intelligence_resources = __commonJS({
             ]
           },
           description: "The alt text for preview image on this page."
+        },
+        {
+          name: "image-lazy-loading",
+          schema: "boolean",
+          tags: {
+            formats: [
+              "$html-doc"
+            ]
+          },
+          description: {
+            short: "If true, the preview image will only load when it comes into view.",
+            long: 'Enables lazy loading for the preview image. If true, the preview image element \nwill have `loading="lazy"`, and will only load when it comes into view.\n\nIf false, the preview image will load immediately.\n'
+          },
+          default: true
         }
       ],
       "schema/extension.yml": [
@@ -21151,6 +21171,7 @@ var require_yaml_intelligence_resources = __commonJS({
         "The name to display in the UI.",
         "The name of the language the kernel implements.",
         "The name of the kernel.",
+        "Configures the Julia engine.",
         "Arguments to pass to the Julia worker process.",
         "Environment variables to pass to the Julia worker process.",
         "Set Knitr options.",
@@ -22744,7 +22765,11 @@ var require_yaml_intelligence_resources = __commonJS({
         },
         "Disambiguating year suffix in author-date styles (e.g. \u201Ca\u201D in \u201CDoe,\n1999a\u201D).",
         "Manuscript configuration",
-        "internal-schema-hack"
+        "internal-schema-hack",
+        {
+          short: "If true, the preview image will only load when it comes into\nview.",
+          long: 'Enables lazy loading for the preview image. If true, the preview\nimage element will have <code>loading="lazy"</code>, and will only load\nwhen it comes into view.\nIf false, the preview image will load immediately.'
+        }
       ],
       "schema/external-schemas.yml": [
         {
@@ -22973,12 +22998,12 @@ var require_yaml_intelligence_resources = __commonJS({
         mermaid: "%%"
       },
       "handlers/mermaid/schema.yml": {
-        _internalId: 183687,
+        _internalId: 186197,
         type: "object",
         description: "be an object",
         properties: {
           "mermaid-format": {
-            _internalId: 183679,
+            _internalId: 186189,
             type: "enum",
             enum: [
               "png",
@@ -22994,7 +23019,7 @@ var require_yaml_intelligence_resources = __commonJS({
             exhaustiveCompletions: true
           },
           theme: {
-            _internalId: 183686,
+            _internalId: 186196,
             type: "anyOf",
             anyOf: [
               {

src/resources/editor/tools/yaml/web-worker.js

@@ -3569,6 +3569,12 @@
               "description": "The default image to use if an item in the listing doesn't have an image."
             }
           },
+          "image-lazy-loading": {
+            "boolean": {
+              "description": "If false, images in the listing will be loaded immediately. If true, images will be loaded as they come into view.",
+              "default": true
+            }
+          },
           "image-align": {
             "enum": [
               "left",
@@ -11444,6 +11450,20 @@
         ]
       },
       "description": "The alt text for preview image on this page."
+    },
+    {
+      "name": "image-lazy-loading",
+      "schema": "boolean",
+      "tags": {
+        "formats": [
+          "$html-doc"
+        ]
+      },
+      "description": {
+        "short": "If true, the preview image will only load when it comes into view.",
+        "long": "Enables lazy loading for the preview image. If true, the preview image element \nwill have `loading=\"lazy\"`, and will only load when it comes into view.\n\nIf false, the preview image will load immediately.\n"
+      },
+      "default": true
     }
   ],
   "schema/extension.yml": [
@@ -14123,6 +14143,7 @@
     "The name to display in the UI.",
     "The name of the language the kernel implements.",
     "The name of the kernel.",
+    "Configures the Julia engine.",
     "Arguments to pass to the Julia worker process.",
     "Environment variables to pass to the Julia worker process.",
     "Set Knitr options.",
@@ -15716,7 +15737,11 @@
     },
     "Disambiguating year suffix in author-date styles (e.g. “a” in “Doe,\n1999a”).",
     "Manuscript configuration",
-    "internal-schema-hack"
+    "internal-schema-hack",
+    {
+      "short": "If true, the preview image will only load when it comes into\nview.",
+      "long": "Enables lazy loading for the preview image. If true, the preview\nimage element will have <code>loading=\"lazy\"</code>, and will only load\nwhen it comes into view.\nIf false, the preview image will load immediately."
+    }
   ],
   "schema/external-schemas.yml": [
     {
@@ -15945,12 +15970,12 @@
     "mermaid": "%%"
   },
   "handlers/mermaid/schema.yml": {
-    "_internalId": 183687,
+    "_internalId": 186197,
     "type": "object",
     "description": "be an object",
     "properties": {
       "mermaid-format": {
-        "_internalId": 183679,
+        "_internalId": 186189,
         "type": "enum",
         "enum": [
           "png",
@@ -15966,7 +15991,7 @@
         "exhaustiveCompletions": true
       },
       "theme": {
-        "_internalId": 183686,
+        "_internalId": 186196,
         "type": "anyOf",
         "anyOf": [
           {

src/resources/editor/tools/yaml/yaml-intelligence-resources.json

@@ -41,7 +41,7 @@ print(`<div class="metadata-value listing-${field}">${listing.utilities.outputLi
 <div class="thumbnail">
 <a href="<%- item.path %>" class="no-external">
 <% if (item.image) { %>
-<%= listing.utilities.img(itemNumber, item.image, "thumbnail-image", item['image-alt']) %>
+<%= listing.utilities.img(itemNumber, item.image, "thumbnail-image", item['image-alt'], item['image-lazy-loading'] ?? listing['image-lazy-loading']) %>
 <% } else { %>
 <%= listing.utilities.imgPlaceholder(itemNumber, item.outputHref) %>
 <% } %>

src/resources/projects/website/listing/item-default.ejs.md

@@ -46,7 +46,7 @@ return !["title", "image", "image-alt", "date", "author", "subtitle", "descripti
 <% if (item.image) { %>
 
 <p class="card-img-top">
-<%= listing.utilities.img(itemNumber, item.image, "thumbnail-image card-img", item['image-alt']) %>
+<%= listing.utilities.img(itemNumber, item.image, "thumbnail-image card-img", item['image-alt'], item['image-lazy-loading'] ?? listing['image-lazy-loading']) %>
 </p>
 <% } else { %>
 <%= listing.utilities.imgPlaceholder(itemNumber, item.outputHref) %>

src/resources/projects/website/listing/item-grid.ejs.md

@@ -55,7 +55,7 @@ let value = readField(item, field);
 
 if (field === "image") {
 if (item.image) {
-value = listing.utilities.img(itemNumber, item[field], "", item['image-alt']);
+value = listing.utilities.img(itemNumber, item[field], "", item['image-alt'], item['image-lazy-loading'] ?? listing['image-lazy-loading']);
 } else {
 value = listing.utilities.imgPlaceholder(itemNumber, item.outputHref);
 }

src/resources/projects/website/listing/listing-table.ejs.md

@@ -1579,6 +1579,10 @@
       image-placeholder:
         string:
           description: "The default image to use if an item in the listing doesn't have an image."
+      image-lazy-loading:
+        boolean:
+          description: "If false, images in the listing will be loaded immediately. If true, images will be loaded as they come into view."
+          default: true
       image-align:
         enum: [left, right]
         description: In `default` type listings, whether to place the image on the right or left side of the post content (`left` or `right`).

src/resources/schema/definitions.yml

@@ -62,3 +62,16 @@
   tags:
     formats: [$html-doc]
   description: The alt text for preview image on this page.
+
+- name: image-lazy-loading
+  schema: boolean
+  tags:
+    formats: [$html-doc]
+  description:
+    short: If true, the preview image will only load when it comes into view.
+    long: |
+      Enables lazy loading for the preview image. If true, the preview image element 
+      will have `loading="lazy"`, and will only load when it comes into view.
+
+      If false, the preview image will load immediately.
+  default: true