网站编号：1594

所属分类： 网站模板

网站URL： https://yeee.wang/posts/eb1e.html

最后点入：2024-05-29 14:19:02 · 加入时间：2023-04-14 09:56:11

网站关键词(0个字符):
该站未曾设置keywords

网站描述词(189个字符):
这一年，对于我来说真是压力空前，之前公司接需求的时候大部分情况是看排期，如果排期紧张再协调安排处理。BUT！来这边以后概况大致如下：这边有个需求来处理下，什么？有其他任务？那不是很正常；优先级？并行！都很重要，并行很正常，我这里也有好几个事并行呢，DeadLine是xxx号；做的差不多了您看看？整理好一份文档描述清楚，以便沉淀；你上次做的那个需求有地址吗，有相关介绍吗，有实现

关于yeee.wang说明：
yeee.wang由网友主动性提交被自动秒收录整理收录的，自动秒收录仅提供yeee.wang的基础信息并免费向大众网友展示，yeee.wang的是IP地址：43.139.118.147 [中国广东广州 腾讯云]，yeee.wang的百度权重为0、百度手机权重为1、百度收录为0条、360收录为0条、搜狗收录为0条、谷歌收录为0条、百度来访流量大约在-之间、百度手机端来访流量大约在7之间、yeee.wang的备案号是湘ICP备14015539号、备案人叫王银业、被百度收录的关键词有0个、手机端关键词有3个、迄今为止已经创建5年2个月9天。

下载地址: txt下载、docx下载、pdf下载、rar下载、zip下载

本页地址: https://www.badfl.com/links/46763d78f9554e4046e7.html

SEO信息	百度来访IP：- | 移动端来访IP：7 | 出站链接：0 | 站内链接：0
IP网速：	IP地址：43.139.118.147 [中国广东广州 腾讯云] | 网速：166毫秒
ALEXA排名	世界排名：- | 预估IP：- | 预估PV：-
备案信息	湘ICP备14015539号 | 名称：王银业 | 已创建：5年2个月9天

收录	百度	360	搜狗	谷歌
查询	0	0	0	0

电脑关键词	手机关键词	页面友好	首页位置	索引	近期收录
0	3	电脑端优秀	-	0	0

协议类型HTTP/2.0 200 OK 页面类型text/html 服务器类型openresty 是否压缩是 原网页大小102608 压缩后大小35591 压缩比65.31%

这 一 年 我 的 对 组 件 的 思 考 Y e e s B l o g 个 人 生 活 网 站 分 享 | 王 大 白 H O M E A R C H I V E S C A T E G O R I E S 2 0 2 0 0 2 1 5 架 构 设 计 4 2 分 钟 读 完 ( 大 约 6 2 7 9 个 字 ) 这 一 年 我 的 对 组 件 的 思 考 这 一 年 ， 对 于 我 来 说 真 是 压 力 空 前 ， 之 前 公 司 接 需 求 的 时 候 大 部 分 情 况 是 看 排 期 ， 如 果 排 期 紧 张 再 协 调 安 排 处 理 。 B U T ！ 来 这 边 以 后 概 况 大 致 如 下 ： 这 边 有 个 需 求 来 处 理 下 ， 什 么 ？ 有 其 他 任 务 ？ 那 不 是 很 正 常 ； 优 先 级 ？ 并 行 ！ 都 很 重 要 ， 并 行 很 正 常 ， 我 这 里 也 有 好 几 个 事 并 行 呢 ， D e a d L i n e 是 x x x 号 ； 做 的 差 不 多 了 您 看 看 ？ 整 理 好 一 份 文 档 描 述 清 楚 ， 以 便 沉 淀 ； 你 上 次 做 的 那 个 需 求 有 地 址 吗 ， 有 相 关 介 绍 吗 ， 有 实 现 步 骤 ， 组 件 放 在 哪 里 了 ？ 这 样 聊 不 清 楚 ， 你 写 一 份 文 档 ； H i a l l ， 这 里 有 个 地 方 我 觉 得 这 样 处 理 非 常 零 散 ， 这 不 好 … 那 不 好 … ， 我 觉 得 可 以 这 样 ！ — — 好 这 件 事 ， 你 负 责 跟 进 就 按 照 你 的 想 法 处 理 。 这 里 我 重 新 做 了 一 个 库 ， 可 以 把 这 些 收 集 统 一 处 理 。 哇 ， 不 错 啊 ， 那 可 以 把 我 们 框 架 的 加 载 都 使 用 这 个 处 理 ， 你 抽 空 处 理 下 ？ 可 是 ， 这 样 影 响 面 会 不 会 … . 重 构 完 了 ， 已 经 发 到 预 发 半 个 月 了 ， 有 一 些 业 务 需 求 已 经 对 这 部 分 改 动 有 依 赖 了 ， 需 要 准 备 一 波 上 线 了 ？ 这 样 直 接 发 不 行 ， 风 险 太 高 了 ， 你 去 梳 理 一 份 上 线 计 划 书 ， 对 现 在 线 上 的 几 个 域 的 支 持 页 面 都 做 一 份 回 归 测 试 ； 这 里 有 一 项 新 的 技 术 ？ 你 抽 时 间 研 究 一 下 ， 写 一 份 文 档 ， 准 备 一 次 分 享 会 ； 最 近 招 聘 怎 么 没 动 静 了 ？ 这 样 ， 大 家 以 后 晚 上 2 1 2 1 . 3 0 大 家 一 起 集 体 捞 简 历 。 K P I 沟 通 。 你 近 半 年 做 的 事 情 挺 多 ， 做 的 效 果 也 不 错 ， 同 事 对 你 的 评 价 也 挺 高 。 但 是 都 是 比 较 零 散 的 点 ， 没 有 一 个 面 输 出 ， 期 待 你 后 面 有 更 杰 出 的 表 现 ； 怎 么 才 能 有 一 个 面 的 输 出 ， 给 点 指 导 意 见 ？ 这 样 吧 ， 你 先 把 你 近 半 年 所 有 做 过 的 事 情 详 细 的 写 一 份 文 档 给 我 看 看 ， 我 给 你 点 意 见 ； 华 丽 丽 的 分 割 线 好 了 ， 本 来 是 想 随 便 唠 两 句 引 言 一 下 ， 没 想 到 一 下 子 写 了 这 么 多 。 呼 ~ 突 然 有 种 排 出 一 身 毒 素 的 感 觉 ， 爽 ！ 哈 哈 哈 我 想 了 很 久 ， 这 一 年 的 工 作 我 有 什 么 地 方 做 的 不 够 好 ， 或 者 说 什 么 地 方 我 做 的 没 有 像 别 人 做 的 那 么 好 。 嗯 ， 从 这 点 来 讲 ， 至 少 我 现 在 还 是 在 思 考 如 何 进 步 ， 不 像 之 前 觉 得 自 己 已 经 做 的 非 常 不 错 ， 无 人 能 及 了 。 趁 着 休 息 日 ， 还 有 点 空 闲 时 间 ， 咱 们 来 聊 点 技 术 吧 ！ 背 景 1 9 年 6 月 左 右 ， 我 发 布 过 一 篇 文 章 《 B i t 初 体 验 》 。 在 梳 理 这 篇 文 章 的 过 程 中 ， 我 可 以 说 深 度 体 验 了 一 把 b i t 所 提 出 的 概 念 和 做 法 ， 就 像 一 颗 种 子 种 在 我 的 脑 海 中 ， 一 开 始 我 觉 得 这 东 西 没 什 么 。 我 还 记 得 我 第 一 次 与 我 的 同 事 分 享 b i t 后 ， 他 说 ： e m m ， 虽 然 你 讲 了 这 么 多 ， 但 是 我 觉 得 好 像 没 有 那 么 … 有 体 感 ？ 感 觉 没 什 么 卵 用 ？ 啊 ， e m m ， 既 然 你 说 了 ， 就 像 你 说 的 。 我 觉 得 我 们 现 在 如 果 引 入 b i t 会 不 会 对 我 们 的 日 常 工 作 带 来 很 多 额 外 的 工 作 量 。 这 种 反 应 很 正 常 ， 我 是 在 1 8 年 初 ， 就 在 V u e 的 官 网 见 到 过 b i t ， 当 时 我 点 进 去 大 致 浏 览 过 一 下 。 我 当 时 的 感 受 就 是 ， 没 什 么 卵 用 ， 无 非 就 是 ” 前 端 垂 直 领 域 的 g i t “ 。 对 国 内 的 支 持 情 况 还 不 咋 地 ， 连 一 篇 像 样 的 中 文 文 档 都 找 不 到 。 在 我 们 的 团 队 中 一 下 子 直 接 切 换 到 b i t 的 工 作 流 ， 这 确 实 不 现 实 ， 在 公 司 有 那 么 多 的 基 础 建 设 都 不 知 道 b i t 这 么 个 玩 意 。 但 是 ， b i t 的 做 法 和 概 念 ， 却 是 非 常 非 常 有 价 值 和 可 以 借 鉴 的 ！ 所 以 ， 我 想 做 一 件 事 情 ， 一 步 一 步 的 把 b i t 的 玩 法 用 我 们 熟 悉 的 方 式 引 入 进 来 甚 至 有 所 延 伸 扩 展 ， 让 大 家 认 同 其 中 的 好 处 和 价 值 。 认 识 组 件 随 着 近 些 年 ” 微 前 端 “ 概 念 的 不 断 酝 酿 ， 越 来 越 多 的 团 队 开 始 着 手 将 自 己 的 业 务 处 理 为 不 同 组 件 ， 然 后 通 过 一 定 的 为 前 端 做 法 ， 编 排 到 一 个 业 务 页 面 中 去 。 那 么 对 于 组 件 的 维 护 就 会 变 得 越 来 越 重 要 。 所 以 ， 先 来 看 看 现 在 大 多 数 团 队 是 怎 么 维 护 组 件 的 吧 ！ 大 库 型 ， A n t d 、 E l e m e n t 标 准 的 大 库 型 一 次 型 ， 完 全 业 务 组 件 ， 用 完 一 次 再 也 不 维 护 高 复 用 型 ， 一 看 就 应 该 单 独 封 装 以 后 给 其 他 人 用 ， 比 如 ： 视 频 播 放 器 二 次 封 装 型 ， 一 些 库 拿 原 生 j s 写 的 ， 拿 来 包 装 一 下 当 做 组 件 直 接 引 入 项 目 融 合 型 ， 与 业 务 项 目 在 一 起 ， 混 合 s t o r e ， 不 分 你 我 我 暂 时 能 想 到 的 就 这 几 种 类 型 的 组 件 ， 如 果 你 的 团 队 也 在 维 护 自 己 的 一 套 组 件 库 ， 那 么 应 该 很 容 易 理 解 我 上 面 所 说 的 。 我 相 信 ， 既 然 这 么 做 了 ， 肯 定 有 这 么 做 的 理 由 和 好 处 ， 没 有 人 会 闲 着 没 事 找 麻 烦 做 不 是 ， 那 么 这 些 做 法 都 有 什 么 好 处 和 痛 点 呢 ？ 我 从 几 个 方 面 入 手 分 别 分 析 一 下 。 方 便 、 快 捷 组 件 嘛 ， 当 然 是 最 快 能 跑 起 来 ， 最 方 便 能 看 到 效 果 最 好 咯 。 就 这 点 来 讲 ， 还 有 什 么 比 直 接 在 业 务 项 目 里 撸 组 件 更 快 的 方 式 吗 ！ ？ 现 在 用 个 展 示 的 面 板 ， 立 马 去 c o m p o n e n t s 目 录 撸 一 个 。 数 据 ？ 不 是 有 s t o r e 吗 ？ 引 入 进 来 不 就 拿 到 数 据 了 ！ 所 见 即 所 得 ， 现 在 改 完 马 上 看 到 页 面 上 的 效 果 ！ 无 法 反 驳 . . 这 么 看 确 实 开 发 这 个 组 件 是 好 快 了 ， 但 是 从 整 个 业 务 需 求 实 现 来 看 ， 这 么 做 真 的 是 最 快 的 吗 ？ 如 果 这 样 的 做 法 是 最 快 捷 的 ， 那 为 什 么 那 么 多 团 队 在 强 调 沉 淀 、 封 装 、 抽 象 呢 ？ 其 实 很 多 组 件 当 时 看 起 来 ， 这 辈 子 就 只 可 能 用 一 次 ， 不 用 封 装 。 可 是 往 往 交 互 稿 过 来 的 时 候 就 会 发 现 ， 这 个 样 式 好 像 我 在 哪 里 见 过 。 然 后 去 各 种 业 务 项 目 里 一 顿 翻 ， 哇 终 于 找 到 了 ， 复 制 过 来 发 现 各 种 爆 红 ， 定 睛 一 看 ， s t o r e ？ ？ ？ 所 以 ， 聪 明 的 团 队 早 已 洞 察 这 一 切 ， 让 我 们 把 组 件 都 维 护 到 同 一 个 地 方 ， 然 后 大 家 写 好 文 档 ， 用 的 时 候 从 库 里 面 取 就 可 以 了 ， 有 B u g 的 话 统 一 修 复 就 是 ， 棒 👍 ！ 可 维 护 性 于 是 乎 ， 大 家 便 如 火 如 荼 的 开 始 的 组 件 抽 象 ， 组 件 整 改 的 浩 大 工 程 。 一 开 始 ， 一 般 会 有 一 个 团 队 中 较 为 靠 谱 、 能 力 突 出 的 小 伙 子 （ 嗯 ？ 怎 么 是 我 ？ ） 去 把 W e b p a c k 、 B a b e l 、 T y p e S c r i p t 、 S a s s \ \ L e s s 、 目 录 结 构 、 单 元 测 试 结 构 、 代 码 规 范 、 R e v i e w 规 范 、 发 布 规 范 这 些 梳 理 好 ， 然 后 写 一 个 标 准 的 组 件 出 来 ， 最 后 再 强 调 一 下 大 家 一 定 要 按 照 规 范 认 真 维 护 组 件 ， 书 写 文 档 ， 编 写 单 元 测 试 。 从 维 护 性 上 来 讲 ， 大 家 把 组 件 都 写 在 一 个 库 里 面 ， 然 后 再 用 到 的 项 目 中 直 接 引 入 ， 业 务 上 的 问 题 逐 渐 被 分 为 组 件 问 题 还 是 项 目 问 题 ， 甚 至 有 些 需 求 可 以 用 这 个 交 互 在 组 件 库 中 有 相 似 的 ， 用 那 个 组 件 就 可 以 了 ， 来 反 驳 产 品 和 设 计 😏 。 就 在 大 家 用 的 不 亦 乐 乎 的 时 候 ， 有 一 天 发 现 ， 呀 ， 我 们 的 组 件 库 怎 么 打 包 出 来 有 1 0 m 啊 😱 ！ 然 后 找 一 个 靠 谱 、 能 力 突 出 的 小 伙 子 （ 没 错 又 是 我 ） 就 去 查 了 下 ， 这 个 库 是 谁 引 入 的 ？ 这 个 组 件 不 是 已 经 有 一 个 了 吗 ？ l o d a s h 不 是 这 么 用 的 呀 ！ 这 个 组 件 是 干 什 么 的 ， 怎 么 没 文 档 ？ 面 对 上 百 个 业 务 组 件 ， 只 能 感 叹 一 声 业 务 迭 代 的 可 真 快 啊 。 所 以 ， 大 库 维 护 固 然 有 大 库 维 护 的 好 处 和 适 用 场 景 ， 大 家 能 够 有 这 样 的 抽 象 思 维 已 经 是 技 术 上 的 突 破 了 ， 现 在 只 是 遇 到 了 另 外 一 个 问 题 ， 解 它 ！ 组 件 大 小 、 加 载 性 能 接 触 w e b p a c k 的 一 些 周 边 工 具 ， 比 如 a n a l y z e r 很 容 易 可 找 出 具 体 是 什 么 包 ” 霸 占 “ 了 这 么 多 的 流 量 。 发 现 原 来 组 件 包 中 还 有 一 些 个 组 件 ， 看 上 去 不 应 该 放 在 大 库 中 进 行 维 护 ， 比 如 那 种 一 次 性 组 件 ， 二 次 封 装 型 组 件 。 因 为 这 种 组 件 可 能 会 引 入 一 个 很 大 的 第 三 方 依 赖 ， 比 如 视 频 播 放 器 、 B a n n e r S w i p e r 等 。 对 于 这 样 的 组 件 ， 最 好 的 处 理 方 式 应 该 是 创 建 一 个 独 立 的 仓 库 ， 封 装 完 善 后 ， 写 好 R E A D M E ， 发 布 至 内 网 N P M ， 供 业 务 项 目 使 用 。 B u t y o u k n o w ， 这 样 做 成 本 太 高 ， 如 果 有 时 间 的 话 ， 我 肯 定 … . . b a l a b a l a … （ 一 般 来 说 ， 如 果 你 对 程 序 员 说 一 个 更 好 的 方 案 时 ， 除 非 这 个 方 案 他 有 参 与 设 计 ， 否 则 大 部 分 回 复 都 是 这 样 🙄 ） 当 然 组 件 大 小 这 方 面 也 可 以 通 过 很 多 其 他 方 式 解 决 ， 比 如 ： 异 步 加 载 ， N P M 引 入 ， 按 需 加 载 等 等 啦 … 那 么 ， 让 我 们 谈 谈 下 面 另 外 一 个 很 重 要 、 又 很 容 易 被 忽 略 的 部 分 吧 。 组 件 说 明 及 可 索 引 性 老 板 ， 我 们 今 年 沉 淀 了 组 件 2 0 0 + ， 其 中 有 几 个 组 件 写 的 特 别 好 ， 同 时 支 撑 了 2 0 + 项 目 。 哇 ， 这 么 棒 ！ 来 给 我 看 看 你 们 写 的 组 件 长 什 么 样 ？ 啊 ， 这 ， 这 样 来 看 看 我 们 做 的 这 个 页 面 ， 这 个 页 面 里 面 用 了 这 几 个 组 件 ， b a l a b a l a … 设 计 ： 听 说 你 们 已 经 沉 淀 了 2 0 0 + 组 件 ， 能 给 我 们 看 看 有 哪 些 组 件 吗 ？ 我 们 在 下 次 设 计 的 时 候 可 以 参 考 这 些 组 件 进 行 输 出 ， 减 少 沟 通 成 本 。 前 端 ： @ 所 有 人 这 个 组 件 我 们 库 里 面 有 吗 ？ 有 ， C a s c a d e S e l e c t 。 哦 ， 怎 么 用 的 ？ 有 文 档 吗 ？ … … . 看 下 源 码 吧 。 w e l l . . 😅 组 件 的 说 明 及 可 索 引 性 ， 其 实 仅 次 于 组 件 的 可 用 性 ， 甚 至 更 高 。 试 想 下 如 果 今 天 你 写 了 个 巨 牛 的 组 件 ， 复 用 性 、 接 口 设 计 和 交 互 设 计 都 非 常 棒 ， 但 是 你 有 什 么 渠 道 能 让 大 家 一 下 子 就 知 道 吗 ， 难 道 你 要 专 门 为 此 拉 大 家 开 个 会 ？ 来 今 天 占 用 大 家 1 个 小 时 的 宝 贵 时 间 ， 介 绍 下 我 今 天 写 的 巨 牛 组 件 。 🤕 反 过 来 想 ， 如 果 我 在 写 组 件 的 时 候 ， 反 正 我 这 个 组 件 也 没 啥 亮 点 ， 别 人 应 该 也 不 会 用 到 ， 就 不 用 补 充 文 档 了 吧 ， 应 该 也 没 人 会 知 道 。 哦 豁 ， 丸 蛋 🙃 索 引 组 件 ， 来 给 大 家 分 享 一 张 图 ： 如 果 有 一 天 你 团 队 的 组 件 库 也 能 像 这 样 ， 一 板 一 眼 有 图 有 真 相 ， 那 该 是 多 么 幸 福 和 享 受 的 一 件 事 情 ！ 我 也 知 道 这 样 好 啊 ！ 谁 不 知 道 ！ 如 果 我 有 时 间 ， 我 肯 定 会 … . b a l a b a l a … 所 以 你 的 意 思 是 让 我 们 每 写 一 个 组 件 不 但 要 补 充 文 档 ， 还 要 补 充 用 法 说 明 ， 还 要 截 图 ！ ？ 对 ， 还 要 单 独 建 库 ， 还 要 考 虑 配 置 W e b p a c k 、 B a b e l 、 T y p e S c r i p t 、 S a s s \ \ L e s s 、 目 录 结 构 、 单 元 测 试 结 构 、 代 码 规 范 、 R e v i e w 规 范 、 发 布 规 范 这 些 😎 哈 ！ F * C K ！ ！ A W A Y ！ ！ 🤜 最 * 实 践 说 这 么 多 呢 ， 主 要 是 想 带 读 者 们 一 起 思 考 ， 也 是 我 写 作 的 风 格 （ 喜 欢 讲 故 事 ） ， 大 部 分 内 容 其 实 是 前 端 e r 都 会 遇 到 的 问 题 。 接 下 就 进 入 正 题 ， 说 了 一 大 堆 问 题 ， 总 得 有 点 办 法 来 解 决 吧 ！ 先 看 看 b i t 是 怎 么 做 的 吧 ， b i t 首 先 自 身 有 一 定 的 编 译 能 力 ， 内 置 了 w e b p a c k 及 一 些 插 件 式 l o a d e r 来 解 决 R e a c t 、 V u e 等 编 译 问 题 。 对 于 我 们 团 队 来 说 ， 都 是 使 用 R e a c t ， 所 以 咱 们 就 先 从 一 个 编 译 R e a c t 的 脚 手 架 开 始 。 如 果 把 每 一 个 组 件 都 作 为 单 独 的 N P M 项 目 发 布 ， 首 先 要 考 虑 的 是 ， 前 端 一 系 列 的 编 译 环 境 。 如 果 我 有 N 个 前 端 组 件 项 目 ， 每 个 前 端 组 件 库 的 w e b p a c k 、 b a b e l 这 些 都 需 要 重 复 配 置 ， 那 真 是 要 头 大 的 事 情 ， 我 只 是 想 写 一 个 组 件 而 已 ， 为 什 么 要 考 虑 这 些 。 所 以 我 们 的 脚 手 架 首 先 要 具 备 一 些 基 础 的 编 译 命 令 。 啊 对 了 ， 脚 手 架 还 没 有 名 字 ， 那 就 暂 时 叫 它 ： c o m p 吧 😷 c o m p n e w 处 理 按 照 模 板 新 建 一 个 标 准 组 件 初 始 化 一 个 标 准 组 件 项 目 结 构 ， 所 有 接 入 所 有 c o m p 命 令 初 始 化 G i t 仓 库 初 始 化 C I / C D 云 构 建 配 置 c o m p s t a r t 处 理 日 常 开 发 ， 附 加 单 个 组 件 展 示 及 调 试 能 力 c o m p w a t c h 处 理 b a b e l 及 s c s s 监 听 编 译 ， 用 于 n p m l i n k 场 景 c o m p b a b e l 处 理 编 译 n p m 包 c o m p d e v 处 理 监 听 编 译 u m d 包 ， 用 于 代 理 调 试 c o m p b u i l d 处 理 最 后 编 译 过 程 w e b p a c k 编 译 U M D 包 B a b e l 包 C I \ \ C D 过 程 中 自 动 截 图 组 件 C I \ \ C D 过 程 中 自 动 生 成 R E A D M E 其 他 H o o k c o m p t e s t 处 理 j e s t 单 元 测 试 那 么 等 组 件 初 始 化 以 后 ， 目 录 结 构 就 长 这 样 ： 项 目 结 构 中 没 有 任 何 w e b p a c k \ \ b a b e l 配 置 ， 当 然 如 果 有 特 殊 配 置 需 求 ， 可 以 建 立 c o m p . c o n f i g . j s 进 行 配 置 （ 此 处 借 鉴 很 多 已 有 的 c l i 处 理 方 式 ） 。 这 样 处 理 的 好 处 是 ， 在 项 目 初 始 化 后 ， 用 户 能 见 到 的 目 录 结 构 非 常 清 晰 明 了 ， 项 目 中 不 有 很 多 允 许 配 置 的 地 方 ， 所 有 组 件 的 编 译 环 境 基 本 可 以 保 证 统 一 。 这 都 是 些 非 常 基 础 的 功 能 ， 当 然 又 是 不 可 缺 少 的 部 分 ， 这 些 基 础 命 令 我 就 不 详 细 介 绍 了 ， 重 点 在 后 面 。 通 过 这 几 个 问 题 来 介 绍 功 能 ： 你 平 时 开 发 组 件 的 流 程 是 什 么 样 子 ？ 平 时 ， 一 般 就 是 根 据 设 计 稿 ， 切 分 到 组 件 后 。 然 后 去 创 建 组 件 ， 最 后 通 过 项 目 引 入 ， 一 边 看 着 一 边 开 发 啊 。 你 开 发 组 件 的 时 候 对 于 你 提 供 的 P r o p s 是 如 何 验 证 的 ？ 最 简 单 的 给 一 个 m o c k 看 看 效 果 呗 。 或 者 写 一 个 单 元 测 试 ？ 那 写 M o c k 的 过 程 算 不 算 是 在 写 U s a g e 呢 ？ 这 个 ， 应 该 也 算 吧 ， 但 是 这 些 都 是 散 落 在 各 个 项 目 里 面 ， 有 些 m o c k 验 证 完 就 删 掉 了 。 谁 会 闲 的 没 事 在 开 发 的 时 候 把 这 些 补 充 到 R E A D M E 里 面 去 啊 。 为 什 么 他 们 不 写 文 档 ？ 这 还 用 说 ？ 因 为 懒 呗 ？ 那 你 为 啥 不 写 ？ e m m ， 那 是 因 为 … . 写 文 档 这 事 儿 吧 ， 写 了 不 一 定 有 人 看 ， 还 费 时 间 呀 ！ 业 务 需 求 那 么 多 ！ 我 要 是 有 时 间 的 话 ， 我 肯 定 … . b a l a b a l a … O K ， 那 我 们 来 看 下 一 个 问 题 一 个 好 的 组 件 文 档 需 要 那 几 部 分 ？ 开 发 组 件 背 景 ， 注 意 事 项 啥 的 ， 这 个 没 啥 太 大 的 必 要 ， 有 的 组 件 需 要 的 话 就 补 充 下 ， 没 有 的 话 就 不 用 补 充 。 主 要 需 要 的 一 些 介 绍 有 ： 用 法 ， P r o p s 入 参 ， 最 好 能 有 个 截 图 ！ 还 有 安 装 、 开 发 、 编 译 的 命 令 介 绍 得 有 吧 。 锦 上 添 花 的 话 最 好 还 能 有 几 个 b a d g e ， 介 绍 下 源 码 是 T y p e S c r i p t ， 下 载 量 多 少 。 但 是 ， 要 补 充 这 些 文 档 是 在 太 麻 烦 了 ， 要 一 个 一 个 整 理 ， P r o p s 这 些 信 息 ， 用 的 人 可 以 在 组 件 里 面 找 到 啊 ， 我 都 有 些 注 释 和 类 型 定 义 的 呀 ！ 完 成 一 轮 心 灵 拷 问 之 后 ， 就 会 发 现 在 整 个 组 件 的 开 发 过 程 中 ， 开 发 者 本 人 之 所 以 对 这 个 组 件 这 么 清 楚 ， 是 因 为 开 发 者 其 实 已 经 为 自 己 写 过 一 份 R E A D M E 了 。 用 法 ： 组 件 开 发 过 程 中 需 要 看 到 效 果 ， 写 过 一 些 m o c k 数 据 ， 已 经 知 道 什 么 样 的 p r o p s 传 进 去 会 产 生 什 么 样 的 效 果 P r o p s 入 参 ： 组 件 有 哪 些 P r o p s ， 所 代 表 的 含 义 是 什 么 ， 每 个 P r o p s 入 参 类 型 是 什 么 ， 已 经 在 T y p e S c r i p t 的 I n t e r f a c e 及 注 释 中 有 体 现 截 图 ： 有 m o c k 数 据 还 不 知 道 长 什 么 样 ？ 已 经 看 过 N 多 边 了 有 了 这 三 个 最 重 要 的 介 绍 后 ， 相 信 大 部 分 开 发 者 也 都 能 知 道 这 个 组 件 是 怎 么 个 情 况 了 。 所 以 ， 如 果 我 们 能 把 上 面 这 些 数 据 都 收 集 到 ， 是 不 是 就 可 以 利 用 脚 本 自 动 生 成 R E A D M E 文 档 了 呢 ？ 用 法 / U s a g e 要 收 集 用 法 其 实 很 简 单 ， 如 果 让 组 件 有 独 立 开 发 的 能 力 ， 不 就 可 以 保 留 这 些 U s a g e 的 M o c k 数 据 了 吗 有 些 人 可 能 没 理 解 我 说 的 ” 组 件 独 立 开 发 的 能 力 “ 是 什 么 意 思 ， 我 解 释 一 下 下 ： 我 们 平 时 开 发 一 个 组 件 ， 一 般 都 是 把 这 个 组 件 放 置 于 某 个 页 面 中 ， 一 遍 调 试 页 面 一 遍 调 试 组 件 。 独 立 开 发 组 件 的 意 思 是 ， 直 接 启 动 一 个 页 面 ， 可 以 看 到 组 件 的 样 子 ， 这 个 页 面 展 示 的 就 是 围 绕 组 件 的 所 有 信 息 。 所 以 在 脚 手 架 中 ， 只 要 在 d o c s . t s 中 书 写 需 要 调 试 组 件 相 关 的 m o c k 数 据 ， 页 面 就 可 以 展 示 出 组 件 的 样 子 ， 同 时 这 些 m o c k 数 据 可 以 保 留 作 为 R E A D M E 文 档 数 据 。 另 外 ， 如 果 保 证 这 份 d e m o 的 接 口 输 出 统 一 规 范 ， 还 可 以 支 持 直 接 生 成 在 C o d e P e n ， R i d d l e 这 些 在 线 编 辑 的 代 码 内 容 。 试 想 下 ， 你 的 R E A D M E 中 如 果 出 现 一 段 ： 点 击 立 即 体 验 ， 跳 转 过 去 后 可 以 在 线 编 辑 实 时 看 到 效 果 ， 那 对 于 任 何 看 到 你 组 件 的 同 学 来 说 都 是 一 种 享 受 😉 组 件 参 数 / P r o p s 要 收 集 这 部 分 数 据 就 比 较 复 杂 了 ， 我 们 需 要 深 入 分 析 T y p e S c r i p t A S T 语 法 树 ， 提 取 出 其 中 组 件 p r o p s 的 类 型 以 及 对 于 I n t e r f a c e 的 注 释 内 容 。 经 过 一 番 g i t h u b ， 终 于 找 到 可 以 实 现 一 个 可 以 处 理 这 件 事 情 的 小 众 库 r e a c t d o c g e n t y p e s c r i p t 在 开 发 过 程 中 ， 因 为 对 一 些 注 释 及 类 型 输 出 与 我 预 期 的 不 太 一 样 ， 所 以 我 f o r k 后 做 了 一 些 修 改 ， 已 经 可 以 完 成 对 一 个 完 整 组 件 的 P r o p s 做 分 析 后 输 出 一 份 t y p e f i l e . j s o n 。 同 样 的 ， 通 过 基 于 该 能 力 ， 可 以 扩 展 为 w e b p a c k 插 件 r e a c t d o c g e n t y p e s c r i p t l o a d e r ， 为 组 件 的 静 态 属 性 中 添 加 _ _ d o c I n f o 属 性 ， 来 声 明 其 属 性 内 容 ， 于 是 组 件 开 发 过 程 变 可 以 实 现 以 下 效 果 ： 截 图 / P r e v i e w 有 了 组 件 ， 有 了 d e m o ， 还 愁 没 有 截 图 吗 ？ 直 接 在 构 建 过 程 中 用 p u p p e t e e r ， 读 取 运 行 d o c s . t s 渲 染 出 组 件 ， 进 行 截 图 ， 然 后 随 着 云 构 建 C D 过 程 发 到 C D N ， 就 完 事 了 ！ 最 后 ， R E A D M E 中 加 入 一 些 特 殊 标 记 ， 在 云 构 建 过 程 中 进 行 R E A D M E 替 换 生 成 就 可 以 啦 ！ 并 不 会 影 响 R E A D M E 本 身 要 叮 嘱 的 内 容 。 最 后 ， D u a n g ！ 一 份 完 整 ， 漂 亮 ， 详 细 的 文 档 就 生 成 好 了 ， 整 个 过 程 我 们 并 没 有 特 意 写 过 什 么 R E A D M E 方 面 的 内 容 ， 一 切 都 是 非 常 轻 松 标 准 的 进 行 输 出 。 结 语 在 上 面 的 一 整 套 复 杂 的 过 程 中 ， 看 上 去 最 后 好 像 我 只 得 到 了 一 个 自 动 生 成 R E A D M E 的 功 能 。 但 实 际 上 呢 ， 其 实 R E A D M E 只 是 一 个 顺 带 的 产 物 。 整 个 过 程 中 ， 我 已 经 拿 到 了 这 个 组 件 的 所 有 我 想 要 拿 到 的 数 据 ， 它 的 P r o p s ， U s a g e ， P r e v i e w ， 版 本 信 息 ， 包 名 ， 甚 至 构 建 过 程 会 同 步 发 布 该 组 件 的 U M D C D N 包 及 N P M 包 。 接 下 来 ， 就 可 以 围 绕 这 些 数 据 和 工 具 ， 建 立 和 扩 展 很 多 功 能 和 平 台 。 举 几 个 栗 子 ： 建 立 一 个 b i t 一 样 的 ， 组 件 平 台 ， 把 团 队 内 的 组 件 收 集 起 来 ， 统 一 在 平 台 展 示 及 索 引 根 据 拿 到 P r o p s 类 型 信 息 做 可 视 化 的 搭 建 平 台 ， 把 P r o p s 的 传 参 直 接 交 给 用 户 设 置 ， 根 据 不 同 数 据 类 型 提 供 不 同 的 F o r m S e t t e r 看 似 组 件 都 分 布 在 不 同 的 库 中 ， 却 可 以 通 过 组 件 c l i 做 统 一 的 构 建 处 理 非 常 轻 松 接 入 微 前 端 框 架 ， 因 为 所 有 组 件 的 发 布 构 建 都 是 标 准 的 构 建 协 议 通 过 统 计 组 件 发 布 次 数 ， 下 载 次 数 ， 关 联 b u g 数 评 估 代 码 质 量 目 前 在 我 们 团 队 ， 已 经 使 用 该 工 具 产 出 3 0 + 的 可 用 组 件 ， 并 且 发 布 组 件 已 经 成 功 接 入 到 我 们 已 有 的 可 视 化 编 辑 器 中 。 看 一 眼 结 合 可 视 化 设 置 面 板 后 的 效 果 吧 ： 我 发 现 只 要 实 现 过 程 中 ， 没 有 给 开 发 者 带 来 太 多 的 工 作 量 ， 又 能 带 来 实 时 可 以 看 到 的 效 果 ， 开 发 者 会 很 乐 意 为 那 些 P r o p s 做 一 番 解 释 和 修 饰 😊 。 我 们 团 队 目 前 产 出 的 组 件 看 起 来 一 片 通 透 ， 整 齐 明 了 。 另 外 ， 因 为 脚 手 架 出 世 时 间 还 短 ， 需 要 完 善 的 地 方 还 很 多 ， 还 没 有 符 合 公 司 规 定 的 开 源 标 准 ， 就 不 拿 出 来 献 丑 啦 😊 ， 不 过 我 觉 得 整 体 思 路 更 有 参 考 价 值 ！ 我 是 一 个 热 爱 生 活 的 前 端 工 程 师 ！ Y o o h ！ 🤠 # J a v a S c r i p t 喜 欢 这 篇 文 章 ？ 打 赏 一 下 作 者 吧 支 付 宝 微 信 如 何 接 地 气 的 接 入 微 前 端 B i t 初 体 验 Y e e W a n g F r o n t e n d E n g i n e e r S h e n Z h e n , A l i b a b a G r o u p 文 章 3 6 分 类 7 标 签 1 3 F o l l o w 分 类 实 现 过 程 1 实 用 工 具 3 性 能 优 化 3 架 构 设 计 1 8 经 验 心 得 9 J a v a S c r i p t 1 项 目 管 理 2 标 签 C S S 1 H T M L 1 J a v a S c r i p t 2 3 J a v a s c r i p t 2 T u m a x 项 目 8 W h i s t l e 1 代 码 人 生 2 工 具 1 数 据 模 型 2 架 构 设 计 1 设 计 模 式 1 0 面 试 经 验 1 项 目 规 范 1 最 新 文 章 2 0 2 4 0 3 2 9 琢 磨 一 下 M o n o r e p o 架 构 设 计 2 0 2 3 0 8 1 4 谈 谈 国 内 前 端 的 三 大 怪 啖 架 构 设 计 2 0 2 3 0 7 1 2 今 天 这 个 A n t d 是 非 换 不 可 吗 ？ 架 构 设 计 2 0 2 3 0 6 0 2 结 合 A I 能 力 ， 对 B 端 交 互 的 畅 想 经 验 心 得 2 0 2 3 0 4 1 1 译 ： 如 何 成 为 一 名 “ 捞 逼 ” 工 程 师 经 验 心 得 © 2 0 2 4 Y e e W a n g   P o w e r e d b y H e x o & I c a r u s 湘 I C P 备 1 4 0 1 5 5 3 9 号 Y o u r b r o w s e r i s o u t o f d a t e ! U p d a t e y o u r b r o w s e r t o v i e w t h i s w e b s i t e c o r r e c t l y . U p d a t e m y b r o w s e r n o w ×

做上本站友情链接,在您站上点击一次,即可自动秒收录并自动排在本站第一位！
<a href="https://www.badfl.com/" target="_blank">自动秒收录</a>