Security News
How Threat Actors are Abusing GitHub’s File Upload Feature to Host Malware
GitHub is susceptible to a CDN flaw that allows attackers to host malware on any public repository.
By Sarah Gooding - Apr 23, 2024
@nylas/components-contact-list
Advanced tools
@nylas/components-contact-list
Nylas Contact List (`<nylas-contact-list>`) is part of the Nylas Components library that lets you build user-facing contact functionality into your application in minutes. Use Nylas Contact List with your Nylas account or by passing in your own JSON data.
Readme
Nylas Contact List
Nylas Contact List (<nylas-contact-list>) is part of the Nylas Components library that lets you build user-facing contact functionality into your application in minutes. Use Nylas Contact List with your Nylas account or by passing in your own JSON data.
Table of Contents
Installation
In your JavaScript application, you can install Nylas Contact List with:
- npm
npm i @nylas/components-contact-list - Yarn
yarn add npm i @nylas/components-contact-list
Alternatively, on an html page, you can load the Contact List using a script tag:
<head>
<!-- Import the script from CDN -->
<script src="https://unpkg.com/@nylas/components-contact-list"></script>
</head>
For both installation options, in the body of your page, you can instantiate the contact list with <nylas-contact-list></nylas-contact-list>.
Using It in Your App
All Nylas components have two ways of dislaying data to your end-user:
Fetching data directly from Nylas
Setup
If you haven't registered for a Nylas account yet, you can do so at dashboard.nylas.com. Once there, head to the Components tab and create a new Contact List component.
You'll be guided through the component setup and be given the option to tie your component to your calendar account. Review the Contact List Documentation.
Allowed domains
During the setup process, you'll be prompted to provide a list of allowed domains. Be sure to add any domains you'll be testing your app on, including localhost, and any staging and production URLs you might use.
Passing in your own data
Nylas Contact List can be used as a UI on top of any contacts that you provide. Events should follow the Nylas contacts object standard.
The property to use for this is contacts. You can pass in an JSON array of contacts.
const staticContacts = [
{
"emails": [
{
"email": "tom@brightideas.com"
}
],
"given_name": "Thomas Edison"
},
{
"emails": [
{
"email": "alex@bell.com"
}
],
"given_name": "Alexander Graham Bell"
},
{
"emails": [
{
"email": "al@particletech.com"
}
],
"given_name": "Albert Einstein"
}
];
Then pass the array into your component using any JavaScript.
<nylas-contact-list contacts={staticContacts}>
You can also use plain JavaScript as an attribute.
document.querySelector("nylas-contact-list").contacts = staticContacts;
Properties
Nylas Contact List allows for several properties that affect the layout and functionality of your component. You can find a complete list of properties within our Documentation for Nylas Contact List
Events and Callbacks
You can listen to certain user events from your application by adding an event listener to your component.
For example, you can listen for a contactClicked event with the following code:
document
.querySelector("nylas-contact-list")
.addEventListener("contactClicked", (event) => {
let { detail } = event;
console.log("contact clicked", detail);
});
Contributing
Please refer to our Contributing Guidelines for information about how to get involved. We welcome bug reports, questions, and pull requests.
- Git clone
git@github.com:nylas/components.git - Run
yarn install - Run
yarn start; your browser will loadhttp://localhost:8000and show you a list of available running components
Testing
yarn cy:open will launch our end-to-end tests in a browser
tests will automatically be run on push from push.yaml
Additional Documentation
FAQs
Nylas Contact List (`<nylas-contact-list>`) is part of the Nylas Components library that lets you build user-facing contact functionality into your application in minutes. Use Nylas Contact List with your Nylas account or by passing in your own JSON data.
The npm package @nylas/components-contact-list receives a total of 111 weekly downloads. As such, @nylas/components-contact-list popularity was classified as not popular.
We found that @nylas/components-contact-list demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 9 open source maintainers collaborating on the project.
Last updated on 15 Dec 2021
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Related posts
Security News
The Dark Side of Open Source
At Node Congress, Socket CEO Feross Aboukhadijeh uncovers the darker aspects of open source, where applications that rely heavily on third-party dependencies can be exploited in supply chain attacks.
By Sarah Gooding - Apr 19, 2024
Research
Security News
npm Package for ReExt React Components Library Exfiltrates Git Credentials
The Socket Research team found this npm package includes code for collecting sensitive developer information, including your operating system username, Git username, and Git email.
By Sarah Gooding, Socket Research Team - Apr 18, 2024