w3c / apiary

Simple JS library to use the W3C API in a declarative way
MIT License
15 stars 8 forks source link
api client declarative javascript library w3c w3c-api

Apiary

Logo

Apiary is a simple JavaScript library to leverage the W3C API. This library is intended to be used from W3C pages: group pages, personal pages, etc. With Apiary, you can inject data that is retrieved using the W3C API, in a declarative way using placeholders. Examples are also provided.

Refer to the W3C API and its documentation for details [overview; reference].

Live examples

Getting started

Include the library

Include Apiary in your page:

<script src="https://github.com/w3c/apiary/raw/main//w3c.github.io/apiary/apiary.js"></script>

Specify an entity ID

Specify the ID of the entity you want, adding a data-apiary-* attribute to a container element, eg:

<main data-apiary-group="68239">

Add placeholders

Finally, add placeholders wherever you want real data about that entity, eg:

The chairs of this group are: <span data-apiary="chairs"></span>.

Reference

The container element should have one of these data-apiary-* attributes, and its value should be a valid ID:

A placeholder is any element with a data-apiary attribute. Bear in mind that a new chunk of DOM will be inserted there; whatever that placeholder contains will be lost. We recommend that you have something in there giving users a hint that data is being loaded dynamically. For example:

<div data-apiary="chairs">[Loading…]</div>

For consistency (and to adhere to the POLA), the suffix part of these placeholders is equal to the object keys returned by the API.

The additional class apiary in the example files is ignored by Apiary itself but you may wish to include it anyway to all placeholders in your documents for easier CSS styling.

Credits

Copyright © 2023 World Wide Web Consortium

This project is licensed under the terms of the MIT license.