Enhancement: Add Nuxt.js Integration — new wrapper component and demo page section
I maintainer di solito rispondono entro 1 giorno
Valutazione
- Difficoltà
- 3/5
- Tempo stimato
- 1-2 giorni
- Idoneità per principianti
- 72/100
- Tipo di issue
- Funzionalità
- Chiarezza
- Specificata chiaramente
- Stato di attività
- Attiva
- Stack tecnologico
- javascript
- Ambito
- documentation, frontend
Direzione di ricerca
Inizia confrontando src/social-share-button-react.jsx con la gestione richiesta del ciclo di vita e delle opzioni di src/social-share-button-nuxt.vue. Poi esamina la sezione React Integration e il comportamento degli appunti dei blocchi di codice in index.html, quindi aggiorna l'elenco dei framework supportati nel README. Il lavoro è completato quando il wrapper Nuxt soddisfa tutti i criteri elencati relativi a SSR, ciclo di vita, watch e cleanup, e le sezioni della demo e del README sono complete.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
🎯 Direction
SocialShareButton is a lightweight, zero-dependency, framework-agnostic social sharing component. The goal of this issue is to extend first-class support to Nuxt.js (the Vue meta-framework), which is SSR-first. Since Nuxt renders on the server, the wrapper must guard all browser APIs with typeof window !== 'undefined' checks and only initialize the button on the client side using onMounted.
📹 See the button in action: https://youtu.be/cLJaT-8rEvQ?si=CLipA0Db4WL0EqKM
📁 Files to Create / Modify
✅ New File: src/social-share-button-nuxt.vue
A Vue 3 Composition API component (compatible with Nuxt 3) wrapping the core vanilla JS library, following the same lifecycle pattern as src/social-share-button-react.jsx:
<template>
<div ref="container"></div>
</template>
<script setup>
import { ref, onMounted, onBeforeUnmount, watch } from 'vue';
const props = defineProps({
url: { type: String, default: '' },
title: { type: String, default: '' },
description: { type: String, default: '' },
hashtags: { type: Array, default: () => [] },
via: { type: String, default: '' },
platforms: { type: Array, default: () => ['whatsapp', 'facebook', 'twitter', 'linkedin', 'telegram', 'reddit'] },
theme: { type: String, default: 'dark' },
buttonText: { type: String, default: 'Share' },
customClass: { type: String, default: '' },
onShare: { type: Function, default: null },
onCopy: { type: Function, default: null },
buttonStyle: { type: String, default: 'default' },
modalPosition: { type: String, default: 'center' }
});
const container = ref(null);
let shareButton = null;
onMounted(() => {
// SSR guard — Nuxt pre-renders on the server
if (typeof window !== 'undefined' && window.SocialShareButton) {
shareButton = new window.SocialShareButton({
container: container.value,
url: props.url || window.location.href,
title: props.title || document.title,
description: props.description,
hashtags: props.hashtags,
via: props.via,
platforms: props.platforms,
theme: props.theme,
buttonText: props.buttonText,
customClass: props.customClass,
onShare: props.onShare,
onCopy: props.onCopy,
buttonStyle: props.buttonStyle,
modalPosition: props.modalPosition
});
}
});
onBeforeUnmount(() => {
if (shareButton) {
shareButton.destroy();
shareButton = null;
}
});
// Sync prop changes to the underlying vanilla JS instance (e.g. Nuxt route changes)
watch(props, (newProps) => {
if (shareButton) {
shareButton.updateOptions(newProps);
}
}, { deep: true });
<\/script>
✅ Existing File: index.html — Add Nuxt.js Integration Section
Mirror the existing ⚛️ React Integration section. Add a new section block with:
- Section heading:
💚 Nuxt.js Integration - Step 1: Include CSS and JS via CDN (same as Quick Start)
- Step 2: Register the component (auto-imported in Nuxt 3 if placed in
components/) - Step 3: Show usage in a
pages/index.vuefile
Example code snippet to display in the demo section:
<!-- pages/index.vue -->
<template>
<SocialShareButton
url="https://your-website.com"
title="Check this out!"
description="An amazing website"
theme="dark"
button-text="Share"
/>
</template>
<script setup>
// Component is auto-imported from components/ in Nuxt 3
<\/script>
✅ Acceptance Criteria
-
src/social-share-button-nuxt.vuecreated using Vue 3 Composition API (script setup) - SSR guard (
typeof window !== 'undefined') present on all browser API usages insideonMounted -
onMountedused for initialization,onBeforeUnmountcallsdestroy()to prevent memory leaks -
watch(props, ...)with{ deep: true }callsupdateOptions()on prop changes - Component works with Nuxt 3 auto-import when placed in the
components/directory -
index.htmlupdated with a Nuxt.js section containing install + usage code snippets - Copy-to-clipboard button present on new code blocks in
index.html - README updated to list Nuxt.js as a supported framework
- Lingua principale
- TypeScript
- Stelle
- 29
- Fork
- 74
- Merge medio
- 8h 52m
- PR unite (30g)
- 4
Preparare l'ambiente
- Nessun Dockerfile né file Docker Compose
- Ha un modello di pull request
- Leggi la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di AOSSIE-Org/SocialShareButton
-
Improvement: Add try-catch blocks for better error handling in social-share-button.jsForse già presa @afzalansari12 l’ha presa 118 giorni fa. Aperta
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
AOSSIE-Org/SocialShareButton#132 · 5 commenti ·
I maintainer di solito rispondono entro 1 giorno
-
Remove or guard console.error statement in production build (src/social-share-button.js)Forse di nuovo libera @Akshat0125 l’ha presa 244 giorni fa e non c’è nessuna pull request aperta. Aperta
Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100
AOSSIE-Org/SocialShareButton#43 · 4 commenti ·
I maintainer di solito rispondono entro 1 giorno
-
[FEATURE]: Add Google Tag Manager (dataLayer.push) Analytics AdapterForse già presa @Devnil434 l’ha presa oggi. Apertaenhancement
Difficoltà 3/5 1-2 giorni Idoneità per principianti 74/100
AOSSIE-Org/SocialShareButton#270 ·
I maintainer di solito rispondono entro 1 giorno
-
[BUG]: React, Preact and Qwik share buttons keep sharing the first page's link after navigationForse già presa @atharva134kadam l’ha presa 1 giorno fa. Apertabug
Difficoltà 3/5 1-2 giorni Idoneità per principianti 72/100
AOSSIE-Org/SocialShareButton#266 · 3 commenti ·
I maintainer di solito rispondono entro 1 giorno
-
[FEATURE]: Add Scroll-to-Top Button with Smooth AnimationForse già presa @zaibamachhaliya l’ha presa 92 giorni fa. Apertaenhancement
Difficoltà 4/5 3-5 giorni Idoneità per principianti 48/100
AOSSIE-Org/SocialShareButton#240 · 3 commenti ·
I maintainer di solito rispondono entro 1 giorno
Tutte le issue di AOSSIE-Org/SocialShareButton
Issue simili
-
ready-for-agent
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 86/100
LucasSantana-Dev/Lucky#3257 ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 75/100
XiaomiMiMo/MiMo-Code#2849 · 1 commento ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 67/100
danielmiessler/LifeOS#2894 ·
I maintainer di solito rispondono entro 5 giorni
-
enhancement frontend good first issue help wanted testing-infrastructure
Difficoltà 2/5 1-3 ore Idoneità per principianti 76/100
I maintainer di solito rispondono entro 2 giorni
-
enhancement follow-up
Difficoltà 2/5 1-3 ore Idoneità per principianti 76/100
I maintainer di solito rispondono entro 1 giorno