Using Knockout in Magento 2

Reading Time: 2 minutes

Many people who are new to Magento and have read about Knockout JS before will think this is just confined to the new checkout page (and this is where Knockout JS is mainly used in M2). In reality, Knockout JS can be used anywhere within the front-end to create anything from a custom color picker to your own custom image viewer.

Now we know how Knockout JS can be used within Magento 2, so let’s jump into a quick example of how to set up a basic component.

Creating a component

In this example, we’ll be defining a component outside the checkout. There are five steps to get a working component:

1.- Create a new phtml template file

Create a new block template file (phtml) in your module of choice (our example will use the Magento_Catalog module):

app/design/frontend/YOUR_PACKAGE/YOUR_THEME/Magento_Catalog/templates/newko-component.phtml

2.- Create an XML

app/design/frontend/YOUR_PACKAGE/YOUR_THEME/Magento_Catalog/layout/catalog_category_view.xml

<?xml version="1.0"?>
<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
    <body>
      <referenceContainer name="content">
        <block class="Magento\Framework\View\Element\Template" name="new.ko.component" template="Magento_Catalog::newko-component.phtml" before="category.products" />
      </referenceContainer>
    </body>
</page>

3.- Define Knockout in phtml

<div id="m2-component" data-bind="scope:'m2kocomponent'">
    <!-- ko template: getTemplate() --><!-- /ko -->
    <script type="text/x-magento-init">
    {
        "#m2-component": {
            "Magento_Ui/js/core/app": {
               "components": {
                    "m2kocomponent": {
                        "component": "Magento_Catalog/js/m2kocomponent",
                        "template" : "Magento_Catalog/m2kocomponent-template"
                    }
                }
            }
        }
    }
    </script>
</div>

4.- Create a component file

app/design/frontend/YOUR_PACKAGE/YOUR_THEME/Magento_Catalog/web/js/m2kocomponent.js

define(['jquery', 'uiComponent', 'ko'], function ($, Component, ko) {
        'use strict';
        return Component.extend({
            initialize: function () {
                this._super();
            }
        });
    }
);

5.- Create an html template file

app/design/frontend/YOUR_PACKAGE/YOUR_THEME/Magento_Catalog/web/template/m2kocomponent-template.html

<div class="component-wrapper">
    <div data-bind="text: 'Catalog Timer'"></div>
</div>

Clear your Magento 2 cache. If everything worked out, you should see some text at the top of your category page, saying 'Catalog Filter'.

Now that we have a working component setup we can start taking a look at how powerful KO JS is within the context of Magento 2, at this point, we have a UI component that we can manipulate through Knockout.

If you want to know about MagmaLabs, visit us here!

Thanks to Juan Carlos Gil, the author of this cool blog post!

0 Shares:
You May Also Like
Read More

Magento TDD with PHPSpec

Reading Time: 4 minutes Today, we are implementing the MageTest/MageSpec Module based on PHPSpec toolset. In this implementation, we have two different…