Lea Verou escribe sobre el diseño de las API de HTML y cómo podemos escribir una mejor documentación para los diseñadores web. Una API de HTML es un término para una biblioteca de JavaScript que se configura y controla a través de HTML en lugar de JavaScript. Por ejemplo <div data-open-modal="#modal"></div> podría decirle a una biblioteca que este elemento está a cargo de abrir un modal. No hay configuración o inicio que no sea cargar la biblioteca en sí.
Mi parte favorita de esta pieza es donde Lea se enfrenta a lo que generalmente podría verse como una biblioteca de JavaScript simple plug-n-play:
Incluso este pequeño fragmento de código requiere que las personas entiendan los objetos literales, matrices, variables, cadenas, cómo obtener una referencia a un elemento DOM, eventos, cuándo está listo el DOM y mucho más. Las cosas que parecen triviales para los programadores pueden ser una batalla cuesta arriba para los autores de HTML sin conocimientos de JavaScript.
Al brindarles a las personas una API HTML, podemos evitar posibles dolores de cabeza.
…recuerda que muchas de estas personas no hablan ningún lenguaje de programación, no solo JavaScript. No hable sobre modelos, vistas, controladores u otros conceptos de ingeniería de software en un texto que espera que lean y entiendan. Todo lo que lograrás es confundirlos y alejarlos.
Lea hizo una colección de bibliotecas que tienen API HTML.
Enlace directo →