Τεκμηρίωση: Καλές πρακτικές

Καλές πρακτικές

Greek

Τοποθετήστε τις διευθύνσεις URL σε μεταβλητές

Όταν μεταφράζετε αλφαριθμητικά που περιέχουν URLs ή παρόμοια δεδομένα, θεωρείται καλή πρακτική να τοποθετείτε αυτά τα URLs μέσα σε μεταβλητές και στη συνέχεια να τα αναφέρετε μέσα στα πρότυπά σας.

<Translate
	string={`Click <a href="{{url}}">here</a>`}
	variables={{url: 'https://tacotranslate.com'}}
/>

Χρησιμοποιήστε ετικέτες ARIA

Όταν μεταφράζετε το κείμενο διαδραστικών στοιχείων όπως κουμπιά, είναι σημαντικό να συμπεριλαμβάνετε ετικέτες ARIA για να διασφαλίσετε την προσβασιμότητα. Οι ετικέτες ARIA βοηθούν τους αναγνώστες οθόνης να παρέχουν περιγραφικές πληροφορίες για τη λειτουργία του στοιχείου.

Για παράδειγμα, αν έχετε ένα κουμπί που επιτρέπει στους χρήστες να αντιγράψουν κείμενο από ένα μπλοκ κώδικα, μπορείτε να χρησιμοποιήσετε το χαρακτηριστικό aria-label για να παρέχετε μια σαφή περιγραφή:

<Translate
	aria-label={useTranslation('Copy to clipboard')}
	string="Copy"
/>

Κάτι σχετικά με αυτό νιώθω πολύ μετα-αντικειμενικό.

Παγκόσμιος πίνακας προελεύσεων και πολλαπλές προελεύσεις συστατικών

Αυτό το πρότυπο λειτουργεί μόνο κατά τη χρήση του Next.js Pages Router.

Όταν εργάζεστε με μεγαλύτερες εφαρμογές, είναι ωφέλιμο να χωρίζετε τις αλυσίδες κειμένου και τις μεταφράσεις σε πολλαπλές, μικρότερες προελεύσεις. Αυτή η προσέγγιση βοηθά στη μείωση του μεγέθους των πακέτων και του χρόνου μεταφοράς, εξασφαλίζοντας αποδοτική και κλιμακούμενη τοπικοποίηση.

Ενώ αυτό είναι απλό όταν γίνεται απόδοση μόνο στη μεριά του πελάτη, η διαχείριση των προελεύσεων γίνεται γρήγορα πολύπλοκη όταν ανακτώνται μεταφράσεις για server-side rendering. Ωστόσο, μπορείτε να αυτοματοποιήσετε τη διαχείριση προελεύσεων χρησιμοποιώντας τον πίνακα origins του πελάτη TacoTranslate.

Σκεφτείτε αυτό το παράδειγμα, όπου έχουμε χωρίσει τα components και τις σελίδες μας σε ξεχωριστά αρχεία.

components/pricing-table.tsx

import TacoTranslate, {Translate} from 'tacotranslate/react';
import tacoTranslate from '../tacotranslate-client';

// Set an origin name for this component
const origin = 'components/pricing-table';

// Push the origin into the origins array as this file is imported
tacoTranslate.origins.push(origin);

export default function PricingTable() {
	return (
		<TacoTranslate origin={origin}>
			<Translate string="Pricing table" />
			// ...
		</TacoTranslate>
	);
}

pages/pricing.tsx

import TacoTranslate, {Translate} from 'tacotranslate/react';
import getTacoTranslateStaticProps from 'tacotranslate/next/get-static-props';
import tacoTranslateClient from '../tacotranslate-client';
import PricingTable from '../components/pricing-table';

const origin = 'pages/pricing';
tacoTranslateClient.origins.push(origin);

export default function PricingPage() {
	return (
		<TacoTranslate origin={origin}>
			<Translate string="Pricing page" />
			<PricingTable />
		</TacoTranslate>
	);
}

// We will now fetch translations for all imported components and their origins automatically
export async function getStaticProps(context) {
	return getTacoTranslateStaticProps(context, {client: tacoTranslateClient});
}

Δείτε τα παραδείγματα απόδοσης από την πλευρά του διακομιστή για περισσότερες πληροφορίες σχετικά με getTacoTranslateStaticProps.

Διαχείριση σφαλμάτων και αποσφαλμάτωση