På denne side

Introduktion til dynamiske udtryk

Opret personligt og datadrevet indhold ved hjælp af dynamiske udtryk.

Dynamiske udtryk gør det muligt for dig at oprette personligt og datadrevet indhold i dit workspace. Ved at kombinere datavariabler, brugerdefinerede oversættelser og formler kan du gøre dit indhold mere dynamisk og målrettet mod din målgruppe.

Du kan for eksempel vise en personlig besked ved at skrive:

"Velkommen tilbage, {{ sessionUser.name }}!"

Dette indsætter brugerens navn direkte i beskeden.

For at lade vores system udfylde dataene og gøre dem visuelt forskellige fra andet indhold, er dynamiske udtryk altid omsluttet af dobbelte krøllede parenteser: {{ ... }}.

Skriv dit første dynamiske udtryk

Et brugernavnsudtryk indsat i en beskrivelse af en idesamling og vist som et navn
  1. Gå til et tekstfelt, hvor udtryk er tilladt (f.eks. et spørgsmål i en idesamling).
  2. Skriv { for at få vist en liste over tilgængelige variabler og funktioner.
  3. Vælg et forslag, eller skriv dit eget udtryk.
  4. Tilføj operatorer og funktioner efter behov.
  5. Klik et andet sted for at se dit dynamiske udtryk i brug.

Mange tekstfelter beregner og viser straks resultatet af evalueringen af alle dynamiske udtryk i feltet, baseret på dig og dine egne data, når feltet mister fokus. Kontrollér, om resultatet er som forventet. Og bare rolig, du har ikke mistet noget af det, du har skrevet – hvis du klikker på tekstfeltet igen, vises dine dynamiske udtryk igen, så du kan fortsætte med at redigere dem.

Typer af dynamiske udtryk

Dynamiske udtryk består af forskellige komponenter, der arbejder sammen om at vise personlige eller beregnede resultater.

Datavariabler

Datavariablerrepræsenterer data, der er specifikke for dit workspace, såsom brugernavne, antal ideer eller formularværdier.

  • Eksempel: {{sessionUser.name}}vises muligvis som "John Doe."

Brugerdefinerede oversættelsesvariabler

Brugerdefinerede oversættelsesvariablerer tilpassede lokaliseringsnøgler, som du kan oprette og bruge på tværs af din platform til at vise dit indhold på forskellige sprog. Når de bruges, vises indholdet på det sprog, som den besøgende bruger har valgt i sin profil, hvis du har defineret en oversættelse til det pågældende sprog.

  • Eksempel: {{translate:custom.greeting}}viser en lokaliseret version af din hilsen.

Funktioner

Funktionerudfører handlinger som at omdanne data eller foretage beregninger. På listen vises en signatur for de argumenter, der skal angives, samt deres forventede datatyper. Funktionen UPPERCASE() forventer for eksempel at modtage tekst. Derudover vises en beskrivelse af, hvad funktionen gør, samt et eksempel på, hvordan du kan bruge den.

  • Eksempel: {{ UPPERCASE(sessionUser.name) }} konverterer en brugers navn til STORE BOGSTAVER.

Operatorer

Operatorer bruges til beregninger og sammenligninger.

  • Aritmetik: +, -, *, /
  • Logik: && (AND), || (OR)
  • Sammenligning: ==, !=, >, <
  • Betinget: ?
  • Eksempel: {{ sessionUser.stats.likes > 10 ? "Top Contributor" : "Newbie" }} viser "Topbidragyder", hvis antallet af likes overstiger 10, ellers "Ny bruger."

Litteraler

Litteraler eller "rå værdier", såsom tal, tekst eller booleske værdier, kan også frit bruges i Dynamisk udtryk.

  • Eksempel: {{ 5 }} eller {{ "Hello, world!" }} eller {{ true }}

Fejlhåndtering

Da dynamiske udtryk er ret fleksible og giver dig stor frihed, kan de også nemt gå i stykker, og nogle gange på måder, du måske ikke forventer. Du kan for eksempel ende med at:

  • Dividere et tal med nul.
  • Glemme en afsluttende parentes et sted i dit udtryk.
  • Referere til en brugerdefineret oversættelsesvariabel, der ikke findes (eller er blevet slettet).
  • Forsøg ved en fejl at konvertere ikke-tekst til versaler, f.eks. et tal.

Heldigvis er dynamiske udtryk, der ikke kan beregnes korrekt, nemme at genkende, hvis du ender i sådanne situationer, og når du holder markøren over dem, kan du se præcis, hvor og hvad problemet var.

Her er nogle ting, du bør være opmærksom på, når du skriver dynamiske udtryk, for at mindske risikoen for fejl:

  • Sørg for at tælle antallet af parenteser, du bruger, især når du kombinerer flere funktioner
  • Når du udfører division, og især når divisoren er baseret på en datavariabel, skal du sørge for at tage højde for tilfælde, hvor divisoren kan være nul. Du kan bruge funktionen MAX() for at sikre, at værdien aldrig bliver mindre end 1. Sørg for eksempel for mindst 1 like: {{ 2 / MAX(sessionUser.stats.likes, 1) }}.

Sørg for at dobbelttjekke de forventede argumenttyper for de funktioner, du bruger, samt den rækkefølge, de forventer argumenterne i.

For eksempel vil {{ UPPERCASE(2) }} mislykkes, da UPPERCASE() forventer tekst, men fik et tal.

Enkle eksempler på dynamiske udtryk

  • Enkel beregning: {{ 2 + 3 }} viser 5.
  • Personlig meddelelse: Hej {{sessionUser.name }} viser en tilpasset hilsen.
  • Betinget visning: {{ ideaCollection.stats.ideas.total > 50 ? "We've reached our goal!" : "Needs more ideas!" }} tilpasser sig efter engagementet med ideer.

Ved at kombinere disse komponenter kan du skabe effektive, personligt tilpassede oplevelser for brugerne af dit workspace.