现在,即使是创建最基本的网站,程序员也必须使用现代的功能和技术。甚至像为你的朋友创建简单的投资组合这样的基本项目也可能涉及到一些问题,比如从联系人表单接收数据。有很多方法可以读取这些数据。你可以将表单与数据库连接起来,然后从数据库中读取传入的消息来实现功能,但这样做会给不懂技术的客户造成困难。
; M1 O8 x' b* A' G6 v你为什么不通过发送电子邮件传输信息?
' [. ?( A9 U8 }5 J. o+ o8 e5 C/ q 不使用数据库就能接收到传入的消息,绝对是最佳选择,也是最方便用户的选择。但问题来了—如何实现呢?你可能认为需要使用某种后端语言。' U1 ^" j6 L3 ]
) q( x7 U/ q2 i) {+ O; W 实际上,你不必使用任何如 php 或 python 这种后端语言,你甚至不需要用到 node.js! 你需要的就是一个简单的 EmailJS 库(后附本项目源码)。4 @( v1 |, J; _2 X
本文将介绍下面两个重要功能:/ _' E" B& D) h W- k1 h
- 配置 emailjs 帐户
- 使用 JS 发送电子邮件; w1 `+ `. |! G6 J% ~" V
请注意,在项目中使用了 gulp 和 webpack,在 src 文件夹存放源码,dist 存放最终发布版本的代码。下面将分 5 个步骤向你展示如何从头开始构建电子邮件发送器。4 @, `& Q4 e' @% W# ]3 G0 Q4 ^
步骤1-用 HTML 创建表单
# C1 J$ }3 y5 q! L 首先需要创建一个 HTML 表单。你不必放置像 required 或 max 这种验证属性,因为稍后,preventDefault() 函数将在你的提交事件上运行,它会让这些属性的处理失效。
( n* q. n. M# g9 _- c/ G7 q5 p 表单中最重要的是为每个输入放置 name 属性,后面会用到。简单的表单是这样的:$ D7 s% F5 [" _ q
src/html/index.html 1 C& a* n6 s( a; L1 W' R
<form class="form">
<input name='name' type="text" placeholder="Your name..." class="form__input" />
<input name='topic' type="text" placeholder="Topic..." class="form__input" />
<textarea name='message' type="text" placeholder="Your Message..." class="form__input" ></textarea>
<input type="submit" value="send" class="form__input form__input--button">
</form> 步骤2-注册成为 email 用户6 o0 B1 r2 [- n: J9 W
要配置你的电子邮件,你必须注册电子邮件服务。别担心—使用这个网站非常方便和省时。登入后,系统会询问你的电子邮件服务,它位于个人电子邮件服务区(personal email service)。在例子中选择的 gmail。
& Q2 D6 J9 @& Q' D) G$ @
7 r* P) ~. ]; t- J
然后,你需要连接你的 gmail 帐户。这将用来发送电子邮件给你客户。例如,如果你关联了 xyz@gmail.com 账户,你后续发送的邮件都将从这个邮箱发出。所以不要担心“ Send email on your behalf” 这个授权信息—这正是你需要的!
6 ]1 n0 Z! G6 W, ~
, B; G* E! f* _3 d; z9 a 连接完 gmail 账户后,点击添加服务(add service)按钮。
) T: S- ~& T+ D/ k# [. h步骤3-创建邮件模板% d0 B; Z: B6 H( M$ y
如果你已经成功连接了你的 gmail 账户,你现在应该在信息中心中。现在需要创建电子邮件模板了。切换到电子邮件模板卡,并单击创建一个新的模板(create a new template)。界面非常友好,所以创建模板不会有任何问题。你可以选择模板的名称和 ID。称之为“我的神奇模板(my_amazing_template)”。
7 K/ {1 X8 i, j0 j+ z
. Y8 p) {* V2 x' L7 }* M. \% F! O
接下来,你必须指定邮件的内容。模板的变量值来自 input 中的 `name` 属性。你已将变量插入`{{{}}}`符号中。
% ^* S' U" J$ c6 o 不要忘记在“收件人”部分 (右侧) 添加电子邮件地址。你的电子邮件将被发送到该电子邮件地址上。这是一个简单模板,它使用来自 HTML 表单里的 3 个变量,还指定了接收电子邮件的主题。. V' C7 a3 x4 Q( ?1 b/ y! M
9 C8 t' @% L, `: c! B- h z步骤4-保存 API 密钥
- I) B0 t2 k% n! e9 ^- f7 h 这部分没什么特别的。Emailjs 共享授权 API 密钥,将在发送电子邮件时使用。当然,放这些钥匙最好的地方是`.env` 配置。但是因为这里使用的是简单的静态文件,不想使用服务器配置,所以将它们保存在 apikeys 文件中,然后再将它们导入。
) [: M+ w! X& G0 b6 @3 P+ H" E9 X1、你的 USER_ID 位于 Account > API Keys 菜单下。
; i; s1 _! |7 P. J/ C, @6 g
- s f& G3 n# ?- `( J1 L6 ?1 E
2、TEMPLATE_ID 位于模板的标题下面。+ ^ E0 T* Q3 z$ ^: i
/ K6 l/ ?: y; B5 l8 ^$ Z+ i
这是基于不存在的 keyssrc / js / apikeys. js 的示例配置。
3 x* R% Y$ _8 H3 b. f/ l src/js/apikeys.js$ `0 v5 R8 a, z- o
export default {
USER_ID :'user_DPUd-rest-of-my-id',
TEMPLATE_ID:'my_amazing_template'
} 如果需要将源码发布到 GITHUB,不要忘记将 APIKEYS 文件添加到 .GITIGNORE文件中
) `* ] S1 C/ M2 S/ T2 X步骤5-发送电子邮件
, p* z$ E9 p! a' p7 f9 { 现在是该项目最后也是最重要的部分的了。现在我们必须使用 javascript 发送电子邮件。: V' ^; \9 U, R; h+ l! w
首先,你必须下载 emailjs 包。3 D( W1 Q* b/ ^$ t+ F( U( `3 @3 F
npm i emails-com 然后,转到 js 文件,导入库和 apikeys。7 N! h5 @% B) }& e: }( b
src/js/main.js5 ?( e! |3 p, j9 y
import emailjs from 'emailjs-com'
import apiKeys from './apikeys' 现在是编写发送电子邮件功能的时候了
0 C" Y' g) U* {' H* f src/js/main.js ( U j- B2 d% Q0 K6 i# U
const sendEmail = e => {
e.preventDefault()
emailjs
.sendForm('gmail', apiKeys.TEMPLATE_ID, e.target, apiKeys.USER_ID)
.then(
result => {
console.log(result.text)
},
error => {
console.log(error.text)
}
)
} sendForm 函数有4个参数:$ H- C3 o. I% c+ _( a5 v* i; S" W
你的电子邮件的 ID,在这里:
1 Z( _/ H( ?. y
$ B/ V$ d- i, `5 D" ?, `$ r* B- TEMPLATE_ID 来自 apikey 文件
- 事件对象来自你的表单提交
- USER_ID 来自 apikey 文件
! {: `; K$ K, t5 [! D3 G 最后,查找表单并添加提交事件监听器:
% {2 ^" c- u$ @6 Z src/js/main.js j9 g9 ~' b8 U* B, o
const form = document.querySelector('.form')
form.addEventListener('submit',sendEmail) 正如前面提到的,由于 `preventDefault()` 函数,属性验证将无法工作。你必须使用 JS 自己进行验证和清除输入。以上就是全部内容,接下来让我们测试一下。
# Z+ }: |# ]) p 填写页面上的表单并发送。' t; @, R) t1 I0 C7 |& G7 S
5 ]* x, j- `$ o8 l# W2 d- A
现在收到了电子邮件,内容正是根据我们的模板和表单数据渲染出来的。
4 Z+ i, u+ X. n$ V6 G9 S5 Y+ `
% k( f( g8 K1 o9 `. K! ~. e# H 通过上图可以看出,所有的变量的值都填充到了正确的位置上。! g. ]1 J2 r: t5 i
配套代码在这里: https://github.com/iwaniukooo11/email-sender |