Download the PHP package 8fold/html-spec-structured without Composer
On this page you can find all versions of the php package 8fold/html-spec-structured. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download 8fold/html-spec-structured
More information about 8fold/html-spec-structured
Files in 8fold/html-spec-structured
Package html-spec-structured
Short Description The HTML and ARIA-HTML specifications as structured data
License MIT
Informations about the package html-spec-structured
8fold HTML Spec
The mission here is to present the Living HTML Specification as structured, and interconnected data.
The structured data is placed in a folder for the type of structured data used (json
, for example). It's important to note that everything withing the folder for the structured data is automatically generated; therefore, no guarantee is provided regarding the accuracy and correcting the issue may require correcting an issue in the specification itself.
The information architecture of the html
directory matches the URL of the documentation provided in w3c/elements-of-html.
Installation
Usage
Raw data
The compiled data from the writer scripts is stored in the /json
directory, giving users direct access to the raw data using whatever interface they deem suitable.
PHP Reader classes
The reader classes provide an API and lightweight ORM solution for retrieving data and are regularly refined to improve and ensure performance.
PHP Writer classes
Because the data are collected across multiple documents, in multiple repositories, across multiple organizations, the writing scripts are very utilitarian and considered "throw away." They are minimally optimized for querying the documents and saving the subsequent data to files. Further, they inherit from the reader classes and are, therefore, completely decoupled from the user-oriented capabilties.
Details
Project data structure
html.json
: Index of HTML elements.html-attributes.json
: Index of defined attributes, events, and ARIA attributes.html-aria-roles.json
: Index of defined role attribute values. Debating.
Data collection
- The list of HTML elements is pulled from the w3c Elements of HTML repositiory. Note: If the element is not listed here, will not be listed anywhere else, even if referenced in other resources.
- The list of non-ARIA HTML attributes and element details are pulled from the WHATWG HTML Living Standard.
- Note:
role
is not considered an attribute in that it is not listed in the attributes table; therefore, it is injected as a global attribute after the initial set is complete.
- Note:
- The list of ARIA attributes and HTML element roles is pulled from the w3c HTML ARIA documentation.
- The ATRIA attribute categories are pulled from a local copy of the w3c HTML ARIA 1.1 recommendation available in the local folder of this repository.
ARIA seems to be the least consolidated and most volatile from a format perspective; however, it may become easier to aggregate and compile as time progresses.
Other
Versioning
As this package relays on time-sensitive, not functionality-sensitive details, versioning is time based using an ISO standard; therefore, semantic versioning [major].[minor].[patch]
becomes [year].[month].[day]
.
- year: represents the four-digit year the compiling scripts were run.
- month: representing the two-digit month the compiling scripts were run.
- day: represents the two-digit day the compiling scripts were run.