Salesforce Lightning Design System (SLDS)

SLDS for Flask and Angular


At this moment our UI looks ugly without any styles. To make it looks better we can to use any of existing CSS frameworks. I tried Bootstrap (https://getbootstrap.com/), Foundation (https://get.foundation/), UIkit (https://getuikit.com/). But as a Salesforce developer I found SLDS (https://www.lightningdesignsystem.com/) is closer to my heart. Let's add it to our project.

Download last SLDS (current version is 2.11.6) from
https://www.lightningdesignsystem.com/downloads/

Extract it to the ./backend/static/slds folder. There are few other ways to add SLDS to the project:
- from NPM in the Angular subproject. But in this case it can be accessible by Angular only and is compiled as part of the result bundle. But we have Flask project as global playground and few pages (like /auth/login) should work out of the angular context but have the same look.
- external CDN (like https://cdnjs.com/). I like this approach and use it often during development time, but in case of SLDS it doesn't work. SLDS contains great SVG icons collection and SVG flow doesn't work due to security limitations in browsers.
So the right place to use SLDS is ./backend/static folder

Also I create global.css in ./backend/static where I will hold custom styles for global context.

Here is updated base template

./backend/templates/_base.html
<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Salesforce Backup Service</title>

    <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js"></script>

    <link rel="stylesheet" href="/static/slds/styles/salesforce-lightning-design-system.min.css" />

    <link rel="stylesheet" href="/static/global.css">

    {% block header %}{% endblock %}

</head>
<body>

    <div class="main-wrapper">
        <div class="c-header">
            <span class="slds-icon_container slds-icon-custom-custom5" title="Description of icon when needed">
                <svg style="width: 50px; height:50px;" class="slds-icon" aria-hidden="true">
                    <use xlink:href="/static/slds/icons/custom-sprite/svg/symbols.svg#custom5"></use>
                </svg>
            </span>
            <h1 class="c-header-title">Salesforce Backup Service</h1>
        </div>

        <hr />

        <div class="c-body">
            {% block content %}{% endblock %}
        </div>

        <hr />

    </div>

    <footer style="text-align: center;">
        <p>&copy; 2020 - Salesforce Backup Service</p>
    </footer>

</body>
</html>

You should notice two new link tags with css
<link rel="stylesheet" href="...">
and global.css goes after SLDS that allow us to override some standard behavior.

Also as an example of working SLDS I put Logo SVG Icon to header.

SLDS in Flask and Angular project


Comments

Post a Comment

Popular posts from this blog

HTTPS in local environment for Angular + Flask project.

Image
Sometimes it is important to run project in local environment with HTTPS. For example when you use third party authentication system in our app. In my case I prefer to have local instance similar as mush as possible to the production. Moreover, it’s easy to implement. First what you need is the ssl key. You can follow this article to create it https://devcenter.heroku.com/articles/ssl-certificate-self Create your ssl key in ./key project folder. Finally it should look like this [dmnbrest@~/Documents/myPython/blog2/project/key]$ ls server.crt server.csr server.key Add HTTPS support to the FLASK: Update init section in your backend server file ( ./backend/app.py ) this way if __name__ == "__main__":     context = ('./key/server.crt', './key/server.key')     app.run(ssl_context=context, host='0.0.0.0', debug=True) But now we need to run backend with other command python ./backend/app.py This time you should see this output in
Read more

Salesforce Authentication 2 (Token Validation and Refresh)

Image
In last article we added Salesforce connection setup logic to our application. Now we need to implement connection test logic and token refresh flow.  Connection test flow is a simple request to Salesforce API with access_token. If we receive valid response it means all works fine. In other case we should notify user about problems with Salesforce integration. I mentioned last time when we setup connection and receive response I save it to DB as is as it contains many useful information. And now we can use part of this response. Here is example of OAuth handshake response: { 'access_token': '00Dxxxxxxxxxx', 'refresh_token': '5Aezzzzzzzzzz', 'signature': '8KFGb34p3vMLhSRHHmJZN3Bux9tlcA1+cvgIACw2SG4=', 'scope': 'refresh_token api', 'instance_url': 'https://ap17.salesforce.com', 'id': 'https://login.salesforce.com/id/00D2x000003v71DEAQ/0052x000001S9ojAAC', 'toke
Read more

User authentification with Flask-Login

Image
One important step of project preparation is Security. We plan to publish our app to Heroku where it will be accessible by anyone in the world. Let's make it more secure with Flask-Login ( https://flask-login.readthedocs.io/en/latest/ ). There is one post I will follow. https://www.digitalocean.com/community/tutorials/how-to-add-authentication-to-your-app-with-flask-login But I will simplify it and will use login flow only at this moment as we don't need registration. But for new user creation I will add cli script. To add auth flow to our app we need to create Login View with Controller and some additional service methods for Flask-Login. Also we have to update User model a little bit. backend/models/user.py from models import db from flask_login import UserMixin class User(UserMixin, db.Model): __tablename__ = 'users' id = db.Column(db.Integer, primary_key=True) username = db.Column(db.String(255), unique=True, nullable=False) email
Read more