Skapa och återanvända JavaScript-funktioner

Skriptobjektet är ett objekt som du kan använda för att lagra JavaScript-funktioner och värden utan att lägga dem i ett visst formulärobjekt. Det används normalt för att skapa anpassade funktioner och metoder som ska användas i skript på många ställen i formuläret. På så sätt behöver du inte skriva samma kod flera gånger när olika skript ska utföra samma handling.

Skriptobjektet stödjer bara skript som har skrivits i JavaScript. Det finns dock inga begränsningar när det gäller varifrån skripten kan köras, förutsatt att skriptspråket för händelsen som anropas är inställt till JavaScript.

Både Acrobat och Forms bearbetar skript från ett skriptobjekt på samma sätt, men de skiljer sig också åt.

Bara skript som ska köras på klienten kan använda skriptobjekt som har ställts in för körning på klienten, och tvärtom.

    Skapa ett skriptobjekt

    Du skapar ett nytt skriptobjekt i två steg. Först lägger du till själva objektet till formulärdesignen, och sedan skriver du det skript som ska finnas i skriptobjektet.

    1. Skapa ett nytt formulär eller öppna ett befintligt formulär.

    2. Högerklicka på ett objekt på formulärnivå eller delformulärnivå på paletten Hierarki och välj Infoga skriptobjekt.

      Visa grafik i full storlek
      A. Objekt på formulärnivå B. Objekt på delformulärnivå C. Skriptobjekt på delformulärnivå D. Skriptobjekt på formulärnivå

    3. (Ej obligatoriskt) Högerklicka på skriptobjektet och välj Byt namn på objekt.

      Lägga till skript till ett skriptobjekt

      När skriptobjektet finns i formuläret kan du lägga till skript med hjälp av skriptredigeraren.

      1. Markera skriptobjektet på paletten Hierarki.

        Skriptredigeraren visas med både ett skriptobjektsvärde i listan Visa och ett JavaScript-värde i listan Språk. Dessa värden kan inte ändras.

        Visa grafik i full storlek

      2. Skriv in skriptet i fältet Skriptkälla.

      3. Klicka på fliken Förhandsgranska PDF och testa formuläret.

      Exempel

      Skapa t ex ett skriptobjekt med namnet feedback som innehåller följande funktion:

      function emptyCheck(oField) { 
 
    if ((oField.rawValue == null) || (oField.rawValue == "")) { 
        xfa.host.messageBox("You must input a value for this field.", "Error Message", 3); 
    } 
}

        Referera till JavaScript-funktioner lagrade i ett skriptobjekt

        När du har lagt till skript till ett skriptobjekt, kan du referera till skriptobjektet från alla händelser som stödjer JavaScript-skript.

        1. Välj ett objekt i formuläret och välj sedan en händelse i listan Visa.

        2. Skapa en referens till skriptobjektet och eventuella funktioner som ingår i skriptobjektet. I följande allmänna syntax förutsätts att objektet där du refererar till skriptobjektet finns på samma nivå som skriptobjektet i formulärhierarkin, eller att skriptobjektet finns på den högsta nivån i formulärhierarkin.

          script_object.function_name(parameter1, ...);

        3. Tillämpa det nya skriptet på formulärobjektet och testa det sedan genom att förhandsgranska formuläret på fliken Förhandsgranska PDF.

        Som för refererenser till andra objekt i ett formulär måste du ange en giltig syntax när du refererar till skriptobjekt där det finns i formulärhierarkin. Mer information om hur du refererar till objekt i skript finns i Referera till objektegenskap och värde.

        Exempel

        Med utgångspunkt från skriptobjektexemplet i Lägga till skript till ett skriptobjekt placerar du följande JavaScript-skript i händelsen exit för ett textfält. Testa formuläret genom att använda fliken Förhandsgranska PDF.