下载地址：https://ext.dcloud.net.cn/plugin?id=26580
一、 功能说明文档 (Functional Specification)
1.1 核心功能概述
本组件提供了一个多功能的房贷计算工具，旨在帮助用户快速估算购房贷款的月供、利息总额及还款计划。支持当前主流的三种贷款模式，并内置了 2024 年最新的利率参考标准。
1.2 主要功能模块
-
三种贷款模式切换：
-
商业贷款： 纯商业贷款计算，支持 LPR 浮动利率和固定利率选择。
-
公积金贷款： 纯公积金贷款计算，自动适配首套/二套房利率差异。
-
组合贷款： 同时输入公积金和商业贷款金额，综合计算总月供。
-
-
核心计算引擎：
-
采用 等额本息 还款法进行计算。
-
计算指标包括： 每月月供、贷款总额、支付利息总额、还款总额。
-
-
交互式输入：
-
首套/二套认定： 切换认定状态会自动更新对应的利率选项。
-
贷款年限： 支持 1-30 年灵活选择。
-
输入验证： 对贷款金额设有最大值限制（商贷 500 万，公积金 100 万）及非数字过滤。
-
-
可视化结果呈现：
-
结果摘要： 以网格形式清晰展示关键财务指标。
-
还款计划表： 详细列出每一期的期数、月供、本金、利息及剩余本金，方便用户查看本金递增和利息递减的过程。
-
1.3 技术特点
-
响应式布局： 适配不同尺寸的移动设备屏幕。
-
自动滚动： 点击"开始计算"后，页面自动平滑滚动至结果区域。
-
千分位格式化： 金额显示自动添加逗号分隔符（如：1,234,567），提升易读性。
二、 配置修改说明 (Configuration Guide)
如果您需要根据政策变化或项目需求调整计算器，请参考以下修改指引：
2.1 利率数据更新 (关键修改)
房贷利率经常随政策调整。请在 data() 函数中的 businessRates 和 fundRates 对象里修改：
JavaScript
// 在 script -> data -> businessRates 中修改
businessRates: {
firstHome: [
'3.05% (LPR-45BP)', // 修改这里的百分比数值
// ... 其他选项
],
secondHome: [
'3.55% (LPR+5BP)', // 修改二套房利率
// ...
],
},2.2 贷款限额调整
为了防止用户输入非法过大数值，代码在 methods -> validateInput 中设置了硬编码限制。若要修改最高贷款额度（例如将商贷上限调至 1000 万）：
JavaScript
validateInput(type) {
if (type === 'business') {
// ...
if (value > 1000) this.businessLoan.amount = 1000; // 将 500 改为 1000
}
// 公积金(fund)同理修改
}2.3 默认年限设置
当前默认年限为 20 年。如果希望默认显示 30 年，请修改各贷款对象的 yearsIndex（索引从 0 开始，29 代表 30 年）：
JavaScript
businessLoan: {
yearsIndex: 29, // 修改为 29 对应 30年
// ...
}2.4 主题颜色修改
本组件使用绿色（#0EAA6A）作为主题色。如需更换（例如改为蓝色），请在 <style> 部分全局替换：
-
Active 状态颜色：
.tab-item.active,.radio-item.active,.result-value.primary -
按钮背景色：
.calculate-btn text,.radio-item.active .radio-icon
2.5 计算逻辑说明 (LaTeX 引用)
组件目前仅支持等额本息计算。公式参考如下：
每月月供 = \\frac{贷款本金 \\times 月利率 \\times (1 + 月利率)\^{还款月数}}{(1 + 月利率)\^{还款月数} - 1}
若未来需要添加 等额本金 计算，需在 methods 中新增逻辑并修改 generateRepaymentPlan 函数。