Etap 8: Wykonywanie czynności

Pod koniec tego etapu będziemy potrafili przeciągać na stronę składniki wykonujące czynności w danym składniku. Wykorzystywana jest przy tym rejestracja czynności utworzona w poprzednim etapie.

Składnik, aby móc wykonać czynność, musi nasłuchiwać komunikatu EXECUTE_ACTION. W komunikacie tym jest także zawarty ładunek przekazany do czynności, z którego trzeba wyodrębnić oczekiwane wartości.

Aby był prowadzony nasłuch komunikatu EXECUTE_ACTION, należy otworzyć plik render.js do edycji i zaktualizować w nim obiekt SampleComponentViewModel, używając następującego kodu:

SitesSDK.subscribe('EXECUTE_ACTION', $.proxy(self.executeActionsListener, self));

Po otrzymaniu komunikatu EXECUTE_ACTION zostanie wykonana powiązana funkcja wywołania zwrotnego:

    self.executeActionsListener = function (args) {
      // get action and payload
      var payload = args.payload,
      action = args.action;

      // handle 'setImageWidth' actions
      if (action && action.actionName === 'setImageWidth') {
        $.each(payload, function(index, data) {
          if (data.name === 'imageWidth') {
            self.imageWidth(data.value);
          }
        });
      }
    }

Kod ten tworzy funkcję JavaScript wykonywania czynności, a następnie używa biblioteki Sites SDK do wywołania tej funkcji, gdy tylko zostanie zgłoszony komunikat EXECUTE_ACTION.

Składnik ten będzie wywoływany przy każdym zgłoszeniu komunikatu EXECUTE_ACTION, a o tym, czy czynność ta zostanie wykonana, decyduje sam składnik. Dlatego, aby mieć pewność, że jest to składnik obsługiwany, trzeba sprawdzić jego nazwę.

Ładunek dla czynności ma postać tablicy wartości. Zazwyczaj trzeba będzie odnaleźć w tablicy odpowiednie wartości ładunku.