Paso 1: Instalación con npm

Instala el paquete desde el registro de npm.

Terminal window
npm install add-to-calendar-button

Paso 2: Importarlo

Importa el módulo en el componente donde quieras usar el botón.

import 'add-to-calendar-button';

Paso 3: Optimizar la configuración de Angular

Para que Angular funcione correctamente con el Web Component, debes importar CUSTOM_ELEMENTS_SCHEMA y actualizar el bloque @NgModule/@Component correspondiente.

Opción A: Componente independiente (recomendado)

app.component.ts
import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
@Component({
//(...),
standalone: true,
schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppComponent {}

Opción B: Aplicación basada en NgModule

app.module.ts
import { NgModule, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
//(...)
@NgModule({
//(...),
schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
//(...)

Paso 4: Usarlo

Empieza añadiendo una etiqueta <add-to-calendar-button> al código HTML, con las opciones como atributos.

Sí, así de sencillo.

Tu bloque de código podría ser como el siguiente.

<add-to-calendar-button
name="Título"
options="'apple','google'"
location="World Wide Web"
start-date="2026-10-18"
end-date="2026-10-18"
start-time="10:15"
end-time="23:30"
time-zone="Europe/Madrid"
language="es"
></add-to-calendar-button>

Enlaces correctos

Para enlazar datos con un atributo concreto, usa la sintaxis [attr.PARAMETER]="tus datos".

Según tu configuración, los datos pueden llegar después del primer renderizado del botón. No supone ningún problema, aunque el modo debug puede mostrar errores por datos ausentes. Por esta razón, no funcionaría enlazar la opción «identifier».

<add-to-calendar-button
[attr.name]="titleVar"
options="'apple','google'"
[attr.start-date]="dateVar"
></add-to-calendar-button>

Estilos e idiomas

El script incluye el estilo de botón «default» y el paquete de inglés, por lo que funciona y se ve bien sin configuración adicional.

Al cargar directamente el script del navegador, los demás estilos e idiomas se descargan automáticamente cuando se necesitan (unos pocos KB cada uno). Las integraciones empaquetadas deben registrar explícitamente los módulos necesarios como se muestra abajo.

Empaquetado con npm (recomendado para frameworks)

Al empaquetar el script, importa los módulos de estilo e idioma necesarios antes del módulo principal. Así quedan registrados sin solicitudes antes de que se actualice el custom element, también durante la hidratación SSR:

import 'add-to-calendar-button/styles/3d'; // any style besides "default"
import 'add-to-calendar-button/i18n/de'; // any language besides English
import 'add-to-calendar-button'; // load the component last

Para cargar todos los estilos o idiomas en una sola instrucción, usa los módulos agregados: import 'add-to-calendar-button/styles/all' e import 'add-to-calendar-button/i18n/all'.

Consulta las opciones «button-style» y «language» de la página Configuración para ver todos los detalles.