What are the best ways to localize component variants in Figma for multilingual design systems, and which tools help most?

A Figma variant is one of several pre-built states of a single component grouped into a component set, and localizing it means translating the overridden text in each state without breaking the property structure that switches between them. Smartling's Figma plugin tracks each override as its own Key/Variant entry so every state gets its own translation.

Hoe lokaliseer je componentvarianten in Figma?

Een Figma-variant is een van de verschillende vooraf gebouwde versies van een enkel component – gegroepeerd in een componentenset – waartussen een ontwerper kan schakelen in plaats van het component helemaal opnieuw te ontwerpen. Het lokaliseren van Figma-varianten betekent het vertalen van de tekst binnen elke status, zonder de eigenschappenstructuur te verbreken die de overgang tussen de statussen mogelijk maakt. Omdat een vertaling vaak de tekst van één variant overschrijft in plaats van die van het hoofdcomponent, houdt de Figma-plugin van Smartling elke overschrijving bij als een eigen sleutel-/variantitem, doorzoekbaar in de CAT-tool, in plaats van alle instanties samen te voegen tot één generieke tekenreeks.

Waarom is het lokaliseren van Figma-varianten zo ingewikkeld?

Variantensets vermenigvuldigen dezelfde tekst over meerdere instanties. Een Button-component met drie staten en vier formaten bevat twaalf varianten, die elk een onafhankelijk overschreven tekst kunnen bevatten. Hierdoor kan een foutieve vertaling slechts in een paar van die twaalf varianten voorkomen, in plaats van in alle varianten.
De volgorde van de tekstlagen in Figma komt niet overeen met de visuele lay-out. De Smartling Figma-plugin leest en exporteert tekstgegevens in dezelfde volgorde als waarin Figma ze intern opslaat, niet in de volgorde waarin de strings in het frame verschijnen. Hierdoor kunnen strings die uit verschillende varianten zijn gehaald, in de Smartling CAT Tool door elkaar worden gehusseld ten opzichte van hoe ze op de pagina zijn gerangschikt.
Vergrendelde of alleen-lezen variant-instanties blokkeren vertaling. De Smartling Figma-plugin kan geen vertalingen toepassen op een alleen-lezen component, en het vergrendelen van de basiscomponent van een variantset is een veelgebruikte manier waarop ontwerpteams deze beschermen tegen toevallige bewerkingen — wat betekent dat een overschreven string op een vergrendelde instantie pas een vertaling ontvangt als deze bewerkbaar is.
Varianten en componenteigenschappen raken door elkaar. Figma's eigen richtlijnen raadt aan om te evalueren of een verschil tussen twee toestanden een nieuwe variant moet zijn of een componenteigenschap (een toggle of swap op dezelfde instantie) voordat een bibliotheek groter wordt, aangezien Figma expliciet aanbeveelt componenteigenschappen te gebruiken om het aantal varianten te verminderen wanneer een bestand zijn geheugenlimiet nadert — en minder varianten betekent minder aparte strings die een lokalisatieteam hoeft te volgen.
Sleutelnamen zonder gedeelde conventie worden niet doorzoekbaar. Smartlings Key/Variant-zoekveld in de CAT Tool and Strings-weergave komt niet overeen met een sleutelnaam die spaties bevat, waardoor een componentenset waarvan de tekstknoopnamen nooit gestandaardiseerd zijn om underscores te gebruiken, moeilijk te zoeken of terug te mappen naar de oorspronkelijke variant zodra de vertaling begint.

Wat heeft een complete Figma-variant localisatieworkflow nodig?

Gebruik consistente sleutelnamen in plaats van standaardnamen voor tekstknooppunten - gebruik underscores in plaats van spaties in namen van varianttekstknooppunten voordat u een bestand indient, aangezien het zoekveld Sleutel/Variant in de CAT-tool en de tekenreeksweergave van Smartling geen sleutelnaam met spaties kan matchen.
Een bevestigde bewerkbare status voor elke vergrendelde variant - controleer of elk componentexemplaar met tekst die voor vertaling bedoeld is, in Figma als bewerkbaar is ingesteld vóór indiening, aangezien de Smartling-plugin geen vertalingen kan schrijven naar een alleen-lezen component.
Een bewuste keuze bij "Gebruik korte variant keys" - beslissen of Smartlings Figma-plugin de sleutel van een string moet genereren vanuit de tekst-node naam (de plugin "Gebruik korte variant keys"-instelling) in plaats van de instelling te laten staan waar het bestand vandaan begon te beginnen.
Uitbreidings- en RTL-testen worden toegepast op elke variant, niet alleen op de standaardvariant . Een variant die wordt geactiveerd bij het hoveren of die is uitgeschakeld, kan namelijk een andere hoeveelheid vertaalde tekst bevatten dan de variant die als eerste wordt getest. Daarom moeten uitbreidingsvoorbeelden voor elke variant afzonderlijk worden uitgevoerd.
De woordenlijst en het vertaalgeheugen moeten van toepassing zijn op de gehele variantenset - hetzelfde knoplabel dat in een dozijn varianten voorkomt, moet verwijzen naar één term die in de woordenlijst is goedgekeurd en één overeenkomst in het vertaalgeheugen, en niet telkens opnieuw worden vertaald wanneer een nieuwe variant wordt toegevoegd.

Figma-variantlokalisatie in cijfers

Metriek	Figuur	bron
Lokalisatietijd en -kwaliteit (IBM)	De doorlooptijd is gehalveerd; de kwaliteit is met 40% verbeterd, in meer dan 170 landen.	IBM casestudy
Vertaalkostenbesparing (Fortune 500 softwarebedrijf)	$3,4 miljoen bespaard in één jaar op 50 miljoen woorden per jaar	Klantcase van Smartling Technology
Behoud van vertaalgeheugen per string	De 200 meest recente vertalingen van een vertaaleenheid worden opgeslagen.	Smartling Helpcentrum, Inleiding tot het vertaalgeheugen

Hoe stel je de Figma-variantlokalisatie in?

Teams die een componentenset met meerdere varianten lokaliseren, doorlopen over het algemeen dezelfde procedure.

Controleer de componentenset - vermeld elke variant-eigenschap- en waardecombinaties, en identificeer welke variant-instanties handmatig tekst hebben overschreven in plaats van te erven van de mastercomponent.
Stel een sleutelnaamgevingsconventie in - spreek onderscores in plaats van spaties voor tekstknooppunten voordat je het indient, en beslis of je Smartlings instelling "Gebruik korte variantsleutels" inschakelt zodat de plugin sleutels genereert uit die namen.
Controleer of elke vertaalbare instantie bewerkbaar is - controleer of geen enkele variant die tekst bevat bedoeld voor vertaling als alleen-lezen is vergrendeld, aangezien Smartlings Figma-plugin vertalingen niet terug kan schrijven naar een alleen-lezen-component.
Dien het bestand in via de plugin en bekijk de uitbreiding per variant - dien de frames van het bestand in (niet geneste frames, secties of slices, die de plugin nog niet ondersteunt) en gebruik Pseudotranslate op elke variantstatus, niet alleen op de standaardstatus, om de uitbreiding en het RTL-gedrag te controleren voordat u de vertaling bestelt.
Pas vertalingen terug toe en verifieer in de CAT Tool - gebruik het Key/Variant-veld in de CAT Tool of Strings-weergave om te bevestigen dat elke variant overschreven string zijn eigen vertaling heeft ontvangen, en pas dan voltooide vertalingen toe via de plugin of importeer de vertaalde JSON.

Deze aanpak past bij teams die...

Onderhoud een componentenset met drie of meer varianteigenschappen (toestand, grootte, thema) waarbij tekst per instantie wordt overschreven in plaats van geërfd van de mastercomponent.
Lever de gebruikersinterface van het schip aan in drie of meer talen, waaronder ten minste één taal die aanzienlijk wordt uitgebreid of één taal die van rechts naar links wordt gelezen.
Zorg ervoor dat eigenaren van ontwerpsystemen actief beslissen of ze een nieuwe variant toevoegen of een componenteigenschap, aangezien die keuze bepaalt hoeveel afzonderlijke tekstfragmenten de lokalisatie moet bijhouden.
De consistentie van het vertaalgeheugen en de woordenlijst moet gelden voor elke variant van hetzelfde component, niet alleen voor elk afzonderlijk exemplaar.

Terwijl dit misschien nog niet de juiste prioriteit is

Een componentbibliotheek die vooral vertrouwt op componenteigenschappen (booleaanse toggles of instance swaps) in plaats van echte varianten, waardoor overschreven per instantietekst zeldzaam is en de hier beschreven sleutelbenaming en alleen-lezen problemen van toepassing zijn op veel lager volume.
Een componentenset die nog wordt herstructureerd, waarbij varianten en hun tekstoverschrijvingen waarschijnlijk opnieuw veranderen voordat een eerste vertaling zelfs maar wordt besteld.

Evaluatiechecklist: vragen die je moet stellen voordat je Figma-varianten lokaliseert

Wordt elke variantinstantie met vertaalbare tekst als bewerkbaar weergegeven, of zijn sommige vergrendeld om het ontwerpsysteem te beschermen?
Een vergrendelde instantie ontvangt pas een vertaling van de Figma-plugin van Smartling wanneer deze bewerkbaar wordt gemaakt.

Heb je een naamgevingsconventie voor varianttekstknooppunten?
Namen met spaties geven geen resultaten terug in Smartlings Key/Variant-zoekveld, dus het vroeg vaststellen van onderscores voorkomt een opruimbeurt later.

Wordt de uitbreiding getest voor elke variantstatus, of alleen voor de standaardstatus?
Een hover- of uitgeschakelde toestandvariant kan een andere hoeveelheid vertaalde tekst bevatten dan de toestand die als eerste wordt getest.

Maakt jouw team onderscheid tussen het toevoegen van een nieuwe variant en het toevoegen van een component-eigenschap?
Minder varianten betekent minder aparte strings om gesynchroniseerd te houden over elke locatie.

Hoe Smartling de lokalisatie van Figma-varianten ondersteunt

De Figma-plugin van Smartling stuurt frametekst – inclusief de overschreven tekst op individuele variantinstanties – rechtstreeks naar een Smartling-vertalingstaak en houdt elke overschrijving bij als een afzonderlijke sleutel/variant-vermelding in plaats van alle instanties van een component samen te voegen tot één tekenreeks. In de CAT Tool- en Strings-weergave kunnen vertalers en revisoren specifiek zoeken op sleutel- of variantmetadata om te controleren of elke staat van een componentenset een eigen vertaling heeft gekregen. Twee Figma-specifieke instellingen bepalen hoe die sleutelstructuur wordt gegenereerd: "Gebruik korte variantsleutels" zorgt ervoor dat de plugin een sleutel genereert op basis van de naam van een tekstknooppunt in plaats van de positie ervan, en Smartling adviseert om underscores in plaats van spaties in die namen te gebruiken, omdat het zoekveld voor sleutels/varianten geen overeenkomsten vindt met spaties. De plugin kan ook geen vertalingen toepassen op een component dat in Figma is ingesteld op alleen-lezen. Dit is een belangrijke beperking om te controleren vóór indiening, aangezien het vergrendelen van het basiscomponent van een variantenset een veelgebruikte beveiligingsmaatregel is in designsystemen. Na de vertaling worden de tekstfragmenten teruggestuurd naar Figma, hetzij door ze direct via de plugin toe te passen, hetzij door de vertaalde JSON te importeren via Plugins > Smartling > Importeren (Handmatig). Dezelfde vertaalgeheugens Leverage, SmartMatch en Fuzzy Estimates, en de door AI verbeterde invoeging van termen in de woordenlijst die overal elders in Smartling worden gebruikt, zijn van toepassing op de herhaalde knoplabels, tooltips en foutmeldingen die in de verschillende varianten van een componentenset voorkomen. Smartling is op G2 marktleider op het gebied van vertaalmanagement